啟用異動資料擷取

針對資料庫啟用異動資料擷取

針對個別資料表建立擷取執行個體之前，sysadmin 固定伺服器角色的成員必須先啟用異動資料擷取的資料庫。這項步驟可透過在資料庫內容中執行 sys.sp_cdc_enable_db (Transact-SQL) 預存程序完成。若要判斷資料庫是否已經啟用，請查詢 sys.databases 目錄檢視中的 is_cdc_enabled 資料行。

啟用異動資料擷取的資料庫時，也會針對資料庫建立 cdc 結構描述、cdc 使用者、中繼資料表，以及其他系統物件。cdc 結構描述包含異動資料擷取中繼資料表，以及啟用異動資料擷取的來源資料表後，當做變更資料儲存機制使用的個別變更資料表。cdc 結構描述也包含用來查詢變更資料的相關聯系統函數。

異動資料擷取需要獨佔使用 cdc 結構描述與 cdc 使用者。如果名稱為 cdc 的結構描述或資料庫使用者目前存在於資料庫中，就無法啟用異動資料擷取的資料庫，直到卸除或重新命名結構描述和 (或) 使用者為止。

如需啟用資料庫的範例，請參閱「啟用異動資料擷取的資料庫」範本。

重要事項
若要在 SQL Server Management Studio 中找出範本，請移至 [檢視]、按一下 [範本總管]，然後選取 [SQL Server 範本]。[異動資料擷取] 是子資料夾。在這個資料夾底下，您將會找到這個主題所參考的所有範本。SQL Server Management Studio 工具列上也有一個 [範本總管] 圖示。

-- ================================

-- Enable Database for CDC 範本

-- ================================

USE MyDB
GO

EXEC sys.sp_cdc_enable_db
GO

針對資料表啟用異動資料擷取

啟用異動資料擷取的資料庫之後，db_owner 固定資料庫角色的成員就可以使用 sys.sp_cdc_enable_table 預存程序，針對個別的來源資料表建立擷取執行個體。若要判斷是否已經啟用異動資料擷取的來源資料表，請檢查 sys.tables 目錄檢視中的 is_tracked_by_cdc 資料行。

您可以在建立擷取執行個體時指定下列選項：

Columns in the source table to be captured.

根據預設，系統會將來源資料表中的所有資料行識別為擷取資料行。如果只需要追蹤資料行的子集 (例如，基於隱私或效能的原因)，請使用 @captured\_column\_list 參數來指定資料行的子集。

A filegroup to contain the change table.

根據預設，變更資料表位於資料庫的預設檔案群組中。想要控制個別變更資料表位置的資料庫擁有者可以使用 @filegroup\_name 參數，指定與擷取執行個體相關聯之變更資料表的特定檔案群組。此指定的檔案群組必須已存在。一般而言，我們建議您將變更資料表放在與來源資料表不同的檔案群組中。如需示範 @filegroup\_name 參數使用方式的範例，請參閱「Enable a Table Specifying Filegroup Option」範本。

===================================================

-- Enable a Table Specifying Filegroup Option 範本

-- ===================================================

USE MyDB
GO

EXEC sys.sp_cdc_enable_table
@source_schema = N'dbo',
@source_name   = N'MyTable',
@role_name     = N'MyRole',
@filegroup_name = N'MyDB_CT',
@supports_net_changes = 1
GO

A role for controlling access to a change table.

指定角色的目的是要控制變更資料的存取權。指定的角色可以是現有的固定伺服器角色或資料庫角色。如果指定的角色不存在，則會自動建立該名稱的資料庫角色。sysadmin 或 db_owner 角色的成員對於變更資料表中的資料擁有完整存取權。其他所有使用者對於來源資料表的所有擷取資料行必須具備 SELECT 權限。此外，指定角色時，不是 sysadmin 或 db_owner 角色之成員的使用者也必須是指定之角色的成員。

如果您不想要使用控制角色，請將 @role\_name 參數明確設定為 NULL。如需在不使用控制角色的情況下啟用資料表的範例，請參閱「Enable a Table Without Using a Gating Role」範本。

-- ===================================================

-- Enable a Table Without Using a Gating Role 範本

-- ===================================================

USE MyDB
GO

EXEC sys.sp_cdc_enable_table
@source_schema = N'dbo',
@source_name   = N'MyTable>',
@role_name     = NULL,
@supports_net_changes = 1
GO

A function to query for net changes.

擷取執行個體一定會包含資料表值函數，以便傳回在定義間隔內發生的所有變更資料表項目。這個函數的命名方式是將擷取執行個體名稱附加至 "cdc.fn_cdc_get_all_changes_"。如需詳細資訊，請參閱＜cdc.fn_cdc_get_all_changes_<capture_instance> (Transact-SQL)＞。

如果 @supports\_net\_changes 參數設定為 1，也會針對擷取執行個體產生淨變更函數。此函數僅會針對在呼叫中指定之間隔內變更的每個不同資料列，傳回一個變更。如需詳細資訊，請參閱＜cdc.fn_cdc_get_net_changes_<capture_instance> (Transact-SQL)＞。

若要支援淨變更查詢，來源資料表必須具有主索引鍵或唯一的索引才能唯一識別資料列。如果使用了唯一的索引，就必須使用 @index\_name 參數來指定該索引的名稱。在主索引鍵或唯一索引中定義的資料行必須包含在要擷取之來源資料行的清單中。

如需示範建立含有兩個查詢函數之擷取執行個體的範例，請參閱「Enable a Table for All and Net Changes Queries」範本。

=======================================================

-- Enable a Table for All and Net Changes Queries 範本

-- =======================================================

USE MyDB
GO

EXEC sys.sp_cdc_enable_table
@source_schema = N'dbo',
@source_name   = N'MyTable',
@role_name     = N'MyRole',
@supports_net_changes = 1
GO