Freigeben über

Definieren von Alternativschlüsseln für den Verweis auf Zeilen

  • Artikel

Alternativschlüsseln bieten eine genaue und effiziente Methode der Integration mit Daten aus externen Systemen. Wenn ein externes System die IDs des Globally Unique Identifier (GUID) nicht speichern, ist es von größter Wichtigkeit, dass die Zeilen in Microsoft Dataverse eindeutig identifiziert werden.

Ein Datenintegrationssystem verwendet Alternativschlüssel, um Zeilen mit einem oder mehreren Tabellenspalten, die eine eindeutige Kombination darstellen, eindeutig zu identifizieren. Jeder Alternativschlüssel hat einen eindeutigen Namen.

Möchten Sie beispielsweise eine Firmenzeile mit einem Alternativschlüssel identifizieren, können Sie die Firmennummer oder die Firmennummernspalte in Verbindung mit mehreren anderen Spalten verwenden, die Werte enthalten, die nicht geändert werden sollten.

Hinweis

Obwohl Sie Alternativschlüssel mit Power Apps definieren können, können diese aber nur programmgesteuert im Code verwendet werden. Weitere Informationen über die programmgesteuerte Verwendung von Alternativschlüsseln finden Sie unter:

Einige Vorteile der Alternativschlüsselfunktion sind nachfolgend aufgeführt:

  • Schnellere Suche der Zeilen.
  • Leistungsfähigere Massendatenvorgänge.
  • Vereinfachte Programmierung mit Daten, die aus externen Systemen ohne Zeilen-IDs importiert werden.

Erstellen eines Alternativschlüssels

Sie können zwei Designer verwenden, um Alternativschlüssel zu erstellen:

Designer Beschreibung
Power Apps-Portal Bietet eine einfache optimierte Erfahrung, aber einige Optionen sind nicht verfügbar.
Weitere Informationen: Alternativschlüssel mithilfe von Power Apps-Portalen festlegen
Projektmappen-Explorer Nicht so einfach, aber gibt mehr Flexibilität für weniger allgemeine Anforderungen.
Weitere Informationen: Alternativschlüssel mithilfe des Projektmappen-Explorers festlegen

Hinweis

Sie können auch einen Alternativschlüssel in Ihrer Umgebung wie folgt erstellen:

Die Informationen in diesem Artikel helfen Ihnen auswählen, welche Designer Sie verwenden können.

Sie sollten das Power Apps-Portal verwenden, um alternative Schlüssel zu erstellen, es sei denn, Sie müssen eine der folgenden Anforderungen erfüllen:

  • Erstellen Sie einen Alternativschlüssel in einer Lösung, die keine Common Data Service-Standardlösung ist.
  • Sie möchten den erstellten Systemauftrag, der den Fortschritt der Erstellung der unterstützenden Indizes nachverfolgt, ganz leicht nachverfolgen.

Beschränkungen, bei der Erstellung von Alternativschlüsseln

Es gibt Einschränkungen bei der Alternativschlüsselerstellung.

Felder, die für Alternativschlüssel verwendet werden können

Nur diese Spaltentypen können verwendet werden, um Alternativschlüssel zu erstellen:

  • Decimal
  • Ganze Zahl (Integer)
  • Einzelne Textzeile (String)
  • Datum und Uhrzeit
  • Nachschlagefeld
  • Auswahl

Hinweis

  • Spalten mit aktivierter Eigenschaft Spaltensicherheit aktivieren können nicht als Alternativschlüssel verwendet werden. Mehr Informationen: Tabellen für die Feldsicherheit
  • Wenn NULL-Werte in Alternativschlüssel-Spalten verwendet werden, wird die Eindeutigkeit nicht erzwungen. Um doppelte Datensätze zu vermeiden, verwenden Sie keine Nullwerte in den Spalten, die in der eindeutigen Einschränkung des Alternativschlüssels definiert sind.

Anzahl der Schlüssel

Sie können bis zu 10 verschiedene Schlüssel für eine Tabelle festlegen.

Gültige Schlüsselgröße

Wenn ein Schlüssel erstellt wird, überprüft das System, ob dieser Schlüssel von der Plattform unterstützt werden kann, u. a. auch, ob die Gesamtschlüsselgröße nicht gegen die SQL-basierten Indexeinschränkungen verstößt, zum Beispiel 900 Bytes pro Schlüssel und 16 Spalten pro Schlüssel. Wenn die Schlüsselgröße die Einschränkungen nicht erfüllt, wird eine Fehlermeldung angezeigt.

Unicode-Zeichen im Schlüsselwert

Wenn die Daten innerhalb einer Spalte, die in einem Alternativschlüssel verwendet wird, eines der folgenden Zeichen enthält: <,>,*,%,&,:,/,\\,#, funktionieren Aktualisierungs- oder upsert (PATCH)-Aktionen nicht.

Wenn Sie nur Eindeutigkeit benötigen, reicht dieser Ansatz aus, wenn Sie jedoch diese Schlüssel im Rahmen der Datenintegration benötigen, sollten Sie den Schlüssel besser in Spalten erstellen, die keine Daten mit diesen Zeichen haben.

Verfolgen Sie den Status der Erstellung des Alternativschlüssels nach

Wenn ein Alternativschlüssel erstellt wird, initiiert er einen Systemauftrag, um Indizes für die Datenbanktabellen zu erstellen, um einzigartige Einschränkungen auf den Spalten zu erzwingen, die vom Alternativschlüssel verwendet werden. Der Alternativschlüssel wird nicht wirksam, bis diese Indizes erstellt werden. Die Erstellung dieser Indizes dauert möglicherweise einige Zeit je nach der Menge der Daten im System.

Der Status des Systemauftrags legt den Status des Alternativschlüssels fest. Der Alternativschlüssel kann die folgenden Statuswerte aufweisen:

  • Ausstehend
  • In Bearbeitung
  • Active
  • Fehlgeschlagen

Wenn der Systemauftrag abgeschlossen wird, ist der Alternativschlüsselstatus Aktiv und er kann verwendet werden.

Wenn der Systemauftrag fehlschlägt, suchen Sie den Systemauftrag, um Fehler anzuzeigen. Der Systemauftrag hat einen Namen, der diesem Muster folgt: Create index for {0} for table {1} wobei 0 der Anzeigename des Alternativschlüssels ist und 1 der Namen der Tabelle.

Hinweis

Wenn Sie den Status des Systemauftrags überwachen möchten, müssen Sie den Projektmappen-Explorer verwenden, um den Index zu erstellen. Er enthält einen Link zum Systemauftrag, um ihn zu überwachen. Weitere Informationen: (Optional) Zeigen Sie die Indexerstellung bei der Systemauftragsnachverfolgung an

Siehe auch

Alternativschlüssel mithilfe von Power Apps-Portalen festlegen
Alternativschlüssel mithilfe des Projektmappen-Explorers festlegen
Entwicklerdokumentation: Definieren eines Alternativschlüssels für eine Tabelle
Entwicklerdokumentation: Verwenden Sie einen Alternativschlüssel, um Spalten zu erstellen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).