IDENT_INCR (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Devolve o valor de incremento especificado ao criar a coluna de identidade de uma tabela ou vista.

Transact-SQL convenções de sintaxe

Sintaxe

IDENT_INCR ( 'table_or_view' )  

Arguments

'table_or_view'
É uma expressão que especifica a tabela ou vista para verificar um valor de incremento de identidade válido. table_or_view pode ser uma constante de caracteres entre aspas. Pode também ser uma variável, uma função ou o nome de uma coluna. table_or_view é char, nchar, varchar ou nvarchar.

Tipos de devolução

numérico(@@MAXPRECISION,0))

Exceptions

Retorna NULL em caso de erro ou se o chamador não tiver permissão de visualização de objetos.

No SQL Server, um utilizador só pode visualizar os metadados dos securáveis que possui ou para os quais tem permissões. Sem permissão de objeto de utilizador, uma função incorporada que emite metadados, como IDENT_INCR, pode devolver NULL. Para obter mais informações, consulte Configuração de visibilidade de metadados.

Examples

A. Devolver o valor de incremento para uma tabela especificada

O exemplo seguinte devolve o valor de incremento para a Person.Address tabela na base de dados AdventureWorks2025.

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

B. Devolvendo o valor de incremento de múltiplas tabelas

O exemplo seguinte devolve as tabelas na base de dados AdventureWorks2025 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;  

Aqui está 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

Ver também

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