IDENT_INCR (Transact-SQL)

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance

Devuelve el valor de incremento especificado al crear la columna de identidad de una tabla o una vista.

Convenciones de sintaxis de Transact-SQL

Sintaxis

IDENT_INCR ( 'table_or_view' )  

Argumentos

' table_or_view '
Se trata de una expresión que especifica la tabla o vista en la que se va a comprobar un valor de incremento de identidad válido. table_or_view puede ser una constante de cadena de caracteres entre comillas. También puede ser una variable, una función o un nombre de columna. table_or_view es char, nchar, varchar o nvarchar.

Tipos de valor devuelto

numeric(@@MAXPRECISION,0))

Excepciones

Devuelve NULL si se produce un error o si el autor de la llamada no tiene permiso para ver el objeto.

En SQL Server, un usuario solo puede ver los metadatos de elementos de los que sea propietario o para los que tenga permisos. Sin el permiso del objeto de usuario, una función de emisión de metadatos integrada, como IDENT_INCR, puede devolver NULL. Para obtener más información, consulte Metadata Visibility Configuration.

Ejemplos

A. Devolver el valor de incremento de una tabla especificada

En el ejemplo siguiente se devuelve el valor de incremento de la tabla Person.Address en la base de datos AdventureWorks2022.

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

B. Devolver el valor de incremento de varias tablas

En el siguiente ejemplo se devuelven las tablas de la base de datos AdventureWorks2022 que incluye una columna de identidad con un valor de 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;  

A continuación se muestra un conjunto parcial de resultados.

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

Consulte también

Expresiones (Transact-SQL)
Funciones del sistema (Transact-SQL)
IDENT_CURRENT (Transact-SQL)
IDENT_SEED (Transact-SQL)
DBCC CHECKIDENT (Transact-SQL)
sys.identity_columns (Transact-SQL)