IDENT_INCR (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureBanco de dados SQL no Microsoft Fabric

A IDENT_INCR função do sistema retorna o valor de incremento especificado ao criar a coluna de identidade de uma tabela ou visão.

Convenções de sintaxe de Transact-SQL

Sintaxe

IDENT_INCR ( 'table_or_view' )

Argumentos

table_or_view

Uma expressão que especifica a tabela ou visão para verificar um valor de incremento de identidade válido. 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

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

No SQL Server, um usuário só pode exibir os metadados de protegíveis que possuir ou para os quais tiver permissões. Sem permissão de objeto usuário, uma função embutida que emite metadados, como IDENT_INCR, pode retornar NULL. Para obter mais informações, consulte Metadata Visibility Configuration.

Remarks

A IDENT_INCR função não está disponível para colunas de identidade em Fabric Data Warehouse.

Exemplos

a. Devolva o valor de incremento para uma tabela especificada

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

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

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

O exemplo a seguir retorna as tabelas no banco 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;

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

Conteúdo relacionado

  • Last updated on