Definir claus alternatives per fer referència a files

Nota

Vigent a partir del novembre de 2020:

  • S’ha canviat el nom del Common Data Service per Microsoft Dataverse. Més informació
  • S’han actualitzat alguns termes del Microsoft Dataverse. Per exemple, ara entitat s’anomena taula, i el camp ha passat a anomenar-se columna. Més informació

Aquest article s’actualitzarà pròximament per reflectir la terminologia més recent.

Les claus alternatives proporcionen una manera eficaç i precisa d'integrar dades amb sistemes externs. És essencial en els casos en un sistema extern no emmagatzema els identificadors GUID (identificador únic global) que identifiquen les files del Microsoft Dataverse de manera única.

Un sistema d'integració de dades utilitzarà claus alternatives per identificar de manera única les files amb un o diversos valors de columna de taula que representen una combinació única. Cada clau alternativa té un nom únic.

Per exemple, per identificar una fila de compte amb una clau alternativa, podeu utilitzar el número de compte o la columna de número de compte conjuntament amb altres columnes que tenen valors que no han de canviar.

Nota

Tot i que podeu definir les claus alternatives amb el Power Apps, només es poden utilitzar mitjançant programació al codi. Per obtenir més informació sobre l'ús mitjançant programació de claus alternatives, vegeu:

Alguns dels avantatges de la característica de claus alternatives són:

  • Cerca més ràpida de les files.
  • Operacions de dades massives més robustes.
  • La programació simplificada amb dades importades de sistemes externs sense id. de fila.

Crear una clau alternativa

Hi ha dos dissenyadors que podeu utilitzar per crear claus alternatives:

Dissenyador Descripció
Portal del Power Apps Proporciona una experiència senzilla i simplificada, però algunes de les opcions no estan disponibles.
Més informació: Definir les claus alternatives amb el portal del Power Apps
Explorador de solucions No és tan fàcil, però proporciona més flexibilitat per a les necessitats menys comunes.
Més informació: Definir les claus alternatives amb l'explorador de solucions

Nota

També podeu crear una clau alternativa al vostre entorn amb les accions següents:

La informació d'aquest tema us ajudarà a triar el dissenyador que podeu utilitzar.

Heu d'utilitzar el Portal del Power Apps per crear claus alternatives tret que hagueu de tractar algun dels requisits següents:

  • Crear una clau alternativa dins d'una solució que no sigui la solució per defecte Common Data Service
  • Voleu realitzar el seguiment de la feina del sistema creat que fa el seguiment de l'evolució de crear els índexs de suport

Límits en la creació de claus alternatives

Hi ha limitacions sobre la creació de claus alternatives.

Camps que es poden utilitzar per a les claus alternatives

Només aquest tipus de columnes es poden utilitzar per crear claus alternatives:

  • Decimal
  • Nombre enter
  • Una línia de text (cadena)
  • Data i hora
  • Cerca
  • Opció

Nombre de claus

Podeu definir fins a deu claus diferents per a una taula.

Mida de clau vàlida

Quan es crea una clau, el sistema valida que la clau sigui compatible amb la plataforma, incloent-hi que la mida total de la clau no viola les restriccions de l'índex basat en SQL, com 900 bytes per clau i 16 columnes per clau. Si la mida de la clau no s'ajusta a les limitacions, es mostrarà un missatge d'error.

Caràcters Unicode del valor de la clau

Si les dades d'una columna que s'utilitza en una clau alternativa inclouran un dels següents caràcters <,>,*,%,&,:,/,\\ les accions d'actualització o upsert (PATCH) no funcionaran.

Si només necessiteu exclusivitat, aquest mètode funcionarà, però si us cal utilitzar aquestes claus com a part de la integració de dades, es millor crear la clau a les columnes que no tindran dades amb aquests caràcters.

Fer el seguiment de l'estat de la creació de la clau alternativa

Quan es crea una clau alternativa, aquesta iniciarà una feina del sistema per crear els índexs de les taules de la base de dades per aplicar les restriccions úniques a les columnes que utilitza la clau alternativa. La clau alternativa no estarà vigent fins que es creïn aquests índexs. La creació d'aquests els índexs pot tardar una estona en funció de la quantitat de dades del sistema.

L'estat de la feina del sistema determina l'estat de la clau alternativa. La clau alternativa pot tenir els estats següents:

  • Pendent
  • En curs
  • Actiu
  • Amb errors

Quan es completa la feina del sistema, l'estat de la clau alternativa és Actiu i està disponible per utilitzar-la.

Si la feina del sistema genera error, localitzeu-la per visualitzar els errors. La feina del sistema tindrà un nom que segueix aquest model: Create index for {0} for table {1}, on 0 és el Nom de visualització de la clau d'alternativa i 1 és el nom de la taula.

Nota

Si voleu controlar l'estat de la feina del sistema heu d'utilitzar l'Explorador de solucions per crear l'índex. Inclourà un enllaç a la feina del sistema per tal que pugueu supervisar-la. Més informació: (Opcional) Veure la creació d'índexs del seguiment de feina del sistema

Consulteu també

Definir les claus alternatives amb el portal del Power Apps
Definir les claus alternatives amb l’explorador de solucions
Documentació per a desenvolupadors: Definir claus alternatives per a una taula
Documentació per a desenvolupadors: Utilitzar una clau alternativa per crear una fila