IDENTITY (函數) (Transact-SQL)

  • 發行項

適用於：SQL ServerAzure SQL 受控執行個體

為僅供設定 INTO table 子句的 SELECT 陳述式，用來將識別欄位插入新資料表。 雖然相似，但 IDENTITY 函數不是搭配 CREATE TABLE 和 ALTER TABLE 使用的 IDENTITY 屬性。

注意

若要建立可用於多個資料表中或可在不參考任何資料表的情況下從應用程式進行呼叫的自動遞增數字，請參閱 序號。

Transact-SQL 語法慣例

Syntax

IDENTITY (data_type [ , seed , increment ] ) AS column_name

注意

若要檢視 SQL Server 2014 （12.x） 和舊版的 Transact-SQL 語法，請參閱 舊版檔。

引數

data_type
這是識別欄位的資料類型。 識別欄位的有效資料類型是整數資料類型類別目錄的任何資料類型，但 bit 資料類型或 decimal 資料類型除外。

seed
這是要指派給資料表中第一個資料列的整數值。 每個後續的資料列都會被指派下一個識別值，也就是最後一個 IDENTITY 值加上 increment 值。 如果既未指定 seed，也未指定 increment，則兩者都會預設為 1。

increment
這是要新增至資料表中後續資料列之 seed 值的整數值。

column_name
這是要插入新資料表之資料行的名稱。

傳回型別

傳回與 data_type 相同的值。

備註

由於這個函數會在資料表中建立一個資料行，因此，您必須依照下列方式之一，在選取清單中指定一個資料行名稱：

--(1)  
SELECT IDENTITY(int, 1,1) AS ID_Num  
INTO NewTable  
FROM OldTable;  
  
--(2)  
SELECT ID_Num = IDENTITY(int, 1, 1)  
INTO NewTable  
FROM OldTable;

範例

下列範例會將 AdventureWorks2022database 數據表中的所有數據列 Contact 插入名為 NewContact的新數據表中。 這個 IDENTITY 函數在 NewContact 資料表中，使識別碼從 100 開始，而不是從 1 開始。

USE AdventureWorks2022;  
GO  
IF OBJECT_ID (N'Person.NewContact', N'U') IS NOT NULL  
    DROP TABLE Person.NewContact;  
GO  
ALTER DATABASE AdventureWorks2022 SET RECOVERY BULK_LOGGED;  
GO  
SELECT  IDENTITY(smallint, 100, 1) AS ContactNum,  
        FirstName AS First,  
        LastName AS Last  
INTO Person.NewContact  
FROM Person.Person;  
GO  
ALTER DATABASE AdventureWorks2022 SET RECOVERY FULL;  
GO  
SELECT ContactNum, First, Last FROM Person.NewContact;  
GO

另請參閱

CREATE TABLE (Transact-SQL)
@@IDENTITY (Transact-SQL)
IDENTITY (屬性) (Transact-SQL)
SELECT @local_variable (Transact-SQL)
DBCC CHECKIDENT (Transact-SQL)
sys.identity_columns (Transact-SQL)