Compartir por

Definir claves alternativas a facer referencia a filas

As claves alternativas proporcionan unha forma eficiente e precisa de integrar datos con sistemas externos. É esencial en casos nos que un sistema externo non almacena identificadores do Identificador Único Global (GUID) que identifican exclusivamente filas en Microsoft Dataverse.

Un sistema de integración de datos usa claves alternativas para identificar de forma única as filas mediante un ou máis valores de columna de táboa que representan unha combinación única. Cada clave alternativa ten un nome único.

Por exemplo, para identificar unha fila de conta cunha clave alternativa, podes usar o número de conta ou a columna do número de conta en combinación con outras columnas, que teñen valores que non deberían cambiar.

Nota

Aínda que pode definir claves alternativas con Power Apps, só se poden utilizar mediante programación en código. Para obter máis información sobre como usar as claves alternativas mediante programación consulte:

Os beneficios da funcionalidade de claves alternativas son, entre outros:

  • Busca máis rápida de filas.
  • Operacións de datos en masa máis sólidas.
  • Programación simplificada con datos importados de sistemas externos sen identificadores de filas.

Creación dunha clave alternativa

Hai dous deseñadores que pode utilizar para crear claves alternativas:

Deseñador Descrición
Power Apps portal Ofrece unha experiencia sinxela e optimizada, pero algunhas opcións non están dispoñibles.
Máis información: Definir claves alternativas usando Power Apps o portal
Explorador de solucións Non é tan fácil, mais fornece máis flexibilidade para requirimentos menos comúns.
Máis información: Definir claves alternativas mediante o explorador de solucións

Nota

Tamén pode crear unha clave alternativa no seu ambiente facendo o seguinte:

A información deste artigo axúdache a escoller que deseñador podes usar.

Deberías usar o Power Apps portal para crear claves alternativas a non ser que necesites abordar algún dos seguintes requisitos:

  • Crea unha clave alternativa dentro dunha solución que non sexa a Common Data Service Solución predeterminada.
  • Queres rastrexar facilmente o traballo do sistema creado que rastrexa o progreso da creación dos índices de apoio.

Límites ao crear claves alternativa

Non hai restricións na creación de claves alternativas.

Campos que se poden usar para claves alternativas

Só estes tipos de columnas se poden utilizar para crear claves alternativas:

  • Decimal
  • Número enteiro
  • Liña única de texto (cadea)
  • Data e hora
  • Busca
  • Opción

Nota

  • As columnas que teñan a propiedade Activar a seguranza da columna activada non se poden usar como clave alternativa. Máis información: Táboas de seguranza de campo
  • Cando se usan valores NULL en columnas de clave alternativas, non se aplicará a singularidade. Para evitar rexistros duplicados, non empregue valores nulos nas columnas definidas na restrición única da clave alternativa.

Número de claves

Podes definir ata 10 claves diferentes para unha táboa.

Tamaño de clave válido

Cando se crea unha clave, o sistema valida que a plataforma pode admitila, incluíndo que o tamaño total da clave non infrinxa as restricións de índice baseadas en SQL, como 900 bytes por clave e 16 columnas por clave. Se o tamaño da clave non cumpre as restricións, mostrarase unha mensaxe de erro.

Caracteres Unicode en valor de clave

Se os datos dunha columna que se usa nunha clave alternativa conteñen un dos seguintes caracteres <,>,*,%,&,:,/,\\,# , as accións de actualización ou de subida (PATCH) non funcionarán.

Se só precisa singularidade, esta estratexia funciona, pero se precisa usar estas claves como parte da integración de datos, o mellor é crear a clave en columnas que non teñan datos con estes caracteres.

Rastrexar o estado da creación da clave alternativa

Cando se crea unha clave alternativa, inicia unha tarefa do sistema para crear índices nas táboas da base de datos para aplicar restricións únicas nas columnas empregadas pola clave alternativa. A clave alternativa non estará en vigor ata que se creen estes índices. A creación destes índices pode levar algún tempo dependendo da cantidade de datos do sistema.

O estado do traballo do sistema determina o estado da clave alternativa. A clave alternativa pode ter os seguintes estados:

  • Pendente
  • En progreso
  • Activo
  • Fallou

Cando se completa o traballo do sistema, o estado da clave alternativa é Activa e está dispoñible para o seu uso.

Se hai erros no traballo do sistema, localice o traballo do sistema para ver os erros. O traballo do sistema terá un nome que siga este patrón: Create index for {0} for table {1} onde 0 é o Nome para mostrar da clave alternativa e 1 é o nome da táboa.

Nota

Se desexa monitorar o estado do traballo do sistema debe utilizar o explorador de solucións para crear o índice. Incluirá unha ligazón ao traballo do sistema para que o poida monitorar. Máis información: (Opcional) Ver a creación de índices de seguimento de tarefas do sistema

Consulte tamén

Definir claves alternativas usando o portal Power Apps
Definir claves alternativas usando o explorador de solucións
Documentación para desenvolvedores: Definir claves alternativas para unha táboa
Documentación para desenvolvedores: Usar unha clave alternativa para crear unha fila