ALTER TABLE column_constraint (Transact-SQL)

文章
05/23/2023

適用於：SQL Server Azure SQL Database Azure SQL 受控執行個體

指定 PRIMARY KEY、FOREIGN KEY、UNIQUE 或 CHECK 條件約束的屬性，而這些條件約束是使用 ALTER TABLE 新增至資料表之新資料行定義的一部分。

注意

針對 Microsoft Fabric，請瀏覽 ALTER TABLE column_constraint ，然後選取您想要的產品版本。

Syntax

[ CONSTRAINT constraint_name ]   
{   
    [ NULL | NOT NULL ]   
    { PRIMARY KEY | UNIQUE }   
        [ CLUSTERED | NONCLUSTERED ]   
        [ WITH FILLFACTOR = fillfactor ]   
        [ WITH ( index_option [, ...n ] ) ]  
        [ ON { partition_scheme_name (partition_column_name)   
            | filegroup | "default" } ]   
    | [ FOREIGN KEY ]   
        REFERENCES [ schema_name . ] referenced_table_name   
            [ ( ref_column ) ]   
        [ ON DELETE { NO ACTION | CASCADE | SET NULL | SET DEFAULT } ]   
        [ ON UPDATE { NO ACTION | CASCADE | SET NULL | SET DEFAULT } ]   
        [ NOT FOR REPLICATION ]   
    | CHECK [ NOT FOR REPLICATION ] ( logical_expression )  
}

注意

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

引數

CONSTRAINT
指定開始定義 PRIMARY KEY、UNIQUE、FOREIGN KEY 或 CHECK 條件約束。

constraint_name
這是條件約束的名稱。條件約束名稱必須遵照識別碼的規則，不過，名稱開頭不能是數字符號 (#)。如果未提供 constraint_name，就會將系統產生的名稱指派給條件約束。

NULL | NOT NULL
指定資料行是否接受 Null 值。不允許 NULL 的資料行必須指定了預設值，才能夠加入。如果新資料行允許 Null 值，且未指定預設值，資料表每個資料列的新資料行都會包含 NULL。如果新資料行允許 Null 值，且加入了預設定義，就可以利用 WITH VALUE 選項，將預設值儲存在資料表每個現有資料列的新資料行中。

如果新資料行不允許 Null 值，就必須隨著新資料行加入 DEFAULT 定義。這個新資料行會在現有資料列的各個新資料行中，自動載入預設值。

當加入資料行需要實際變更資料表的資料列時，例如，在每個資料列中加入 DEFAULT 值，執行 ALTER TABLE 會保留資料表的鎖定。這會影響在鎖定就緒時，變更資料表內容的能力。相對地，加入允許 Null 值且未指定預設值的資料行，只是一項中繼資料作業，不含任何鎖定。

當您使用 CREATE TABLE 或 ALTER TABLE 時，資料庫和工作階段設定值會影響且可能會覆寫資料行定義所用之資料類型的 Null 屬性。我們建議您一律將非計算資料行明確定義為 NULL 或 NOT NULL，如果您採用使用者自訂資料類型，建議您允許資料行使用資料類型的預設 Null 屬性。如需詳細資訊，請參閱 CREATE TABLE (TRANSACT-SQL)。

PRIMARY KEY
這是一個條件約束，它會利用唯一索引來強制執行一個或多個指定之資料行的實體完整性。每份資料表都只能建立一個 PRIMARY KEY 條件約束。

UNIQUE
這是一個條件約束，它利用唯一索引來提供一個或多個指定之資料行的實體完整性。

CLUSTERED | NONCLUSTERED
指定建立 PRIMARY KEY 或 UNIQUE 條件約束的叢集或非叢集索引。 PRIMARY KEY 條件約束預設為 CLUSTERED。 UNIQUE 條件約束預設為 NONCLUSTERED。

如果叢集條件約束或索引已在資料表中，就無法指定 CLUSTERED。如果叢集條件約束或索引已在資料表中，PRIMARY KEY 條件約束便預設為 NONCLUSTERED。

屬於 ntext、text、varchar(max) 、nvarchar(max) 、varbinary(max) 、xml 或 image 資料類型的資料行無法指定為索引的資料行。

WITH FILLFACTOR =fillfactor
指定用來儲存索引資料的每個索引頁面，資料庫引擎所應加以填滿的程度。使用者指定的填滿因數可以是從 1 到 100 的值。如果未指定值，預設值為 0。

重要

為了與舊版相容，我們保持將 WITH FILLFACTOR = fillfactor 記載為適用於 PRIMARY KEY 或 UNIQUE 條件約束的唯一索引選項，但未來版本的文件不會再依照這個方式來說明。您可以在 ALTER TABLE 的 index_option 子句中，指定其他索引選項。

ON { partition_scheme_name(partition_column_name) | filegroup | "default" } 適用於：SQL Server 2008 (10.0.x) 和更新版本。

指定條件約束所建立之索引的儲存位置。如果指定 partition_scheme_name，索引就會進行資料分割，這些資料分割會對應於 partition_scheme_name 所指定的檔案群組。如果指定了 filegroup，就會在具名檔案群組中建立索引。如果指定了 "default"，或完全未指定 ON，就會在與資料表相同的檔案群組中建立索引。如果加入 PRIMARY KEY 或 UNIQUE 條件約束的叢集索引時指定了 ON，則建立叢集索引時，會將整份資料表移到指定的檔案群組中。

在這個內容中，default 不是關鍵字。它是預設檔案群組的識別碼，必須加以分隔，如 ON "default" 或 ON [default]。如果指定了 "default"，則目前工作階段的 QUOTED_IDENTIFIER 選項就必須是 ON。這是預設值。如需詳細資訊，請參閱 SET QUOTED_IDENTIFIER (Transact-SQL)。

FOREIGN KEY REFERENCES
這是一個條件約束，它提供資料行中之資料的參考完整性。 FOREIGN KEY 條件約束要求資料行中的每個值存在於所參考之資料表的指定資料行中。

schema_name
這是 FOREIGN KEY 條件約束參考之資料表所屬的結構描述名稱。

referenced_table_name
這是 FOREIGN KEY 條件約束所參考的資料表。

ref_column
這是新 FOREIGN KEY 條件約束所參考的資料行，用括號括住。

ON DELETE { NO ACTION | CASCADE | SET NULL | SET DEFAULT }
指定如果變更的資料表中之資料列有參考關聯性，且在父資料表中刪除了所參考的資料列，變更的資料表中之資料列會發生什麼動作。預設值是 NO ACTION。

NO ACTION
SQL Server 資料庫引擎會產生一則錯誤，且會復原父資料表中資料列的刪除動作。

CASCADE
如果從父資料表中刪除資料列，便會從進行參考的資料表中刪除對應的資料列。

SET NULL
當刪除父資料表中對應的資料列時，所有組成外部索引鍵的值都會設為 NULL。若要執行這個條件約束，外部索引鍵資料行必須可為 Null。

SET DEFAULT
當刪除父資料表中對應的資料列時，所有組成外部索引鍵的值都會設為預設值。若要執行這個條件約束，所有外部索引鍵資料行都必須有預設定義。如果有可為 Null 的資料行，但沒有設定明確的預設值，NULL 便成為這個資料行的隱含預設值。

如果資料表要包含在使用邏輯記錄的合併式發行集中，請勿指定 CASCADE。如需邏輯記錄的詳細資訊，請參閱使用邏輯記錄分組相關資料列的變更。

如果變更的資料表已有 INSTEAD OF 觸發程序 ON DELETE，便無法定義 ON DELETE CASCADE。

例如在 AdventureWorks2022 資料庫中，ProductVendor 資料表與 Vendor 資料表有參考關聯性。 ProductVendor.VendorID 外部索引鍵會參考 Vendor.VendorID 主索引鍵。

如果在 Vendor 資料表的某資料列上執行 DELETE 陳述式，且指定了 ProductVendor.VendorID 的 ON DELETE CASCADE 動作，資料庫引擎便會檢查 ProductVendor 資料表中一或多個相依的資料列。如果有任何相依的資料列存在，除了會將 Vendor 資料表中所參考的資料列刪除，還會刪除 ProductVendor 資料表中的相依資料列。

相反地，如果指定了 NO ACTION，當 ProductVendor 資料表中至少有一個資料列參考 Vendor 資料列時，資料庫引擎便會產生一則錯誤，並且會復原該資料列的刪除動作。

ON UPDATE { NO ACTION | CASCADE | SET NULL | SET DEFAULT }
指定當變更的資料表中之資料列有參考關聯性，且在父資料表中所參考的資料列有了更新時，變更的資料表中之資料列會發生什麼動作。預設值是 NO ACTION。

NO ACTION
資料庫引擎會產生一則錯誤，且會復原父資料表中資料列的更新動作。

CASCADE
當父資料表中的資料列有了更新時，在進行參考的資料表中，也會更新對應的資料列。

SET NULL
當更新父資料表中對應的資料列時，所有組成外部索引鍵的值都會設為 NULL。若要執行這個條件約束，外部索引鍵資料行必須可為 Null。

SET DEFAULT
當更新父資料表中對應的資料列時，所有組成外部索引鍵的值都會設為預設值。若要執行這個條件約束，所有外部索引鍵資料行都必須有預設定義。如果有可為 Null 的資料行，但沒有設定明確的預設值，NULL 便成為這個資料行的隱含預設值。

如果資料表要包含在使用邏輯記錄的合併式發行集中，請勿指定 CASCADE。如需邏輯記錄的詳細資訊，請參閱使用邏輯記錄分組相關資料列的變更。

如果在 INSTEAD OF 觸發程序 ON UPDATE 已經存在已警示的資料表，則無法定義ON UPDATE CASCADE、SET NULL、或 SET DEFAULT。

如果在 Vendor 資料表的某資料列上執行 UPDATE 陳述式，且指定了 ProductVendor.VendorID 的 ON UPDATE CASCADE 動作，資料庫引擎便會檢查 ProductVendor 資料表中一或多個相依的資料列。如果有任何相依的資料列存在，除了 Vendor 資料表中所參考的資料列，還會更新 ProductVendor 資料表中的相依資料列。

相反地，如果指定了 NO ACTION，當 ProductVendor 資料表中有至少一個資料列參考 Vendor 資料列時，資料庫引擎會產生一則錯誤，並且會復原 Vendor 資料列的更新動作。

NOT FOR REPLICATION
適用於：SQL Server 2008 (10.0.x) 和更新版本。

可以指定給 FOREIGN KEY 條件約束和 CHECK 條件約束。如果條件約束指定了這個子句，當複寫代理程式執行插入、更新或刪除作業時，不會強制執行這個條件約束。

CHECK
這是一個條件約束，藉由限制可能輸入一個或多個資料行的值，強制執行範圍完整性。

logical_expression
CHECK 條件約束所使用的邏輯運算式，會傳回 TRUE 或 FALSE。搭配 CHECK 條件約束使用的 logical_expression 無法參考其他資料表，但可以參考相同資料列所在之資料表的其他資料行。這個運算式不能參考別名資料類型。

備註

加入 FOREIGN KEY 或 CHECK 條件約束時，除非指定 WITH NOCHECK 選項，否則將會驗證所有現有資料的強制違規。如果有任何違規，ALTER TABLE 便會失敗，且會傳回錯誤。當現有資料行中加入了新的 PRIMARY KEY 或 UNIQUE 條件約束時，資料行中的資料便必須是唯一的。如果找到重複的值，ALTER TABLE 便會失敗。當加入 PRIMARY KEY 或 UNIQUE 條件約束時，WITH NOCHECK 選項沒有作用。

每個 PRIMARY KEY 和 UNIQUE 條件約束都會產生一個索引。 UNIQUE 和 PRIMARY KEY 條件約束數目無法使資料表的索引數目超出 999 個非叢集索引和 1 個叢集索引。外部索引鍵條件約束不會自動產生索引。但外部索引鍵資料行常會用於查詢的聯結準則，方法是將資料表的外部索引鍵條件約束與其他資料表的主要或唯一索引鍵資料行進行比對。外部索引鍵資料行的索引可讓資料庫引擎快速從外部索引鍵資料表中尋找相關資料。

範例

如需範例，請參閱 ALTER TABLE (Transact-SQL)。

另請參閱

ALTER TABLE (Transact-SQL)
column_definition (Transact-SQL)

適用於：Microsoft Fabric 中的 Warehouse

指定在 Microsoft Fabric 中使用 ALTER TABLE 新增至數據表之 PRIMARY KEY、UNIQUE、FOREIGN KEY、CHECK 條件約束或 DEFAULT 定義的屬性。

注意

針對 SQL Server 和 Azure SQL 平臺，請瀏覽 ALTER TABLE column_constraint ，然後選取您想要的產品版本。

Transact-SQL 語法慣例

語法

[ CONSTRAINT constraint_name ]  
{  
    { PRIMARY KEY | UNIQUE }  
       NONCLUSTERED    
        (column [ ASC | DESC ] [ ,...n ] )  
NOT ENFORCED
    | FOREIGN KEY  
        ( column [ ,...n ] )  
        REFERENCES referenced_table_name [ ( ref_column [ ,...n ] ) ]  
NOT ENFORCED
}

引數

CONSTRAINT

指定 PRIMARY KEY、UNIQUE 或 FOREIGN KEY 的定義開頭。

constraint_name
這是條件約束的名稱。條件約束名稱必須遵照識別碼的規則，不過，名稱開頭不能是數字符號 (#)。如果未提供 constraint_name，就會將系統產生的名稱指派給條件約束。

PRIMARY KEY

用戶必須手動確保指定數據行的實體完整性是唯一的，以避免不正確的查詢結果。每份資料表都只能建立一個 PRIMARY KEY 條件約束。

UNIQUE

用戶必須手動確保指定數據行的實體完整性是唯一的，以避免不正確的查詢結果。

NONCLUSTERED

移轉語法相容性的必要專案，但在倉儲中沒有作用。

column
這是新條件約束中所用的一個資料行或一份資料行清單 (用括號括住來指定)。

[ ASC | DESC ]
指定一個或多個資料行參與資料表條件約束的排序順序。預設值是 ASC。

未強制執行

在 Microsoft Fabric 中，主鍵、唯一索引鍵和外鍵條件約束需要 NOT ENFORCED。應用程式必須維護條件約束的完整性。

FOREIGN KEY REFERENCES

用戶必須手動確保FOREIGN KEY條件約束在數據行中都有每個值，也存在於參考數據表的指定數據行中，以避免不正確的查詢結果。