Definiera alternativa nycklar till referensrader

Alternativa nycklar ger ett effektivt och korrekt sätt att integrera data med externa system. Det är viktigt när ett externt system inte lagrar GUID-ID:n (Globally Unique Identifier) som unikt identifierar rader i Microsoft Dataverse.

Ett dataintegreringssystem använder alternativa nycklar för att unikt identifiera rader med hjälp av ett eller flera tabellkolumnvärden som representerar en unik kombination. Varje alternativnyckel har ett unikt namn.

Till exempel för att identifiera en kontorad med en alternativ nyckel, kan du använda kontonumret eller kontonummerkolumn tillsammans med andra kolumner som har värden som inte ska ändras.

Några exempel på fördelar med alternativa nycklar:

• Snabbare sökning av raderna.
• Mer robusta massdataåtgärder.
• Förenklad programmering med data som importerats från externa system utan rad-ID.

Skapa en alternativ nyckel

Det finns två designers som du kan använda för att skapa alternativa nycklar:

Information i den här artikeln hjälper dig att välja vilken designer du kan använda.

Du bör använda Power Apps-portalen för att skapa alternativa nycklar om du inte behöver uppfylla något av följande krav:

• Skapa en alternativ nyckel i en annan lösning än Common Data Service-standardlösningen.
• Du vill enkelt spåra det skapade systemuppgiftet som spårar förloppet för tillhörande index.

Gränser för att skapa alternativa nycklar

Det finns begränsningar för att skapa alternativa nycklar.

Fält som kan användas för alternativa nycklar

Endast den här typen av kolumner kan användas för att skapa alternativa nycklar:

• Decimal
• Heltal
• Enskild rad med text (sträng)
• Datum och tid
• Sökning
• Alternativ

Antal nycklar

Du kan definiera upp till 10 olika nycklar för en tabell.

Giltig nyckelstorlek

När en nyckel skapas verifierar systemet att nyckeln kan stödjas av plattformen, inklusive att den totala nyckelstorleken inte bryter mot SQL-baserade indexbegränsningar som 900 byte per nyckel och 16 kolumner per nyckel. Om nyckelstorleken inte uppfyller begränsningarna visas ett felmeddelande.

Unicode-tecken i nyckelvärde

Om data i en kolumn som används i en alternativ nyckel innehåller något av följande tecken <, >, *, %, &, :, /, \\, # fungerar inte uppdaterings- eller upsert-åtgärder (PATCH).

Om du bara behöver unikhet fungerar den här metoden, men om du behöver använda dessa nycklar som en del av dataintegrering är det bäst att skapa nyckeln för kolumner som inte har data med dessa tecken.

Spåra status för skapandet av den alternativa nyckeln

När en alternativ nyckel skapas initieras ett systemjobb för att skapa index på databastabellerna för att framtvinga unika begränsningar för de kolumner som används av den alternativa nyckeln. Den alternativa nyckeln gäller inte förrän indexen har skapats. Det kan ta lite tid att skapa dessa index beroende på mängden data i systemet.

Status för systemjobbet avgör tillståndet för den alternativa nyckeln. Den alternativa nyckeln kan ha följande tillstånd:

• Väntande
• Pågår
• Aktiv
• Misslyckades

När systemjobbet har slutförts är den alternativa nyckelstatusen Aktiv och den är tillgänglig för användning.

Om systemjobbet misslyckas, hitta systemjobbet för att visa eventuella fel. Systemjobbet har ett namn som följer det här mönstret: Create index for {0} for table {1} var 0 är visningsnamnet för den alternativa nyckeln och 1 är namnet på tabellen.

Se även

Definiera alternativa nycklar med hjälp av Power Apps-portalen
Definiera alternativa nycklar med Solution Explorer
Utvecklardokumentation: Arbeta med alternativa nycklar
Utvecklardokumentation: Använd en alternativ nyckel för att referera till en post
Utvecklardokumentation: Hämta post med hjälp av en alternativ nyckel