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.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

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