catalog.validate_project (SSISDB-Datenbank)

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

Syntax

validate_project [ @folder_name = ] folder_name
    , [ @project_name = ] project_name
    , [ @validate_type = ] validate_type
    , [ @validation_id = ] validation_id OUTPUT
 [  , [ @use32bitruntime = ] use32bitruntime ]
 [  , [ @target_environment = ] target_environment ]
 [  , [ @reference_id = ] reference_id ]

Argumente

• [ @folder\_name = ] folder_name
  Der Name eines Ordners, der das Projekt enthält. Der folder_name ist nvarchar(128).

• [ @project\_name = ] project_name
  Der Name des Projekts. Der project_name ist nvarchar(128).

• [ @validate\_type = ] validate_type
  Gibt den Typ der auszuführenden Überprüfung an. Führen Sie mithilfe des Zeichens F eine vollständige Überprüfung aus. Der validate_type ist char(1).

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

Die Ausgabe der Überprüfungsschritte wird als unterschiedliche Abschnitte des Resultsets zurückgegeben.

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 angegeben, die möglicherweise einen Fehler oder eine Warnung auslösen:

• Die Überprüfung schlägt für ein oder mehrere Pakete im Projekt fehl.

• Die Überprüfung schlägt fehl, wenn eine oder mehrere der in die Überprüfung eingeschlossenen Umgebungen, auf die verwiesen wird, keine Variablen enthalten, auf die verwiesen wird.

• Der angegebene Überprüfungstyp ist ungültig.

• Der Projektname oder die Umgebungsverweis-ID ist ungültig.

• Der Benutzer verfügt nicht über die entsprechenden Berechtigungen.

Hinweise

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

In der Überprüfung können nur Umgebungen verwendet werden, auf die vom Benutzer zugegriffen werden kann. Die Ausgabe der Überprüfung wird als Resultset an den Client gesendet.

In dieser Version unterstützt die Projektüberprüfung keine Abhängigkeitsüberprüfung.

Eine vollständige Überprüfung bestätigt, dass alle Umgebungsvariablen, auf die verwiesen wird, in den in die Überprüfung eingeschlossenen Umgebungen, auf die verwiesen wird, vorhanden sind. In den Ergebnissen der vollständigen Überprüfung werden Umgebungsverweise aufgeführt, die ungültig sind, sowie Umgebungsvariablen, auf die verwiesen wird und die in keiner der in die Überprüfung eingeschlossenen Umgebungen, auf die verwiesen wird, gefunden werden konnten.