Definir chaves alternativas referenciar linhas

  • Artigo

As chaves alternativas proporcionam um modo eficiente e preciso de integrar dados com sistemas externos. É essencial, nos casos em que um sistema externo não armazena IDs de identificador global exclusivo (GUID), que identifiquem exclusivamente as linhas no Microsoft Dataverse.

Um sistema de integração de dados usa chaves alternativas para identificar exclusivamente linhas, usando um ou mais valores de coluna de tabela que representem uma combinação exclusiva. Cada chave alternativa tem um nome exclusivo.

Por exemplo, para identificar uma linha de conta com uma chave alternativa, você pode usar o número da conta ou a coluna do número da conta em combinação com algumas outras colunas que tenham valores que não devem mudar.

Observação

Embora você possa definir chaves alternativas com o Power Apps, elas só podem ser usadas de forma programada no código. Para saber mais sobre o uso de chaves alternativas programaticamente, consulte:

Alguns dos benefícios do recurso de chaves alternativas incluem:

  • Pesquisa de linhas mais rápida.
  • Operações de dados em massa mais robustas.
  • Programação simplificada com dados importados de sistemas externos sem IDs de linha.

Criando uma chave alternativa

Existem dois designers que você pode usar para criar chaves alternativas:

Designer Descrição
Portal do Power Apps Oferece uma experiência aprimorada fácil, embora algumas opções não estejam disponíveis.
Mais informações: Definir chaves alternativas usando o portal do Power Apps
Gerenciador de soluções Não é tão fácil de usar, mas fornece mais flexibilidade para requisitos menos comuns.
Mais informações: Defina chaves alternativas, usando o gerenciador de soluções

Observação

Você também pode criar uma chave alternativa em seu ambiente, usando os seguintes procedimentos:

As informações neste artigo ajudam você a escolher qual designer usar.

Você deve usar o portal do Power Apps para criar chaves alternativas, a menos que precise atender a qualquer um dos seguintes requisitos:

  • Crie uma chave alternativa dentro de uma solução diferente da solução padrão do Common Data Service.
  • Você deseja rastrear facilmente o trabalho do sistema criado que rastreia o progresso de criação dos índices de suporte.

Limites na criação de chaves alternativas

Há restrições na criação de chaves alternativas.

Campos que podem ser usados para chaves alternativas

Somente estes tipos de colunas podem ser usados para criar chaves alternativas:

  • Decimal
  • Número inteiro (inteiro)
  • Linha única de texto (cadeia de caracteres)
  • Data e hora
  • Pesquisar
  • Opção

Observação

  • Colunas com a propriedade Habilitar segurança da coluna habilitada não podem ser usadas como chave alternativa. Mais informações: Tabelas de segurança de campo
  • Quando valores NULL forem usados em colunas de chave alternativa, a exclusividade não será imposta. Para evitar registros duplicados, não use valores nulos nas colunas definidas na restrição exclusiva da chave alternativa.

Número de chaves

Você pode definir até dez chaves diferentes para uma tabela.

Tamanho de chave válido

Quando uma chave é criada, o sistema valida que essa chave pode ser compatível com a plataforma, inclusive que o tamanho total da chave não viola restrições de índice com base em SQL como 900 bytes por chave e 16 colunas por chave. Se o tamanho da chave não atender às restrições, uma mensagem de erro será exibida.

Caracteres Unicode no valor da chave

Se os dados dentro de uma coluna usada em uma chave alternativa contiverem um dos caracteres a seguir <,>,*,%,&,:,/,\\,#, as ações update ou upsert (PATCH) não funcionarão.

Se você só precisar de exclusividade, essa abordagem funcionará. Porém, se precisar usar essas chaves como parte da integração de dados, o melhor será criar a chave em colunas que não tenham dados com esses caracteres.

Rastrear o status da criação da chave alternativa

Quando é criada, uma chave alternativa inicia um trabalho do sistema para criar índices nas tabelas de banco de dados para impor restrições exclusivas às colunas usadas pela chave alternativa. A chave alternativa não entrará em vigor até esses índices serem criados. A criação desses índices pode levar algum tempo, dependendo da quantidade de dados no sistema.

O status do trabalho do sistema determina o estado da chave alternativa. A chave alternativa pode ter os seguintes estados:

  • Pendente
  • Em Andamento
  • Ativa
  • Falha

Quando o trabalho do sistema é concluído, o status da chave alternativa é Ativo, estando disponível para uso.

Se o trabalho do sistema falhar, localize o trabalho do sistema para visualizar os erros. O trabalho do sistema terá um nome com o seguinte padrão: Create index for {0} for table {1} onde 0 é o Nome de exibição da chave alternativa e 1 é o nome da tabela.

Observação

Para monitorar o status do trabalho do sistema, você deverá usar o gerenciador de soluções para criar o índice. Isso incluirá um link para o trabalho do sistema, de modo que você poderá monitorá-lo. Mais informações: (Opcional) Exibir o trabalho do sistema para rastrear a criação de índices

Consulte também

Definir chaves alternativas usando o portal do Power Apps
Definir chaves alternativas usando o Gerenciador de soluções
Documentação do Desenvolvedor: Definição de chaves alternativas para uma tabela
Documentação do Desenvolvedor: usar uma chave alternativa para criar uma linha

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).