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:
- Importar una solució que contingui la definició de la clau alternativa.
- Un desenvolupador també pot escriure codi per crear-les. Més informació: Documentació per a desenvolupadors: Definir claus alternatives per a una taula.
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