표준 데이터 흐름에 대한 필드 매핑 고려 사항

Dataverse 테이블에 데이터를 로드할 때 데이터 흐름의 편집 환경에서 원본 쿼리의 열을 대상 Dataverse 테이블 열에 매핑합니다. 데이터 매핑 외에도 고려해야 할 다른 고려 사항 및 모범 사례가 있습니다. 이 문서에서는 데이터 흐름 새로 고침의 동작과 결과적으로 대상 테이블의 데이터를 제어하는 다양한 데이터 흐름 설정을 다룹니다.

데이터 흐름이 각 새로 고침 시 레코드를 생성하거나 업데이트할지 여부 제어

데이터 흐름을 새로 고칠 때마다 원본에서 레코드를 가져와 Dataverse에 로드합니다. 데이터 흐름을 구성하는 방법에 따라 데이터 흐름을 두 번 이상 실행하는 경우 다음을 수행할 수 있습니다.

• 이러한 레코드가 대상 테이블에 이미 있는 경우에도 각 데이터 흐름 새로 고침에 대한 새 레코드를 만듭니다.
• 테이블에 새 레코드가 없는 경우 새 레코드를 만들거나 테이블에 이미 있는 경우 기존 레코드를 업데이트합니다. 이 동작을 upsert라고 합니다.

키 열을 사용하면 대상 테이블에 레코드를 업서트하는 데이터 흐름을 나타내고, 키를 선택하지 않으면 대상 테이블에 새 레코드를 만드는 데이터 흐름이 표시됩니다.

키 열은 테이블의 데이터 행에 대한 고유하고 결정적인 열입니다. 예를 들어 Orders 테이블에서 주문 ID가 키 열인 경우 동일한 주문 ID를 가진 두 개의 행이 없어야 합니다. 또한 하나의 주문 ID(ID가 345인 주문)는 테이블의 한 행만 나타내야 한다고 가정해 보겠습니다. 데이터 흐름에서 Dataverse의 테이블에 대한 키 열을 선택하려면 지도 테이블 환경에서 키 필드를 설정해야 합니다.

새 테이블을 만들 때 기본 이름 및 키 필드 선택

다음 이미지는 데이터 흐름에서 새 테이블을 만들 때 원본에서 채울 키 열을 선택하는 방법을 보여 줍니다.

필드 매핑에 표시되는 기본 이름 필드는 레이블 필드에 대한 필드입니다. 이 필드는 고유할 필요가 없습니다. 중복을 확인하기 위해 테이블에서 사용되는 필드는 대체 키 필드에 설정한 필드입니다.

테이블에 기본 키가 있으면 기본 키에 매핑된 필드에 중복 데이터가 있더라도 중복 항목이 테이블에 로드되지 않습니다. 이 동작은 테이블의 높은 데이터 품질을 유지합니다. 고품질 데이터는 테이블을 기반으로 보고 솔루션을 빌드하는 데 필수적입니다.

기본 이름 필드

기본 이름 필드는 Dataverse에 사용되는 표시 필드입니다. 이 필드는 다른 애플리케이션에서 테이블의 내용을 표시하기 위해 기본 보기에서 사용됩니다. 이 필드는 기본 키 필드가 아니며, 해당 필드로 간주해서는 안 됩니다. 이 필드는 표시 필드이므로 중복 값을 가질 수 있습니다. 그러나 연결 필드를 사용하여 기본 이름 필드에 매핑하는 것이 가장 좋습니다. 따라서 이름은 완전히 설명됩니다.

대체 키 필드는 기본 키로 사용됩니다.

기존 테이블에 로드할 때 키 필드 선택

데이터 흐름 쿼리를 기존 Dataverse 테이블에 매핑할 때 대상 테이블에 데이터를 로드할 때 사용해야 하는 키와 키를 선택할 수 있습니다.

다음 이미지는 기존 Dataverse 테이블에 레코드를 업서팅할 때 사용할 키 열을 선택하는 방법을 보여 줍니다.

테이블의 고유 ID 열 설정 및 기존 Dataverse 테이블에 레코드를 삽입하기 위한 키 필드로 사용

모든 Microsoft Dataverse 테이블 행에는 GUID로 정의된 고유 식별자가 있습니다. 이러한 GUID는 각 테이블의 기본 키입니다. 기본적으로 테이블의 기본 키는 데이터 흐름에 의해 설정할 수 없으며 레코드를 만들 때 Dataverse에서 자동으로 생성됩니다. 테이블의 기본 키를 활용하는 것이 바람직한 고급 사용 사례가 있습니다. 예를 들어 외부 테이블과 Dataverse 테이블 모두에서 동일한 기본 키 값을 유지하면서 데이터를 외부 원본과 통합하는 것이 좋습니다.

테이블의 고유 식별자 필드를 활용하려면 데이터 흐름을 작성하는 동안 맵 테이블 페이지의 기존 테이블에 로드를 선택합니다. 후속 이미지에 표시된 예제에서는 CustomerTransactions 테이블에 데이터를 로드하고 데이터 원본의 TransactionID 열을 테이블의 고유 식별자로 사용합니다.

선택 키 드롭다운에서 테이블의 고유 식별자(항상 "tablename + id")를 선택할 수 있습니다. 테이블 이름은 "CustomerTransactions"이므로 고유 식별자 필드의 이름은 "CustomerTransactionId"입니다.

선택한 열 매핑 섹션은 고유 식별자를 대상 열로 포함하도록 업데이트됩니다. 그런 다음 각 레코드의 고유 식별자를 나타내는 원본 열을 매핑할 수 있습니다.

키 필드에 적합한 후보란?

키 필드는 테이블의 고유 행을 나타내는 고유 값입니다. 테이블에 중복 레코드가 없는 것을 방지하는 데 도움이 되므로 이 필드를 사용하는 것이 중요합니다. 이 필드는 다음 세 가지 소스에서 올 수 있습니다.

• 원본 시스템의 기본 키(예: 이전 예제의 OrderID)입니다. 데이터 흐름의 파워 쿼리 변환을 통해 생성된 연결된 필드입니다.

  

• 대체 키 옵션에서 선택할 필드의 조합입니다. 키 필드로 사용되는 필드의 조합을 복합 키라고도 합니다.

  

더 이상 존재하지 않는 행 제거

테이블의 데이터를 원본 시스템의 데이터와 항상 동기화하려면 쿼리 출력에 더 이상 존재하지 않는 행 삭제 옵션을 선택합니다. 그러나 이 작업을 수행하려면 기본 키(데이터 흐름의 필드 매핑에 있는 대체 키)를 기반으로 행 비교가 필요하기 때문에 이 옵션은 데이터 흐름을 느리게 합니다.

이 옵션은 테이블에 다음 데이터 흐름 새로 고침의 쿼리 출력에 없는 데이터 행이 있는 경우 해당 행이 테이블에서 제거됨을 의미합니다.

알려진 제한 사항

• 다형 조회 필드에 대한 매핑은 현재 지원되지 않습니다.
• 다른 테이블의 조회 필드를 가리키는 조회인 다중 수준 조회 필드에 매핑은 현재 지원되지 않습니다.
• 상태 및 상태 이유필드에 대한 매핑은 현재 지원되지 않습니다.
• 줄 바꿈 문자가 포함된 여러 줄 텍스트로 데이터를 매핑하는 것은 지원되지 않으며 줄 바꿈은 제거됩니다. 대신 줄 바꿈 태그 <br> 를 사용하여 여러 줄 텍스트를 로드하고 유지할 수 있습니다.
• 다중 선택 필드에 대해 둘 이상의 값을 지정하는 동안 동일한 테이블에서 단일 선택 및 다중 선택 선택 필드를 모두 구성하는 것은 지원되지 않습니다.
• 표준 V2 데이터 흐름은 데이터 흐름 출력에 존재하지 않는 행을 대상으로 테이블에서 제거하기 위해 createdon와 modifiedon 필드를 사용합니다. 해당 열이 대상 테이블에 없으면 레코드가 삭제되지 않습니다.
• IsValidForCreate 속성이 false로 설정된 필드에 대한 매핑은 지원되지 않습니다 (예: 연락처 엔터티의 계정 필드).