GET_IDENTITY( table_name [, number_to_allocate ] )

UNSIGNED BIGINT

Zum Generieren von IDs ist die Verwendung von AUTOINCREMENT oder GLOBAL AUTOINCREMENT nach wie vor die effizienteste Methode. Diese Funktion kann jedoch als Alternative verwendet werden. Die Funktion geht davon aus, dass für die Tabelle eine AUTOINCREMENT-Spalte definiert ist. Sie gibt den nächsten verfügbaren Wert zurück, der für die AUTOINCREMENT-Spalte der Tabelle generiert würde, und reserviert diesen Wert, damit ihn nicht eine andere Verbindung standardmäßig verwendet.

Die Funktion gibt eine Fehlermeldung zurück, sollte die Tabelle nicht gefunden werden, und NULL, wenn die Tabelle keine AUTOINCREMENT-Spalte enthält. Wenn mehrere AUTOINCREMENT-Spalten vorhanden sind, verwendet die Funktion die erste gefundene Spalte.

number_to_allocate ist die Anzahl der zu reservierenden Werte. Wenn der Wert number_to_allocate größer als 1 ist, reserviert die Funktion auch die restlichen Werte. Die nächste Zuweisung verwendet die aktuelle Zahl und addiert den Wert von number_to_allocate. Dies führt dazu, dass die Anwendung get_identity weniger häufig ausführen muss. Wenn number_to_allocate gleich 0 ist, wird der nächste verfügbare Wert zurückgegeben, ohne Werte zu reservieren.

Nach dem Ausführen der GET_IDENTITY-Funktion ist kein COMMIT mehr notwendig, und daher kann dieselbe Verbindung zum Aufruf der Funktion und zum Einfügen von Zeilen verwendet werden. Wenn ID-Werte für mehrere Tabellen benötigt werden, können diese über einmaliges Aufrufen der SELECT-Anweisung, die mehrere Aufrufe der GET_IDENTITY-Funktion beinhaltet, bezogen werden. Siehe hierzu das Beispiel.

Die GET_IDENTITY-Funktion ist eine nicht-deterministische Funktion. Aufeinanderfolgende Aufrufe können unterschiedliche Werte zurückgeben. Der Optimierer behält die Ergebnisse der Funktion GET_IDENTITY nicht im Cache.

Weitere Hinweise zu nicht-deterministischen Funktionen finden Sie unter Caching von Funktionen.

• CREATE TABLE-Anweisung
• ALTER TABLE-Anweisung
• NUMBER-Funktion [Verschiedene]

Die folgende Anweisung gibt den nächsten verfügbaren Wert für die AUTOINCREMENT-Spalte (ID) der Tabelle Customers zurück. Die zurückgegebene Nummer und die folgenden neun Werte sind reserviert:

SELECT GET_IDENTITY( 'Customers', 10 );