Condividi tramite

Definire le chiavi alternative per fare riferimento a righe

  • Articolo

Le chiavi alternative offrono un modo preciso ed efficiente per integrare i dati con sistemi esterni. Sono essenziali nei casi in cui un sistema esterno non memorizza gli identificatori univoci globali (GUID) che identificano in modo univoco le righe in Microsoft Dataverse.

Un sistema di integrazione dei dati utilizza chiavi alternative per identificare in modo univoco le righe mediante uno o più valori di colonne di tabella che rappresentano una combinazione univoca. Ogni chiave alternativa ha un nome univoco.

Per identificare ad esempio una riga di account con una chiave alternativa, è possibile utilizzare il numero di account o la colonna del numero di account congiuntamente con alcune altre colonne i cui valori non devono cambiare.

Nota

Mentre è possibile definire chiavi alternative con Power Apps, queste possono essere utilizzate solo a livello di codice. Per ulteriori informazioni sull'utilizzo delle chiavi alternative a livello di codice, vedere:

Alcuni dei vantaggi della funzionalità delle chiavi alternative sono:

  • Ricerca più rapida delle righe.
  • Operazioni di dati in blocco più affidabili.
  • Programmazione semplificata con dati importati da sistemi esterni senza ID riga.

Creazione di una chiave alternativa

Esistono due strumenti di progettazione che è possibile utilizzare per generare le chiavi alternative:

Progettista Descrizione
Portale di Power Apps Fornisce un'esperienza semplificata, ma alcune opzioni non sono disponibili.
Ulteriori informazioni: Definire chiavi alternative tramite il portale di Power Apps
Esplora soluzioni Non così semplice, ma fornisce maggiore flessibilità per i requisiti meno comuni.
Ulteriori informazioni: Definire chiavi alternative tramite Esplora soluzioni

Nota

È inoltre possibile creare una chiave alternativa nell'ambiente tramite le operazioni seguenti:

Le informazioni in questo articolo risulteranno utili per scegliere la finestra di progettazione da utilizzare.

È consigliabile utilizzare il portale di Power Apps per creare chiavi alternative a meno che non sia necessario rispettare uno o più dei seguenti requisiti:

  • Creare una chiave alternativa in una soluzione diversa dalla soluzione predefinita di Common Data Service.
  • Si desidera tenere traccia facilmente del processo di sistema creato che registra i progressi nella creazione degli indici di supporto.

Limiti nella creazione di chiavi alternative

Esistono vincoli alla creazione di chiavi alternative.

Campi che possono essere utilizzati per le chiavi alternative

Solo questi tipi di colonne possono essere utilizzati per creare chiavi alternative:

  • Decimal
  • Numero intero (Integer)
  • Singola riga di testo (String)
  • Data e ora
  • Cerca
  • Choice

Nota

  • Le colonne che hanno la proprietà Abilita protezione colonne abilitata non possono essere utilizzate come chiave alternativa. Per ulteriori informazioni, vedere Tabelle di sicurezza campi
  • Quando vengono utilizzati valori NULL nelle colonne chiave alternativa, l'univocità non verrà applicata. Per evitare record duplicati, non utilizzare valori nulli nelle colonne definite nel vincolo univoco di chiave alternativa.

Numero di chiavi

Puoi definire fino a 10 chiavi diverse per una tabella.

Dimensione valida della chiave

Quando si crea una chiave, il sistema convalida che la chiave può essere supportata dalla piattaforma, incluso che la dimensione totale della chiave non viola i vincoli dell'indice SQL, ad esempio 900 byte per chiave e 16 colonne per chiave. Se la dimensione della chiave non soddisfa i vincoli, viene visualizzato un messaggio di errore.

Caratteri Unicode nel valore della chiave

Se i dati in una colonna utilizzata in una chiave alternativa contengono uno dei caratteri seguenti <,>,*,%,&,:,/,\\,# le azioni update o upsert (PATCH) non funzioneranno.

Se occorre solo l'univocità, questo approccio funzionerà, ma se è necessario utilizzare le chiavi nell'ambito dell'integrazione dei dati, è preferibile creare la chiave nelle colonne senza dati con tali caratteri.

Tenere traccia dello stato di creazione della chiave alternativa

Quando si crea una chiave alternativa, questa avvia un processo di sistema per creare gli indici nelle tabelle di database per applicare i vincoli specifici sulle colonne utilizzate dalla chiave alternativa. La chiave alternativa avrà effetto solo dopo che sono stati creati questi indici. La creazione di questi indici può richiedere alcuni minuti a seconda della quantità di dati nel sistema.

Lo stato del processo di sistema determina allo stato della chiave alternativa. La chiave alternativa può avere i seguenti stati:

  • In sospeso
  • In corso
  • Attiva
  • Non riuscito

Quando il processo di sistema viene completato, lo stato della chiave alternativa è Attivo ed è disponibile per l'utilizzo.

Se il processo di sistema ha esito negativo, individuare il processo di sistema per visualizzare gli errori. Il nome del processo di sistema segue questo schema: Create index for {0} for table {1} dove 0 è il Nome visualizzato della chiave alternativa e 1 è il nome della tabella.

Nota

Se si desidera controllare lo stato di un processo di sistema, è consigliabile utilizzare Esplora soluzioni per creare l'indice. Comprenderà un collegamento al processo di sistema per consentirne il monitoraggio. Ulteriori informazioni: (Facoltativo) Visualizzare il processo di sistema per tenere traccia della creazione degli indici

Vedi anche

Definire chiavi alternative tramite il portale di Power Apps
Definire chiavi alternative tramite Esplora soluzioni
Documentazione per sviluppatori: Definire le chiavi alternative per una tabella
Documentazione per sviluppatori: Utilizzare una chiave alternativa per creare una riga

Nota

Puoi indicarci le tue preferenze di lingua per la documentazione? Partecipa a un breve sondaggio. (il sondaggio è in inglese)

Il sondaggio richiederà circa sette minuti. Non viene raccolto alcun dato personale (Informativa sulla privacy).