Azure Synapse Link for Dataverse에서 직접 선택 레이블에 액세스

Microsoft Dataverse는 Power Apps 내에서 바로 사용할 수 있는 풍부한 메타데이터를 제공합니다. 선택 항목(선택 목록)은 테이블에 포함될 수 있는 가장 많이 사용되는 열 유형 중 하나입니다. 옵션 집합을 정의합니다. 선택 항목이 양식에 표시될 경우에는 드롭다운 목록 컨트롤을 사용합니다. 로컬에 정의된 선택 항목을 사용하거나 다른 선택 항목 열에 사용될 수 있는 전역으로 정의된 옵션 집합을 사용하도록 옵션 집합을 정의할 수 있습니다.

선택 열에 대한 자세한 내용은 전역 선택 항목 만들기 및 편집 개요를 참조하세요.

Azure Synapse Link를 생성한 후 Azure Data Lake Storage Gen2의 OptionsetMetadata라는 폴더에 다음 5개의 테이블이 생성됩니다.

  • OptionsetMetadata
  • GlobalOptionsetMetadata
  • StateMetadata
  • StatusMetadata
  • TargetMetadata

Azure Synapse Analytics로 생성된 테이블과 선택 열

StateMetadataStatusMetadata는 검색할 상태상태 선택 값을 저장합니다. TargetMetadata는 검색할 테이블 관계 메타데이터를 저장합니다.

열 이름 데이터 형식 샘플 값 설명
EntityName 문자열 어카운트 현재 Dataverse 테이블 이름.
AttributeName 문자열 transactioncurrencyid 현재 열 이름
ReferencedEntity 문자열 transactioncurrency 관련 Dataverse 테이블 이름
ReferencedAttribute 문자열 transactioncurrencyid 관련 열 이름

추가 정보: 테이블 관계 개요.

OptionsetMetadata는 가져온 Dataverse 테이블에 로컬 선택 레이블 메타데이터를 저장합니다. GlobalOptionsetMetadata는 전역 선택 레이블 메타데이터를 저장하고 동일한 테이블 스키마와 하나의 추가 열인 GlobalOptionSetName(테이블과 선택 이름의 조합)을 따릅니다.

열 이름 데이터 형식 샘플 값 설명
EntityName  문자열 어카운트 Dataverse 테이블 이름.
OptionSetName  문자열 ownershipcode  열 이름.
옵션 Bigint 1 선택 항목 생성 시 사용자 지정 숫자 레이블입니다.
IsUserLocalizedLabel  부울 False 기본적으로 False를 반환합니다.
LocalizedLabelLanguageCode  Bigint 1033 영어(미국)의 경우 1033 또는 스페인어(스페인)의 경우 1034와 같이 선택 레이블의 언어 코드입니다.
LocalizedLabel   문자열 일반 선택 항목 생성 시 사용자 지정 텍스트 레이블입니다. 
GlobalOptionSetName(GlobalOptionsetMetadata만 해당) 문자열 socialprofile_community 테이블과 선택 이름의 조합

OptionsetMetadata 및 GlobalOptionsetMetadata 테이블 스키마입니다.

Dataverse 테이블에서 선택 열은 사용자가 지정한 숫자 값을 포함하며, 이는 위에서 설명한 OptionsetMetadata 테이블의 옵션 값과 동일합니다.

전제 조건

Azure Synapse Link for Dataverse. 이 문서에서는 Azure Synapse Link for Dataverse를 사용하여 Dataverse에서 데이터를 이미 내보냈다고 가정합니다. 

선택 메타데이터에 액세스

  1. 원하는 Azure Synapse Link를 선택하고 커맨드바에서  Azure Synapse Analytics 작업 영역으로 이동 을 선택합니다.  
  2. 왼쪽 창에서 레이크 데이터베이스를 확장하고 dataverse-environmentName-organizationUniqueName을 선택한 다음 테이블 을 확장합니다. 나열된 모든 선택 메타데이터는 분석에 사용할 수 있습니다.

서버리스 SQL 풀로 Dataverse 선택 열을 사용하려면.

  1. 데이터베이스 아이콘을 마우스 오른쪽 버튼으로 클릭한 다음 새 SQL 스크립트 > 빈 스크립트를 선택합니다.
  2. 조인 SQL 스크립트를 적용하여 선택 메타데이터를 Dataverse 테이블과 조인하고 뷰를 새 데이터베이스에 저장합니다.

선택 메타데이터를 조인하기 위한 예제 SQL 스크립트

숫자 선택 값을 의미 있는 텍스트 레이블로 바꾸려면 <DATABASE_NAME>, <COLUMN_NAME><TABLE_NAME> 을 데이터베이스, 열 및 테이블의 이름으로 바꿉니다.

SELECT [LocalizedLabel] as [<COLUMN_NAME>] 
FROM [<DATABASE_NAME>].[dbo].[<TABLE_NAME>_partitioned] 
LEFT JOIN [<DATABASE_NAME>].[dbo].[OptionsetMetadata] 
ON ([<DATABASE_NAME>].[dbo].[OptionsetMetadata].[Option] = [<DATABASE_NAME>].[dbo].[<TABLE_NAME>_partitioned].[<COLUMN_NAME>] AND [<DATABASE_NAME>].[dbo].[OptionsetMetadata].[OptionSetName] = <COLUMN_NAME>)

여러 옵션 집합 값을 사용하는 방법에 대한 자세한 내용은 공통 테이블 표현식 사용을 사용해야 합니다.