使用變更資料

變更資料最直接的要求就是在擷取執行個體的有效性間隔中傳回所有目前的變更資料。若要提出這項要求，請先判斷有效性間隔的 LSN 下限與上限。然後，請使用這些值來識別傳遞給 cdc.fn_cdc_get_all_changes_<capture_instance> 或 cdc.fn_cdc_get_net_changes_<capture_instance> 查詢函數的 @from\_lsn 和 @to\_lsn 參數。您可以使用 sys.fn_cdc_get_min_lsn 函數來取得下限，而使用 sys.fn_cdc_get_max_lsn 函數來取得上限。如需使用 cdc.fn_cdc_get_all_changes_<capture_instance> 查詢函數來查詢所有目前有效變更的範例程式碼，請參閱「列舉有效範圍的所有變更」範本。如需使用 cdc.fn_cdc_get_net_changes_<capture_instance> 函數的類似範例，請參閱「列舉有效範圍的淨變更」範本。

對於一般應用程式而言，查詢變更資料是持續進行的程序，並且針對自從上一個要求以來發生的所有變更提出定期要求。您可以針對這類查詢使用 sys.fn_cdc_increment_lsn 函數，以便從上一個查詢的上限衍生出目前查詢的下限。這個方法可確保不會重複任何資料列，因為查詢間隔永遠會被視為封閉的間隔，其中兩個端點都包含在間隔中。然後，您可以使用 sys.fn_cdc_get_max_lsn 函數來取得新要求間隔的高端點。如需有系統地移動查詢視窗來取得自從上一個要求以來之所有變更的範例程式碼，請參閱「列舉自從上一個要求以來的所有變更」範本。

針對查詢函數所傳回之變更放置的一般條件約束是僅包含上一個要求到目前日期和時間之間發生的變更。若為這種查詢，您可以將 sys.fn_cdc_increment_lsn 函數套用至上一個要求所使用的 @from\_lsn 值，以便判斷下限。由於時間間隔的上限會表示成特定時間點，所以它必須轉換成 LSN 值，然後才能讓查詢函數使用。您必須確定擷取處理序已經處理透過指定之上限所認可的所有變更，然後此日期時間值才能轉換成對應的 LSN 值。這是確保所有合格變更都已經傳播至變更資料表的必要作業。進行此作業的其中一種方式為建構定期檢查的等候迴圈，以便查看針對任何資料庫變更資料表所記錄的目前最大認可 LSN 是否超過要求間隔的所需結束時間。

在延遲迴圈確認擷取處理序已經處理所有相關的記錄項目之後，請使用 sys.fn_cdc_map_time_to_lsn 函數來判斷表示成 LSN 值的新高端點。若要確定已擷取透過指定之時間認可的所有項目，請呼叫 sys.fn_cdc_map_time_to_lsn 函數並使用 'largest less than or equal' 選項。

「列舉至今為止的所有變更」範本將示範如何使用先前的策略來查詢變更資料。

在資料庫變更資料表中具有相關聯項目之每筆交易的認可時間都提供在 cdc.lsn_time_mapping 資料表中。您可以透過聯結傳入所有變更之要求中的 __$start_lsn 值與 cdc.lsn_time_mapping 資料表項目的 start_lsn 值，傳回 tran_end_time 以及變更資料，以便使用位於來源之交易的認可時間為變更加上戳記。「將認可時間附加至所有變更結果集」範本將示範如何執行這項聯結。

有時候，在來源認可交易時，聯結變更資料與其他所蒐集的交易相關資訊會很有用。cdc.lsn_time_mapping 資料表中的 tran_begin_lsn 資料行會提供執行這類聯結所需的資訊。進行來源的更新時，來自 sys.dm_tran_database_transactions 系統動態檢視的 database_transaction_begin_lsn 值必須和要與變更資料聯結的任何其他資訊一起儲存。您可以使用 fn_convertnumericlsntobinary 函數來比較 database_transaction_begin_lsn 與 tran_begin_lsn 值。「建立函數 fn_convertnumericlsntobinary」範本會提供要建立此函數的程式碼。「使用給定的 tran_begin_lsn 來傳回所有變更」範本將示範如何完成此聯結。

查詢變更資料的一般應用程式狀況是使用以日期時間值所限定的滑動視窗來定期要求變更資料。若為這種取用者類別，異動資料擷取會提供 sys.sp_cdc_generate_wrapper_function 預存程序，以便產生指令碼來建立異動資料擷取查詢函數的自訂包裝函式。這些自訂包裝函式可讓查詢間隔表示成日期時間組。

此預存程序的呼叫選項可讓您針對呼叫者可存取的所有擷取執行個體或只針對指定的擷取執行個體產生包裝函式。支援的選項還包括能夠指定擷取間隔的高端點應該開啟或關閉、哪些可用的擷取資料行應該包含在結果集中，以及哪些包含資料行應該具有相關聯的更新旗標。此程序會傳回含有兩個資料行的結果集：產生的函數名稱 (可從擷取執行個體名稱衍生出) 和包裝函式預存程序的建立陳述式。系統一定會產生可包裝所有變更查詢的函數。如果建立擷取執行個體時設定了 @supports\_net\_changes 參數，也會產生可包裝淨變更函數的函數。

應用程式設計工具必須負責呼叫指令碼產生預存程序來產生包裝函式預存程序的建立陳述式，以及執行產生的建立指令碼來建立這些函數。這項作業不會在建立擷取執行個體時自動進行。

日期時間包裝函式是由使用者所擁有，並非建立在呼叫者的預設結構描述中。產生的函數不需要修改就可適用於大部分使用者。不過，建立此函數之前，您隨時都可以將進一步的自訂套用至產生的指令碼。

包裝所有變更查詢之函數的名稱是 fn_all_changes_ 後面接著擷取執行個體名稱。用於淨變更包裝函式的前置詞為 fn_net_changes_。這兩個函數都會接受三個引數，就如同其相關聯的異動資料擷取 TVF 一樣。不過，這些包裝函式的查詢間隔是以兩個日期時間值 (而非兩個 LSN 值) 所限定。這兩組函數的 @row\_filter\_option 參數都相同。

產生的包裝函式支援下列有系統地查核異動資料擷取時間表的慣例：先前間隔的 @end\_time 參數應該要當做後續間隔的 @start\_time 參數使用。此包裝函式會負責將日期時間值對應至 LSN 值，並且確保遵循此慣例時，不會遺漏或重複任何資料。

您可以產生包裝函式來支援指定之查詢視窗上的封閉上限或開放上限。也就是說，呼叫者可以指定具有認可時間的項目是否等於要包含在間隔內之擷取間隔的上限。預設會包含上限。

當產生的查詢 TVF 失敗時，如果針對 @from\_lsn 值或 @to\_lsn 值提供了 Null 值，日期時間包裝函式就會使用 Null 來允許日期時間包裝函式傳回所有目前的變更。也就是說，如果 Null 當做查詢視窗的低端點傳遞至日期時間包裝函式，擷取執行個體有效性間隔的低端點就會用於套用至查詢 TVF 的基礎 SELECT 陳述式中。同樣地，如果 Null 當做查詢視窗的高端點傳遞，擷取執行個體有效性間隔的高端點就會在從查詢 TVF 中選取時使用。

包裝函式所傳回的結果集包括所有要求的資料行，後面接著作業資料行，而此資料行會記錄成一或兩個字元，以便識別與資料列相關聯的作業。如果已經要求更新旗標，它們就會按照 @update\_flag\_list 參數中指定的順序，在作業碼之後顯示成位元資料行。如需有關自訂產生之日期時間包裝函式的呼叫選項的詳細資訊，請參閱＜sys.sp_cdc_generate_wrapper_function (Transact-SQL)＞。

「使用更新旗標來具現化包裝函式 TVF」範本會示範如何自訂產生的包裝函式，以便將指定之資料行的更新旗標附加至淨變更查詢所傳回的結果集。「具現化結構描述的 CDC 包裝函式 TVF」範本會示範如何針對所有擷取執行個體 (為給定之資料庫結構描述中的來源資料表所建立)，具現化查詢 TVF 的日期時間包裝函式。

如需使用日期時間包裝函式來查詢變更資料的範例，請參閱「使用包裝函式搭配更新旗標來取得淨變更」範本。這個範本會示範如何在包裝函式設定成傳回更新旗標時，使用包裝函式來查詢淨變更。請注意，若要讓基礎查詢函數在更新時傳回非 Null 更新遮罩，就必須使用資料列篩選選項 'all with mask'。Null 值會傳遞成日期時間間隔的下限和上限，以便通知函數在執行基礎 LSN 架構查詢時，使用擷取執行個體之有效性間隔的低端點和高端點。此查詢會針對在擷取執行個體之有效範圍內發生的每個來源資料列修改，傳回一個資料列。

對於單一追蹤來源資料表而言，異動資料擷取最多支援兩個擷取執行個體。這項功能的主要用途是在來源資料表的資料定義語言 (DDL) 變更擴充可用於追蹤的資料行集合時，容納多個擷取執行個體之間的轉換。轉換成新的擷取執行個體時，其中一種避免較高應用程式層級變更基礎查詢函數名稱的方式是使用包裝函式來包裝基礎呼叫。然後，請確定包裝函式的名稱維持不變。進行切換時，可能會卸除舊的包裝函式，而且建立具有相同名稱的新包裝函式，並且參考新的查詢函數。您可以透過先將產生的指令碼修改成建立相同名稱的包裝函式，切換至新的擷取執行個體，而不影響較高的應用程式層。