IDENT_INCR (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzSQL-Datenbank in Microsoft Fabric

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

Das folgende Beispiel gibt den Inkrementwert für die Person.Address Tabelle in der AdventureWorks2025-Datenbank zurück.

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

B. Zurückgeben des inkrementellen Werts aus mehreren Tabellen

Das folgende Beispiel liefert die Tabellen in der AdventureWorks2025-Datenbank, die eine Identitätsspalte mit einem Inkrementwert enthält.

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)