sa_reset_identity-Systemprozedur

Ermöglicht, dass der nächste Identity-Wert für eine Tabelle eingestellt wird. Verwenden Sie diese Systemprozedur, wenn der Wert für die nächste einzufügende Zeile automatisch um 1 erhöht werden soll (Autoincrement).

Syntax

sa_reset_identity( 
Tabellenname, 
Eigentümername, 
neue_Identität 
)

Argumente

Tabellenname Verwenden Sie diesen CHAR(128)-Parameter, um die Tabelle anzugeben, bei der Sie den ID-Wert zurücksetzen wollen. Wenn kein Eigentümer angegeben ist, muss Tabellenname eine Tabelle in der Datenbank eindeutig identifizieren.
Eigentümername Verwenden Sie diesen CHAR(128)-Parameter, um den Eigentümer der Tabelle anzugeben, bei der Sie den ID-Wert zurücksetzen wollen.
neue_Identität Verwenden Sie diesen BIGINT-Parameter, um den Wert anzugeben, von dem aus Sie das Autoincrement starten wollen.

Bemerkungen

Der nächste Wert, der für eine in die Tabelle eingefügte Zeile generiert wird, ist neue_Identität + 1.

Es wird nicht überprüft, ob neue_Identität + 1 mit einer bestehenden Zeile in der Tabelle in Konflikt steht. Wenn Sie zum Beispiel für neue_Identität den Wert 100 angeben, erhält die nächste eingefügte Zeile den Wert 101. Wenn 101 jedoch bereits existiert, schlägt die Zeileneinfügung fehl.

Wenn kein Eigentümername angegeben wird oder dieser NULL ist, muss Tabellenname eine Tabelle in der Datenbank eindeutig identifizieren.

Die sa_reset_identity-Systemprozedur kann nicht auf eine Tabelle angewendet werden, die keine Spalten mit der Standardeinstellung AUTOINCREMENT oder GLOBAL AUTOINCREMENT aufweist.