Partilhar via

Acesse rótulos de escolha diretamente do Azure Synapse Link for Dataverse

O Microsoft Dataverse fornece metadados avançados que podem ser usados diretamente no Power Apps. Uma escolha (lista de opções) é um dos tipos mais usados de colunas que podem ser incluídas em uma tabela. Define um conjunto de opções. Quando uma escolha é apresentada num formulário, utiliza um controlo drop-down list. Você pode definir uma opção para usar um conjunto de opções definidas dentro de si mesmo (localmente) ou pode usar um conjunto de opções definidas em outro lugar (globalmente), que podem ser usadas por outras colunas de escolha.

Para obter mais informações sobre colunas de escolha, vá para Criar e editar visão geral de opções globais.

Depois de criar um Azure Synapse Link, as cinco tabelas a seguir são criadas em uma pasta chamada OptionsetMetadata no Azure Data Lake Storage Gen2:

  • OptionsetMetadata
  • GlobalOptionsetMetadata
  • Metadados de Estado
  • StatusMetadata
  • TargetMetadata

Tabelas criadas no Azure Synapse Analytics com colunas de escolha

StateMetadata e StatusMetadata armazenam o valor de escolha State e Status a ser recuperado. TargetMetadata armazena metadados de relações de tabela para recuperar.

Nome da coluna Tipo de dados Valor da amostra Description
EntityName String conta Nome atual da tabela Dataverse.
AttributeName String transactioncurrencyid Nome da coluna atual
ReferencedEntity String transactioncurrency Nome da tabela Dataverse relacionada
ReferencedAttribute String identificadorDeMoedaDaTransação Nome da coluna relacionada

Para obter mais informações: Visão geral das relações de tabela.

OptionsetMetadata armazena os metadados do rótulo de opções locais nas tabelas Dataverse importadas. GlobalOptionsetMetadata armazena os metadados do rótulo de escolhas globais e segue o mesmo esquema de tabela mais uma coluna extra, GlobalOptionSetName, uma combinação de nome de tabela e escolha.

Nome da coluna Tipo de dados Valor da amostra Description
EntityName String conta Nome da tabela Dataverse.
NomeDoConjuntoDeOpções String código de titularidade Nome da coluna.
Opção Bigint 1 Rótulo numérico especificado pelo usuário quando o item de escolha é criado.
IsUserLocalizedLabel booleano Falso Retorna falso por padrão.
LocalizedLabelLanguageCode Bigint 1033 O código de idioma do rótulo de escolha, como 1033 para inglês (Estados Unidos) ou 1034 para espanhol (Espanha).
LocalizedLabel String Public Rótulo de texto especificado pelo usuário quando o item de escolha é criado. 
GlobalOptionSetName (apenas GlobalOptionsetMetadata) String perfil social_comunidade uma combinação de tabela e nome da opção

Esquema de tabela OptionsetMetadata e GlobalOptionsetMetadata.

Nas tabelas Dataverse, a coluna de escolha contém um valor numérico especificado pelo usuário, que é o mesmo que o valor Option na tabela OptionsetMetadata descrita acima.

Pré-requisito

Azure Synapse Link para Dataverse. Este artigo pressupõe que você já tenha exportado dados do Dataverse usando o Azure Synapse Link for Dataverse. 

Metadados de preferências de acesso

  1. Selecione o Azure Synapse Link desejado e selecione o Ir para o espaço de trabalho do Azure Synapse Analytics na barra de ferramentas.  
  2. Expanda Lake Databases no painel esquerdo, selecione dataverse-environmentName-organizationUniqueName e 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 mouse no ícone do banco de dados e selecione Novo script SQL>Script vazio.
  2. Aplique um script SQL de associação para unir os metadados de escolha com sua tabela Dataverse e armazenar a exibição em um novo banco de dados.

Exemplo de script SQL para unir metadados de escolha

Substitua <DATABASE_NAME>, <COLUMN_NAME> e <TABLE_NAME> pelos nomes do banco de dados, coluna e tabela para substituir o valor numérico de escolha por um rótulo de texto significativo.

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 valores de conjunto de opções, você teria que usar Usando expressões de tabela comuns.

  • Last updated on