Udostępnij za pośrednictwem

catalog.add_data_tap

  • Artykuł

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

Dotyczy:programu SQL Server

Dodaje naciśnięcie danych wyjściowych składnika w przepływie danych pakietu na potrzeby wystąpienia wykonania.

Składnia

catalog.add_data_tap [ @execution_id = ] execution_id  
, [ @task_package_path = ] task_package_path  
, [ @dataflow_path_id_string = ] dataflow_path_id_string  
, [ @data_filename = ] data_filename  
, [ @max_rows = ] max_rows  
, [ @data_tap_id = ] data_tap_id OUTPUT

Argumenty

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

[ @task_package_path = ] task_package_path
Ścieżka pakietu dla zadania przepływu danych. Właściwość PackagePath dla zadania przepływu danych określa ścieżkę. W ścieżce jest rozróżniana wielkość liter. Aby zlokalizować ścieżkę pakietu, w narzędziach SQL Server Data Tools kliknij prawym przyciskiem myszy zadanie Przepływu danych, a następnie kliknij właściwości. Właściwość PackagePath jest wyświetlana w oknie właściwości.

task_package_path to nvarchar(max).

[ @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.

Domyślnie plik jest przechowywany na dysku <>:\Program Files\Microsoft SQL Server\130\DTS\DataDumps.

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

[ @data_tap_id = ] data_tap_id
Zwraca 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[OLE DB Source.OLE DB Source Output], w zadaniu przepływu danych \Package\Data Flow Task. Naciśnięte dane są przechowywane w pliku output0.txt w folderze DataDumps (dysk<>:\Program Files\Microsoft SQL Server\130\DTS\DataDumps).

Declare @execution_id bigint  
Exec SSISDB.Catalog.create_execution @folder_name='Packages',@project_name='SSISPackages', @package_name='Package.dtsx',@reference_id=Null, @use32bitruntime=False, @execution_id=@execution_id OUTPUT  
  
Exec SSISDB.Catalog.set_execution_parameter_value @execution_id,50, 'LOGGING_LEVEL', 0  
  
Exec SSISDB.Catalog.add_data_tap @execution_id, @task_package_path='\Package\Data Flow Task', @dataflow_path_id_string = 'Paths[OLE DB Source.OLE DB Source Output]', @data_filename = 'output0.txt'  
  
Exec SSISDB.Catalog.start_execution @execution_id

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.

  • Jeśli wykonanie zawiera pakiet nadrzędny i co najmniej jeden pakiet podrzędny, musisz dodać naciśnięcie danych dla każdego pakietu, dla którego chcesz nacisnąć dane.

  • Jeśli pakiet zawiera więcej niż jedno zadanie przepływu danych o tej samej nazwie, task_package_path jednoznacznie identyfikuje zadanie przepływu danych zawierające dane wyjściowe składnika, które jest naciśnięte.

  • 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, pakiet przestanie działać, a komunikat o błędzie zostanie zapisany w dzienniku.

  • Uruchomienie procedury składowanej add_data_tap 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 być administratorem na maszynie, na której jest uruchamiana procedura składowana. Musisz również być użytkownikiem, który rozpoczął wykonywanie zawierające pakiet za pomocą naciśnięcia 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

Zasoby zewnętrzne

Wpis w blogu SSIS 2012: A Peek to Data Taps, na rafael-salas.com.

Zobacz też

catalog.add_data_tap_by_guid