IDENT_INCR (Transact-SQL)
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.
Sintaxe
IDENT_INCR ( 'table_or_view' )
Argumentos
- 'table_or_view'
É uma expressão especificando a tabela ou exibição a ser verificada quanto a um valor de incremento de identidade válido. 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 e Solucionando problemas de visibilidade de metadados..
Exemplos
A. Retornando o valor de incremento para uma tabela especificada
O exemplo a seguir retorna o valor de incremento para a tabela Person.Address no banco de dados AdventureWorks.
USE AdventureWorks;
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 AdventureWorks que incluem uma coluna de identidade com um 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;
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