IDENT_INCR (Transact-SQL)

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure

Restituisce il valore di incremento specificato durante la creazione di una colonna Identity in una tabella o una vista.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

IDENT_INCR ( 'table_or_view' )  

Argomenti

' table_or_view '
Espressione che specifica la tabella o la vista in cui si vuole verificare la presenza di un valore di incremento Identity valido. table_or_view può essere una costante stringa di caratteri racchiusa tra virgolette. Può anche essere una variabile, una funzione o un nome di colonna. table_or_view è di tipo char, nchar, varchar o nvarchar.

Tipi restituiti

numeric(@@MAXPRECISION,0))

Eccezioni

Restituisce NULL in caso di errore o se un chiamante non ha l'autorizzazione necessaria per visualizzare l'oggetto.

In SQL Server, un utente può visualizzare solo i metadati delle entità a protezione diretta di cui è proprietario o per cui dispone delle autorizzazioni. Se l'utente non ha le autorizzazioni necessarie per l'oggetto, le funzioni predefinite di creazione dei metadati come IDENT_INCR possono restituire NULL. Per altre informazioni, vedere Metadata Visibility Configuration.

Esempi

R. Restituzione del valore di incremento per una tabella specificata

Nell'esempio seguente viene restituito il valore di incremento per la Person.Address tabella nel database AdventureWorks2022.

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

B. Restituzione del valore di incremento da più tabelle

Nell'esempio seguente vengono restituite le tabelle nel database AdventureWorks2022 che include una colonna Identity con un valore di incremento.

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;  

Set di risultati parziale:

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

Vedi anche

Espressioni (Transact-SQL)
Funzioni di sistema (Transact-SQL)
IDENT_CURRENT (Transact-SQL)
IDENT_SEED (Transact-SQL)
DBCC CHECKIDENT (Transact-SQL)
sys.identity_columns (Transact-SQL)