Share via

catalog.add_data_tap_by_guid

  • 發行項

針對執行的執行個體，在封裝資料流程中，將資料點選加入至特定的資料流程路徑。

語法

add_data_tap_by_guid [ @execution_id = ] execution_id
[ @dataflow_task_guid = ] dataflow_task_guid 
[ @dataflow_path_id_string = ] dataflow_path_id_string
[ @data_filename = ] data_filename
[ @max_rows = ] max_rows
[ @data_tap_id = ] data_tap_id

引數

  • [ @execution\_id = ] execution_id
    含有封裝之執行的執行識別碼。 execution_id 為 bigint。

  • [ @dataflow\_task\_guid = ] dataflow_task_guid
    封裝中包含要點選之資料流程路徑的資料工作流程識別碼。 dataflow_task_guid 為 uniqueidentifier。

  • [ @dataflow\_path\_id\_string = ] dataflow_path_id_string
    資料流程路徑的識別字串。 路徑會連接兩個資料流程元件。 路徑的 [IdentificationString] 屬性會指定字串。

    若要尋找識別字串，在 SQL Server Data Tools 中以滑鼠右鍵按一下兩個資料流程元件之間的路徑，然後按一下 [屬性]。 [IdentificationString] 屬性會出現在 [屬性] 視窗中。

    dataflow_path_id_string 為 nvarchar(4000)。

  • [ @data\_filename = ] data_filename
    儲存點選資料的檔案名稱。 如果資料流程工作是在 Foreach 迴圈或 For 迴圈容器中執行，個別檔案會針對迴圈的每次反覆運算，來儲存點選資料。 每個檔案都會以對應於反覆運算的號碼為字首。 資料點選檔案會寫入至資料夾 [<SQL Server installation folder>\110\DTS\]。 data_filename 為 nvarchar(4000)。

  • [ @max\_rows = ] max_rows
    在資料點選期間擷取的資料列數目。 如果沒有指定此值，則會擷取所有資料列。 max_rows 為 int。

  • [ @data\_tap\_id = ] data_tap_id
    資料點選的識別碼。 data_tap_id 為 bigint。

範例

下列範例會在資料流程工作 {D978A2E4-E05D-4374-9B05-50178A8817E8} 中的資料流程路徑 Paths[SRC DimDCVentor.OLE DB Source Output] 上建立資料點選。 點選資料會儲存在 DCVendorOutput.csv 檔案中。

exec catalog.add_data_tap_by_guid   @execution_id, 
'{D978A2E4-E05D-4374-9B05-50178A8817E8}', 
'Paths[SRC DimDCVentor.OLE DB Source Output]', 
'D:\demos\datafiles\DCVendorOutput.csv'

備註

若要加入資料點選，執行的執行個體必須處於已建立狀態 (catalog.operations (SSISDB 資料庫) 檢視之 status 資料行中的值為 1)。 狀態值會在您進行執行時變更。 您可以藉由呼叫 catalog.create_execution (SSISDB 資料庫) 建立執行。

以下是 add_data_tap_by_guid 預存程序的考量事項。

  • 當您加入資料點選時，在執行封裝之前不會進行驗證。

  • 建議您限制在資料點選期間擷取的資料列數目，以避免產生大型資料檔案。 如果執行預存程序的電腦將資料檔案的儲存空間用盡，預存程序就會停止執行。

  • 執行 add_data_tap_by_guid 預存程序會影響封裝的效能。 建議您只在進行資料問題的疑難排解時，才執行預存程序。

  • 若要存取儲存點選資料的檔案，您必須在執行預存程序所在電腦上擁有管理員權限，或者您必須是開始執行包含擁有資料點選之封裝的使用者。

傳回碼

0 (成功)

當預存程序失敗時，會擲回錯誤。

結果集

無

權限

這個預存程序需要下列其中一個權限：

  • 執行的執行個體之 MODIFY 權限

  • ssis_admin 資料庫角色成員資格

  • sysadmin 伺服器角色成員資格

錯誤和警告

下列清單描述會導致預存程序失敗的情況。

  • 使用者沒有 MODIFY 權限。

  • 指定封裝中已加入指定元件的資料點選。

  • 對於所要擷取的資料列數目，所指定的值無效。

請參閱

參考

catalog.add_data_tap