IDENT_INCR (Transact-SQL)IDENT_INCR (Transact-SQL)

SE APLICA A: síSQL Server síAzure SQL Database noAzure Synapse Analytics (SQL DW) noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Devuelve el valor de incremento especificado al crear la columna de identidad de una tabla o una vista.Returns the increment value specified when creating a table or view's identity column.

Icono de vínculo de artículo Convenciones de sintaxis de Transact-SQLArticle link icon Transact-SQL Syntax Conventions

SintaxisSyntax

IDENT_INCR ( 'table_or_view' )  

ArgumentosArguments

' table_or_view '' 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.Is an expression specifying the table or view to check for a valid identity increment value. table_or_view puede ser una constante de cadena de caracteres entre comillas.table_or_view can be a character string constant enclosed in quotation marks. También puede ser una variable, una función o un nombre de columna.It can also be a variable, a function, or a column name. table_or_view es char, nchar, varchar o nvarchar.table_or_view is char, nchar, varchar, or nvarchar.

Tipos devueltosReturn Types

numeric(@@MAXPRECISION,0))numeric(@@MAXPRECISION,0))

ExcepcionesExceptions

Devuelve NULL si se produce un error o si el autor de la llamada no tiene permiso para ver el objeto.Returns NULL on error or if a caller doesn't have object view permission.

En SQL ServerSQL Server, un usuario solo puede ver los metadatos de elementos de los que sea propietario o para los que tenga permisos.In SQL ServerSQL Server, a user can only view the metadata of securables they own or have permissions for. Sin el permiso del objeto de usuario, una función de emisión de metadatos integrada, como IDENT_INCR, puede devolver NULL.Without user object permission, a metadata-emitting, built-in function, such as IDENT_INCR, may return NULL. Para obtener más información, consulte Metadata Visibility Configuration.For more information, see Metadata Visibility Configuration.

EjemplosExamples

A.A. Devolver el valor de incremento de una tabla especificadaReturning the increment value for a specified table

En el ejemplo siguiente se devuelve el valor de incremento de la tabla Person.Address en la base de datos AdventureWorks2012AdventureWorks2012.The following example returns the increment value for the Person.Address table in the AdventureWorks2012AdventureWorks2012 database.

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

B.B. Devolver el valor de incremento de varias tablasReturning the increment value from multiple tables

En el siguiente ejemplo se devuelven las tablas de la base de datos AdventureWorks2012AdventureWorks2012 que incluye una columna de identidad con un valor de incremento.The following example returns the tables in the AdventureWorks2012AdventureWorks2012 database that includes an identity column with an increment value.

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.Here is a partial result set.

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énSee Also

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