IDENT_INCR (Transact-SQL)

Artigo
12/22/2023

Aplica-se a:SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

Retorna o valor de incremento especificado durante a criação de uma tabela ou coluna de identidade de exibição.

Sintaxe

IDENT_INCR ( 'table_or_view' )

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

'table_or_view'
É uma expression 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. Também pode ser uma variável, uma função ou um nome de coluna. table_or_view é char, nchar, varchar ou nvarchar.

Tipos de retorno

numeric(@@MAXPRECISION,0))

Exceções

Retornará 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 protegíveis que possuir ou para os quais tiver permissões. Sem uma função interna, permissão de objeto de usuário, emissão de metadados, como IDENT_INCR, pode retornar nulo. Para obter mais informações, consulte Metadata Visibility Configuration.

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 AdventureWorks2022.

USE AdventureWorks2022;  
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 AdventureWorks2022 que incluem uma coluna de identidade com um 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;

Este é um conjunto de resultados parcial.

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 Também

Expressões (Transact-SQL)
Funções de sistema (Transact-SQL)
IDENT_CURRENT (Transact-SQL)
IDENT_SEED (Transact-SQL)
DBCC CHECKIDENT (Transact-SQL)
sys.identity_columns (Transact-SQL)