IDENT_INCR (Transact-SQL)

  • Artikel

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance

Gibt den inkrementellen Wert zurück, der beim Erstellen einer Identitätsspalte in einer Tabelle oder Ansicht festgelegt wurde.

Transact-SQL-Syntaxkonventionen

Syntax

IDENT_INCR ( 'table_or_view' )

Argumente

' table_or_view '
Ein Ausdruck, der die Tabelle oder Sicht angibt, die auf einen gültigen inkrementellen Wert für die Identitätsspalte überprüft werden soll. table_or_view kann eine Zeichenfolgenkonstante in Anführungszeichen sein. Es kann auch eine Variable, eine Funktion oder ein Spaltenname sein. table_or_view ist vom Datentyp char, nchar, varchar oder nvarchar.

Rückgabetypen

numeric(@@MAXPRECISION,0))

Ausnahmen

Gibt NULL zurück, wenn ein Fehler auftritt oder ein Aufrufer nicht über die Berechtigungen zum Anzeigen des Objekts verfügt.

In SQL Server kann ein Benutzer nur die Metadaten von sicherungsfähigen Elementen anzeigen, die er besitzt oder für die er über Berechtigungen verfügt. Ohne Objektberechtigung des Benutzers kann eine Metadaten emittierende, eingebaute Funktion, wie z.B. IDENT_INCR, NULL zurückgeben. Weitere Informationen finden Sie unter Metadata Visibility Configuration.

Beispiele

A. Zurückgeben des inkrementellen Werts für eine angegebene Tabelle

Im folgenden Beispiel wird der inkrementelle Wert für die Tabelle Person.Address in der AdventureWorks2022-Datenbank zurückgegeben.

USE AdventureWorks2022;  
GO  
SELECT IDENT_INCR('Person.Address') AS Identity_Increment;  
GO

B. Zurückgeben des inkrementellen Werts aus mehreren Tabellen

Im folgenden Beispiel werden die Tabellen in der AdventureWorks2022-Datenbank zurückgegeben, die eine Identitätsspalte mit einem inkrementellen Wert enthalten.

USE AdventureWorks2022;  
GO  
SELECT TABLE_SCHEMA, TABLE_NAME,   
   IDENT_INCR(TABLE_SCHEMA + '.' + TABLE_NAME) AS IDENT_INCR  
FROM INFORMATION_SCHEMA.TABLES  
WHERE IDENT_INCR(TABLE_SCHEMA + '.' + TABLE_NAME) IS NOT NULL;

Dies ist ein Auszug aus dem Resultset.

TABLE_SCHEMA        TABLE_NAME                IDENT_INCR  
------------        ------------------------  ----------  
Person              Address                            1  
Production          ProductReview                      1  
Production          TransactionHistory                 1  
Person              AddressType                        1  
Production          ProductSubcategory                 1  
Person              vAdditionalContactInfo             1  
dbo                 AWBuildVersion                     1  
Production          BillOfMaterials                    1

Weitere Informationen

Ausdrücke (Transact-SQL)
Systemfunktionen (Transact-SQL)
IDENT_CURRENT (Transact-SQL)
IDENT_SEED (Transact-SQL)
DBCC CHECKIDENT (Transact-SQL)
sys.identity_columns (Transact-SQL)