catalog.validate_package (SSISDB-Datenbank)

Artikel
05/07/2013

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

Syntax

validate_package [ @folder_name = ] folder_name
    , [ @project_name = ] project_name
    , [ @package_name = ] package_name
    , [ @validation_id = ] validation_id OUTPUT
 [  , [ @use32bitruntime = ] use32bitruntime ]
 [  , [ @target_environment = ] target_environment ]
 [  , [ @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. Die validation_id ist 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-Laufzeit 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. Die use32bitruntime ist 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. Das Zeichen D wird standardmäßig verwendet. Der environment_scope ist 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. Die 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.
Die Überprüfung des Pakets schlägt fehl.
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.

Hinweise

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

Freigeben über