Partilhar via

Aceder a etiquetas de escolha diretamente a partir do Azure Synapse Link for Dataverse

  • Artigo

O Microsoft Dataverse fornece metadados ricos que podem ser utilizados diretamente no Power Apps. Uma escolha (lista de seleção) é um dos tipos de colunas mais utilizados que pode ser incluída numa tabela. Definir um conjunto de opções. Quando uma escolha é apresentada num formulário, utiliza um controlo drop-down list. Pode definir uma escolha para utilizar um conjunto de opções definidas dentro de si próprio (localmente) ou pode utilizar um conjunto de opções definidas noutro local (globalmente), que pode ser utilizado por outras colunas de escolha.

Para obter mais informações sobre colunas de escolha, aceda a Descrição geral de criar e editar escolhas globais.

Depois de criar um Azure Synapse Link, são criadas as seguintes cinco tabelas numa pasta denominada OptionsetMetadata no Azure Data Lake Storage Gen2:

  • OptionsetMetadata
  • GlobalOptionsetMetadata
  • StateMetadata
  • StatusMetadata
  • TargetMetadata

Tabelas criadas no Azure Synapse Analytics com colunas de escolha

StateMetadata e StatusMetadata armazenam o valor de escolha de Estado e Estado a obter. TargetMetadata armazena metadados de relações entre tabelas a obter.

Nome da coluna Tipo de dados Valores de exemplo Descrição
EntityName Cadeia (de carateres) conta Nome da tabela do Dataverse atual.
AttributeName Cadeia (de carateres) transactioncurrencyid Nome de coluna atual
ReferencedEntity Cadeia (de carateres) transactioncurrency Nome da tabela do Dataverse relacionada
ReferencedAttribute Cadeia (de carateres) transactioncurrencyid Nome da coluna relacionada

Mais informações: Descrição geral de relações entre tabelas.

OptionsetMetadata armazena os metadados de etiquetas de escolhas locais nas tabelas do Dataverse importadas. GlobalOptionsetMetadata armazena os metadados de etiquetas de escolhas globais e segue o mesmo esquema de tabela, acrescido de uma coluna extra, GlobalOptionSetName, uma combinação de tabela e nome de escolha.

Nome da coluna Tipo de dados Valores de exemplo Descrição
EntityName  Cadeia (de carateres) conta Nome da tabela do Dataverse.
OptionSetName  Cadeia (de carateres) ownershipcode  Nome da coluna.
Opção Bigint 1 Etiqueta numérica especificada pelo utilizador quando o item de escolha é criado.
IsUserLocalizedLabel  Booleano False Obter False por predefinição.
LocalizedLabelLanguageCode  Bigint 1033 O código de idioma da etiqueta de escolha, tal como 1033 para inglês (Estados Unidos) ou 1034 para espanhol (Espanha).
LocalizedLabel   Cadeia (de carateres) Pública Etiqueta de texto especificada pelo utilizador quando o item de escolha é criado. 
GlobalOptionSetName (apenas GlobalOptionsetMetadata) Cadeia (de carateres) socialprofile_community uma combinação de tabela e nome de escolha

Esquema de tabelas OptionsetMetadata e GlobalOptionsetMetadata.

Nas tabelas do Dataverse, a coluna de escolha contém um valor numérico especificado pelo utilizador, que é igual ao valor Opção na tabela OptionsetMetadata descrita acima.

Pré-requisito

Azure Synapse Link for Dataverse. Este artigo assume que já exportou dados do Dataverse utilizando o Azure Synapse Link for Dataverse. 

Aceder a metadados de escolha

  1. Selecione o Azure Synapse Link pretendido e selecione Ir para a área de trabalho do Azure Synapse Analytics na barra de comando.  
  2. Expanda Bases de dados Lake no painel esquerdo, selecione dataverse-environmentName-organizationUniqueName e, em seguida, expanda Tabelas.  Todos os metadados de escolha listados estão disponíveis para análise.

Para consumir colunas de escolha do Dataverse com um conjunto de SQL sem servidor.

  1. Clique com o botão direito do rato no ícone de base de dados e, em seguida, selecione Novo script SQL > Script vazio.
  2. Aplique uma associação de script SQL para associar os metadados de escolha à sua tabela do Dataverse e armazene a vista numa nova base de dados.

Exemplo de script SQL para associar metadados de escolha

Substitua <DATABASE_NAME>,<COLUMN_NAME> e <TABLE_NAME> pelo nome da base de dados, coluna e tabela para substituir valor de escolha numérica por etiqueta de texto significativa

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>)

Para obter mais informações sobre como consumir vários conjuntos de opções, terá de utilizar Utilizar Expressões de Tabela Comuns.