IDENT_INCR (Transact-SQL)

Artigo
03/07/2014

Retorna o valor de incremento (retornado como numeric (**@@**MAXPRECISION,0)) especificado durante a criação de uma coluna de identidade em uma tabela ou exibição que tem uma coluna de identidade.

Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de dados SQL do Windows Azure (versão inicial até a versão atual).

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

IDENT_INCR ( 'table_or_view' )

Argumentos

' table_or_view '
É uma expressão que especifica a tabela ou exibição em que um valor de incremento de identidade válido é verificado. table_or_view pode ser uma constante de cadeia de caracteres incluída entre aspas, uma variável, uma função ou um nome de coluna. table_or_view é char, nchar, varchar ou nvarchar.

Tipos de retorno

numeric

Exceções

Retorna NULL em caso de erro ou se um chamador não tiver permissão para exibir o objeto.

No SQL Server, um usuário só pode exibir os metadados de itens protegíveis de sua propriedade ou para os quais ele tenha permissão concedida. Isso significa que as funções internas emissoras de metadados, como IDENT_INCR, podem retornar NULL se o usuário não tiver permissão no objeto. Para obter mais informações, consulte Configuração de visibilidade de metadados.

Exemplos

A.Retornando o valor de incremento de uma tabela especificada

O exemplo a seguir retorna o valor de incremento para a tabela Person.Address no banco de dados AdventureWorks2012.

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

B.Retornando o valor de incremento de várias tabelas

O exemplo a seguir retorna as tabelas no banco de dados AdventureWorks2012 que incluem uma coluna de identidade com um 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;

Veja um 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