Udostępnij za pośrednictwem

catalog.add_data_tap_by_guid

  • Artykuł

Dotyczy:sql Server SSIS Integration Runtime w usłudze Azure Data Factory

Dotyczy:programu SQL Server

Dodaje naciśnięcie danych do określonej ścieżki przepływu danych w przepływie danych pakietu na potrzeby wystąpienia wykonania.

Składnia

catalog.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

Argumenty

[ @execution_id = ] execution_id
Identyfikator wykonania dla wykonania zawierającego pakiet. execution_id to bigint.

[ @dataflow_task_guid = ] dataflow_task_guid
Identyfikator przepływu zadania danych w pakiecie zawierającym ścieżkę przepływu danych, która ma zostać naciśnięta. dataflow_task_guid to unikatowyidentifier.

[ @dataflow_path_id_string = ] dataflow_path_id_string
Ciąg identyfikacyjny ścieżki przepływu danych. Ścieżka łączy dwa składniki przepływu danych. Właściwość IdentificationString dla ścieżki określa ciąg.

Aby zlokalizować ciąg identyfikacji, w narzędziach SQL Server Data Tools kliknij prawym przyciskiem myszy ścieżkę między dwoma składnikami przepływu danych, a następnie kliknij właściwości. Właściwość IdentificationString jest wyświetlana w oknie Właściwości.

dataflow_path_id_string to nvarchar(4000).

[ @data_filename = ] data_filename
Nazwa pliku, który przechowuje naciśnięte dane. Jeśli zadanie przepływu danych jest wykonywane wewnątrz pętli Foreach lub kontenera For Loop, oddzielne pliki przechowują dane naciśnięte dla każdej iteracji pętli. Każdy plik jest poprzedzony liczbą odpowiadającą iteracji. Pliki naciśnięcia danych są zapisywane w folderze "<folder instalacyjny programu SQL Server>\130\DTS\". data_filename to nvarchar(4000).

[ @max_rows = ] max_rows
Liczba wierszy przechwyconych podczas naciśnięcia danych. Jeśli ta wartość nie zostanie określona, wszystkie wiersze zostaną przechwycone. Max_rows to int.

[ @data_tap_id = ] data_tap_id
Identyfikator naciśnięcia danych. data_tap_id to bigint.

Przykład

W poniższym przykładzie na ścieżce przepływu danych jest tworzone naciśnięcie danych Paths[SRC DimDCVentor.OLE DB Source Output]w zadaniu przepływu danych {D978A2E4-E05D-4374-9B05-50178A8817E8}. Naciśnięte dane są przechowywane w pliku 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'

Uwagi

Aby dodać naciśnięcia danych, wystąpienie wykonania musi znajdować się w stanie utworzonym (wartość 1 w kolumnie stanu kolumny catalog.operations (baza danych SSISDB) widoku). Wartość stanu zmienia się po uruchomieniu wykonania. Wykonanie można utworzyć, wywołując catalog.create_execution (baza danych SSISDB).

Poniżej przedstawiono zagadnienia dotyczące procedury składowanej add_data_tap_by_guid.

  • Po dodaniu naciśnięcia danych nie jest weryfikowany przed uruchomieniem pakietu.

  • Zaleca się ograniczenie liczby wierszy przechwyconych podczas naciśnięcia danych, aby uniknąć generowania dużych plików danych. Jeśli maszyna, na której jest wykonywana procedura składowana, zabraknie miejsca do magazynowania dla plików danych, procedura składowana przestanie działać.

  • Uruchomienie procedury składowanej add_data_tap_by_guid wpływa na wydajność pakietu. Zaleca się uruchomienie procedury składowanej tylko w celu rozwiązywania problemów z danymi.

  • Aby uzyskać dostęp do pliku, który przechowuje naciśnięte dane, musisz mieć uprawnienia administratora na maszynie, na której jest uruchamiana procedura składowana, lub musisz być użytkownikiem, który rozpoczął wykonywanie zawierające pakiet z naciśnięciem danych.

Kody powrotne

0 (powodzenie)

Gdy procedura składowana nie powiedzie się, zgłasza błąd.

Zestaw wyników

Żaden

Uprawnienia

Ta procedura składowana wymaga jednego z następujących uprawnień:

  • MODYFIKOWANIE uprawnień w wystąpieniu wykonywania

  • Członkostwo w roli bazy danych ssis_admin

  • Członkostwo w roli serwera sysadmin

Błędy i ostrzeżenia

Poniższa lista zawiera opis warunków, które powodują niepowodzenie procedury składowanej.

  • Użytkownik nie ma uprawnień MODYFIKUJ.

  • Naciśnięcie danych dla określonego składnika w określonym pakiecie zostało już dodane.

  • Wartość określona dla liczby wierszy do przechwycenia jest nieprawidłowa.

Wymagania

Zobacz też

catalog.add_data_tap