IDENT_INCR (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseInstancia administrada de Azure SQLBase de datos SQL en Microsoft Fabric

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

El siguiente ejemplo devuelve el valor incremental de la Person.Address tabla en la base de datos AdventureWorks2025.

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

B. Devolver el valor de incremento de varias tablas

El siguiente ejemplo devuelve las tablas en la base de datos AdventureWorks2025 que incluyen 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)
COMPROBACIÓN DEL DBC (Transact-SQL)
sys.identity_columns (Transact-SQL)