catalog.validate_package (SSISDB-Datenbank)

Artikel
05/23/2023

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

Gilt für: SQL Server

Überprüft asynchron ein Paket im Integration Services -Katalog.

Syntax

catalog.validate_package [ @folder_name = ] folder_name  
    , [ @project_name = ] project_name  
    , [ @package_name = ] package_name  
    , [ @validation_id = ] validation_id OUTPUT  
 [  , [ @use32bitruntime = ] use32bitruntime ]  
 [  , [ @environment_scope = ] environment_scope ]  
 [  , [ @reference_id = ] reference_id ]

Argumente

[ @folder_name = ] folder_name
Der Name des Ordners, der das Paket enthält. Der folder_name ist nvarchar(128) .

[ @project_name = ] project_name
Der Name des Projekts, das das Paket enthält. Der project_name ist nvarchar(128) .

[ @package_name = ] package_name
Der Name des Pakets. Der package_name ist nvarchar(260).

[ @validation_id = ] validation_id
Gibt den eindeutigen Bezeichner (ID) der Überprüfung zurück. Das Argument validation_id ist vom Typ bigint.

[ @use32bitruntime = ] use32bitruntime
Gibt an, ob die 32-Bit-Laufzeit verwendet werden soll, um das Paket unter einem 64-Bit-Betriebssystem auszuführen. Verwenden Sie den Wert 1, um das Paket mit der 32-Bit-Runtime auszuführen, wenn die Ausführung unter einem 64-Bit-Betriebssystem erfolgt. Verwenden Sie den Wert 0, um das Paket mit der 64-Bit-Laufzeit auszuführen, wenn die Ausführung unter einem 64-Bit-Betriebssystem erfolgt. Dieser Parameter ist optional. Das Argumentuse32bitruntime ist vom Typ bit.

[ @environment_scope = ] environment_scope
Gibt die Umgebungsverweise an, die bei der Überprüfung beachtet werden. Wenn der Wert A ist, werden alle dem Projekt zugeordneten Umgebungsverweise in die Überprüfung eingeschlossen. Wenn der Wert S ist, wird nur ein einzelner Umgebungsverweis eingeschlossen. Wenn der Wert D ist, werden keine Umgebungsverweise eingeschlossen, und jeder Parameter muss für eine erfolgreiche Überprüfung über einen Standardliteralwert verfügen. Dieser Parameter ist optional. Standardmäßig wird das Zeichen D verwendet. Das Argument environment_scope ist vom Typ Char(1).

[ @reference_id = ] reference_id
Die eindeutige ID des Umgebungsverweises. Dieser Parameter ist nur erforderlich, wenn environment_scope den Wert S aufweist und daher nur ein einzelner Umgebungsverweis in die Überprüfung eingeschlossen wird. Der reference_id ist bigint.

Rückgabecodewerte

0 (Erfolg)

Resultsets

Keine

Berechtigungen

Diese gespeicherte Prozedur erfordert eine der folgenden Berechtigungen:

READ-Berechtigungen für das Projekt und ggf. READ-Berechtigungen für die Umgebungen, auf die verwiesen wird
Mitgliedschaft in der Datenbankrolle ssis_admin
Mitgliedschaft in der Serverrolle sysadmin

Fehler und Warnungen

In der folgenden Liste werden einige Bedingungen beschrieben, die möglicherweise einen Fehler oder eine Warnung auslösen:

Der Projekt- oder Paketname ist nicht gültig.
Der Benutzer verfügt nicht über die entsprechenden Berechtigungen.
Eine oder mehrere der in die Überprüfung eingeschlossenen Umgebungen, auf die verwiesen wird, enthalten keine Variablen, auf die verwiesen wird.
Bei der Überprüfung des Pakets tritt ein Fehler auf.
Die Umgebung, auf die verwiesen wird, ist nicht vorhanden.
In den in der Überprüfung enthaltenen Umgebungen, auf die verwiesen wird, können Variablen nicht gefunden werden, auf die verwiesen wird.
In den Paketparametern wird auf Variablen verwiesen, aber in der Überprüfung wurden keine Umgebungen eingeschlossen, auf die verwiesen wird.

Bemerkungen

Die Überprüfung vereinfacht das Identifizieren von Problemen, die das erfolgreiche Ausführen des Pakets verhindern. Verwenden Sie die catalog.validations- oder catalog.operations-Sicht, um den Überprüfungszustand zu überwachen.

Freigeben über