Compartir a través de

  • Artículo

IDENT_INCR (Transact-SQL)

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 temasConvenciones 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, una variable, una 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 sólo puede ver los metadatos de asegurables 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 y Solucionar problemas 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 AdventureWorks;
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 AdventureWorks;
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 de resultados parciales.

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