IDENT_INCR (Transact-SQL)

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

La IDENT_INCR función del sistema devuelve el valor de incremento especificado al crear la columna identidad de una tabla o vista.

Convenciones de sintaxis de Transact-SQL

Sintaxis

IDENT_INCR ( 'table_or_view' )

Argumentos

table_or_view

Una expresión que especifica la tabla o vista para comprobar si hay 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 retorno

numeric(@@MAXPRECISION,0))

Excepciones

Retorna NULL en caso de error o si un llamante no tiene permiso de vista de objetos.

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

Remarks

La IDENT_INCR función no está disponible para las columnas identidad en Fabric Data Warehouse.

Ejemplos

A. Devuelve el valor de incremento para 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. Devuelve el valor incremental 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