catalog.add_data_tap_by_guid

  • Artikel

Gilt für:SQL Server SSIS Integration Runtime in Azure Data Factory

Gilt für:SQL Server

Fügt einem bestimmten Datenflusspfad in einem Paketdatenfluss für eine Instanz der Ausführung eine Datenabzweigung hinzu.

Syntax

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

Argumente

[ @execution_id = ] execution_id
Die Ausführungs-ID für die Ausführung, die das Paket enthält. Das Argument execution_id ist vom Typ bigInt.

[ @dataflow_task_guid = ] dataflow_task_guid
Die ID für den Datentaskfluss im Paket, das den Datenflusspfad enthält, der abzurufen ist. Das Argument dataflow_task_guid ist vom Typ uniqueidentifier.

[ @dataflow_path_id_string = ] dataflow_path_id_string
Die Identifikationszeichenfolge für den Datenflusspfad. Mit einem Pfad werden zwei Datenflusskomponenten verbunden. Die IdentificationString-Eigenschaft für den Pfad gibt die Zeichenfolge an.

Um die Identifikationszeichenfolge zu suchen, klicken Sie in SQL Server Data Tools mit der rechten Maustaste auf den Pfad zwischen zwei Datenflusskomponenten, und klicken dann auf Eigenschaften. Die IdentificationString-Eigenschaft wird im Fenster Eigenschaften angezeigt.

Das Argument dataflow_path_id_string ist vom Typ nvarchar(4000) .

[ @data_filename = ] data_filename
Der Name der Datei, in der die abgezweigten Daten gespeichert werden. Wenn der Datenflusstask in einer Foreach-Schleife oder einem For-Schleifencontainer ausgeführt wird, werden die abgezweigten Daten für jede Iteration der Schleife in separaten Dateien gespeichert. Jeder Datei wird eine Zahl für die jeweilige Iteration als Präfix vorangestellt. Datenabzweigungsdateien werden in den Ordner „<Ordner für die SQL Server-Installation>\130\DTS“ geschrieben. Das Argument data_filename ist vom Typ nvarchar(4000) .

[ @max_rows = ] max_rows
Die Anzahl der Zeilen, die während der Datenabzweigung aufgezeichnet werden. Wenn dieser Wert nicht angegeben wird, werden alle Zeilen aufgezeichnet. Das Argument „max_rows“ ist vom Typ int.

[ @data_tap_id = ] data_tap_id
Die ID der Datenabzweigung. Das Argument data_tap_id ist vom Typ bigint.

Beispiel

Im folgenden Beispiel wird eine Datenabzweigung für den Datenflusspfad Paths[SRC DimDCVentor.OLE DB Source Output] im Datenflusstask {D978A2E4-E05D-4374-9B05-50178A8817E8} erstellt. Die abgezweigten Daten werden in der Datei "DCVendorOutput.csv" gespeichert.

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'

Bemerkungen

Um Datenabzweigungen hinzuzufügen, muss die Ausführungsinstanz den Status „Erstellt“ (der Wert 1 in der Spalte Zustand der Sicht catalog.operations (SSISDB-Datenbank)) aufweisen. Der Statuswert ändert sicher, wenn Sie die Ausführung starten. Sie können eine Ausführung erstellen, indem Sie catalog.create_execution (SSISDB-Datenbank) aufrufen.

Folgende Überlegungen sind bei der gespeicherten Prozedur "add_data_tap_by_guid" zu beachten.

  • Eine neu hinzugefügte Datenabzweigung wird erst beim Ausführen des Pakets überprüft.

  • Es wird empfohlen, die Anzahl von Zeilen, die während der Datenabzweigung aufgezeichnet werden, zu beschränken, damit keine zu großen Datendateien generiert werden. Wenn der Computer, auf dem die gespeicherte Prozedur ausgeführt wird, nicht mehr über genügend Speicherplatz für die Datendateien verfügt, wird die gespeicherte Prozedur nicht mehr ausgeführt.

  • Die Ausführung der gespeicherten Prozedur "add_data_tap_by_guid" wirkt sich auf die Leistung des Pakets aus. Es wird empfohlen, die gespeicherte Prozedur nur zum Beheben von Datenproblemen auszuführen.

  • Um auf die Datei mit den abgerufenen Daten zuzugreifen, müssen Sie über Administratorberechtigungen für den Computer verfügen, auf dem die gespeicherte Prozedur ausgeführt wird. Sie müssen alternativ der Benutzer sein, der die Ausführung startete, die das Paket mit der Datenabzweigung enthält.

Rückgabecodes

0 (Erfolg)

Wenn die gespeicherte Prozedur fehlschlägt, wird ein Fehler ausgelöst.

Resultset

Keine

Berechtigungen

Diese gespeicherte Prozedur erfordert eine der folgenden Berechtigungen:

  • MODIFY-Berechtigungen für die Instanz der Ausführung

  • Mitgliedschaft in der Datenbankrolle ssis_admin

  • Mitgliedschaft in der Serverrolle sysadmin

Fehler und Warnungen

Die folgende Liste beschreibt Bedingungen, unter denen die gespeicherte Prozedur fehlschlägt.

  • Der Benutzer verfügt nicht über MODIFY-Berechtigungen.

  • Die Datenabzweigung für die angegebene Komponente im angegebenen Paket wurde bereits hinzugefügt.

  • Der für die Anzahl der aufzuzeichnenden Zeilen angegebene Wert ist ungültig.

Requirements (Anforderungen)

Weitere Informationen

catalog.add_data_tap