Alternatieve sleutels definiëren om te verwijzen naar rijen

  • Artikel

Met alternatieve sleutels beschikt u over een efficiënte en nauwkeurige manier om gegevens te integreren met externe systemen. Het is essentieel in gevallen waarin een extern systeem de GUID (Globally Unique Identifier), waarmee rijen in Microsoft Dataverse uniek worden geïdentificeerd, niet opslaat.

Een systeem voor gegevensintegratie gebruikt alternatieve sleutels om rijen uniek te identificeren op basis van een of meer tabelkolomwaarden die een unieke combinatie vormen. Elke alternatieve sleutel heeft een unieke naam.

Wanneer u een accountrij met een alternatieve sleutel wilt identificeren, kunt u bijvoorbeeld het accountnummer of de accountnummerkolom gebruiken in combinatie met enkele andere kolommen met waarden die niet moeten worden gewijzigd.

Notitie

Hoewel u alternatieve sleutels kunt definiëren met Power Apps, kunnen deze alleen programmatisch worden gebruikt in code. Zie de volgende onderwerpen voor meer informatie over het programmatisch gebruik van alternatieve sleutels:

Tot de voordelen van de functie voor alternatieve sleutels behoren:

  • Sneller opzoeken van de rijen.
  • Robuustere bulksgewijze gegevensbewerkingen.
  • Eenvoudigere programmering van gegevens geïmporteerd vanuit externe systemen zonder rij-id's.

Een alternatieve sleutel maken

Er zijn twee ontwerpers die u kunt gebruiken om alternatieve sleutels te maken:

Ontwerper Beschrijving
Power Apps-portal Biedt een eenvoudig gestroomlijnde ervaring, maar een aantal opties is niet beschikbaar.
Meer informatie: Alternatieve sleutels definiëren via Power Apps-portal
Oplossingenverkenner Deze ontwerper is niet zo eenvoudig, maar biedt meer flexibiliteit en heeft minder algemene vereisten.
Meer informatie: Alternatieve sleutels definiëren via oplossingenverkenner

Notitie

U kunt ook als volgt een alternatieve sleutel in uw omgeving maken:

De informatie in dit artikel helpt u bij het kiezen van welke ontwerper u kunt gebruiken.

U moet de Power Apps-portal gebruiken om alternatieve sleutels te maken, tenzij u moet voldoen aan de volgende vereisten:

  • Een alternatieve sleutel maken in een andere oplossing dan de Common Data Service-standaardoplossing.
  • U wilt eenvoudig de systeemtaak kunnen volgen waarmee de voortgang van het maken van de ondersteunende indexen wordt bijgehouden.

Beperkingen bij het maken van alternatieve sleutels

Er gelden enkele beperkingen bij het maken van alternatieve sleutels.

Velden die voor alternatieve sleutels kunnen worden gebruikt

Alleen deze typen kolommen kunnen worden gebruikt om alternatieve sleutels te maken:

  • Decimal
  • Geheel getal
  • Eén tekstregel (tekenreeks)
  • Datum en tijd
  • Zoekopdracht
  • Keuze

Notitie

  • Kolommen waarvoor de eigenschap Kolombeveiliging inschakelen is ingeschakeld, kunnen niet worden gebruikt als een alternatieve sleutel. Meer informatie: Veldbeveiligingstabellen
  • Wanneer NULL-waarden worden gebruikt in alternatieve sleutelkolommen, wordt uniciteit niet afgedwongen. Om dubbele records te voorkomen, mag u geen null-waarden gebruiken in de kolommen die zijn gedefinieerd in de unieke beperking van alternatieve sleutel.

Aantal sleutels

U kunt maximaal tien verschillende sleutels definiëren voor een tabel.

Geldige sleutelgrootte

Bij het maken van een sleutel valideert het systeem of de sleutel kan worden ondersteund door het platform, inclusief of de totale sleutelgrootte niet de beperkingen voor de SQL-index, zoals 900 bytes per sleutel en 16 kolommen per sleutel, overschrijdt. Als de sleutelgrootte niet aan de beperkingen voldoet, wordt een foutmelding weergegeven.

Unicode-tekens in sleutelwaarde

Als de gegevens in een kolom die in een alternatieve sleutel wordt gebruikt een van de tekens <,>,*,%,&,:,/,\\,# bevat, werken de update- of upsert-acties (PATCH) niet.

Als u alleen uniciteit nodig hebt, werkt deze benadering wel, maar als u deze sleutels als onderdeel van een gegevensintegratie moet gebruiken, kunt u de sleutel het beste maken voor kolommen die geen gegevens met deze tekens bevatten.

De status van het maken van de alternatieve sleutel bijhouden

Wanneer een alternatieve sleutel wordt gemaakt, wordt er een systeemtaak geïnitieerd om indexen voor de databasetabellen te maken en unieke beperkingen af te dwingen voor de kolommen die worden gebruikt door de alternatieve sleutel. De alternatieve sleutel wordt pas van kracht als deze indexen zijn gemaakt. Het maken van deze indexen kan enige tijd in beslag nemen, afhankelijk van de hoeveelheid gegevens in het systeem.

De status van de systeemtaak definieert de status van de alternatieve sleutel. De alternatieve sleutel kan de volgende statussen hebben:

  • In behandeling
  • Wordt uitgevoerd
  • Actief
  • Mislukt

Als de systeemtaak is voltooid, wordt de status van de alternatieve sleutel Actief en is deze beschikbaar voor gebruik.

Als de systeemtaak mislukt, controleert u deze op eventuele fouten. Een systeemtaak heeft een naam met het patroon Create index for {0} for table {1}, waarbij 0 de weergavenaam van de alternatieve sleutel is en 1 de naam van de tabel.

Notitie

Als u de status van de systeemtaak wilt controleren, moet u oplossingenverkenner gebruiken om de index te maken. Hierin is een koppeling naar de systeemtaak opgenomen zodat u deze kunt bekijken. Meer informatie: (Optioneel) De systeemtaak voor het bijhouden van het maken van indexen weergeven

Zie ook

Alternatieve sleutels definiëren via Power Apps-portal
Alternatieve sleutels definiëren via oplossingenverkenner
Documentatie voor ontwikkelaars: Alternatieve sleutels voor een tabel definiëren
Documentatie voor ontwikkelaars: Een alternatieve sleutel gebruiken voor het maken van een rij

Notitie

Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)

De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).