IDENT_INCR (Transact-SQL)

Artículo
06/18/2013

Devuelve el valor del incremento (devuelto como numeric(**@@**MAXPRECISION,0)) especificado durante la creación de una columna de identidad en una tabla o vista que contiene una columna de identidad.

Icono de vínculo a temas 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, un nombre de variable, un nombre de función o un nombre de columna. table_or_view es de tipo char, nchar, varchar o nvarchar.

Tipos de valor devueltos

numeric

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 protegibles que posea o para los que se le haya concedido permiso. Esto significa que las funciones integradas de emisión de metadatos, como IDENT_INCR, pueden devolver NULL si el usuario no tiene ningún permiso para el objeto. Para obtener más información, vea Configuración de visibilidad de los metadatos.

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 AdventureWorks.

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

USE AdventureWorks2012;
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 AdventureWorks que contienen una columna de identidad con un valor de incremento.

USE AdventureWorks2012;
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;

USE AdventureWorks2012;
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