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

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

데이터 흐름에서 각 새로 고침을 만들거나 upsert를 기록하는지 여부 제어

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

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

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

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

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

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

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

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

기본 이름 필드

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

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

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

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

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

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

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

참고 항목

• 이 기능은 기존 테이블에 데이터를 로드할 때만 사용할 수 있습니다.
• 고유 식별자 필드는 GUID 값이 포함된 문자열만 허용하며, 다른 데이터 형식 또는 값으로 인해 레코드 만들기가 실패합니다.

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

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

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

키 필드에 적합한 후보란?

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

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

  

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

  

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

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

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

참고 항목

표준 V2 데이터 흐름은 대상 테이블에서 데이터 흐름 출력에 존재하지 않는 행을 제거하기 위해 필드와 modifiedon 필드를 사용합니다createdon. 해당 열이 대상 테이블에 없으면 레코드가 삭제되지 않습니다.

알려진 제한 사항

• 다형 조회 필드에 대한 매핑은 현재 지원되지 않습니다.
• 다른 테이블의 조회 필드를 가리키는 조회인 다중 수준 조회 필드에 매핑은 현재 지원되지 않습니다.
• 상태 및 상태 이유필드에 대한 매핑은 현재 지원되지 않습니다.
• 줄 바꿈 문자가 포함된 여러 줄 텍스트로 데이터를 매핑하는 것은 지원되지 않으며 줄 바꿈은 제거됩니다. 대신 줄 바꿈 태그 <br> 를 사용하여 여러 줄 텍스트를 로드하고 유지할 수 있습니다.
• 여러 선택 옵션을 사용하도록 구성된 선택 필드에 매핑은 특정 조건에서만 지원됩니다. 데이터 흐름은 다중 선택 옵션을 사용하도록 설정된 선택 필드에만 데이터를 로드하고 레이블의 값(정수)의 쉼표로 구분된 목록이 사용됩니다. 예를 들어 레이블이 해당 정수 값이 "1, 2, 3"인 "Choice1, Choice2, Choice3"인 경우 열 값은 "1,3"이어야 첫 번째 및 마지막 선택 항목을 선택합니다.
• 표준 V2 데이터 흐름은 대상 테이블에서 데이터 흐름 출력에 존재하지 않는 행을 제거하기 위해 필드와 modifiedon 필드를 사용합니다createdon. 해당 열이 대상 테이블에 없으면 레코드가 삭제되지 않습니다.
• IsValidForCreate 속성이 false 지원되지 않는 필드(예: 연락처 엔터티의 계정 필드)에 매핑합니다.