sa_reset_identity-Systemprozedur

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

Syntax

sa_reset_identity( 
tbl_name, 
owner_name, 
new_identity 
)

Argumente

tbl_name 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 tbl_name eine Tabelle in der Datenbank eindeutig identifizieren.
owner_name Verwenden Sie diesen CHAR(128)-Parameter, um den Eigentümer der Tabelle anzugeben, bei der Sie den ID-Wert zurücksetzen wollen. Wenn owner_name nicht definiert oder NULL ist, muss das dritte Argument angegeben werden. Beispiel: CALL sa_reset_identity ( 'Employees', new_identity = 100 );
new_identity 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 new_identity + 1.

Es wird nicht überprüft, ob new_identity + 1 mit einer bestehenden Zeile in der Tabelle in Konflikt steht. Wenn Sie zum Beispiel für new_identity 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.

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