Freigeben über


catalog.move_environment (SSISDB-Datenbank)

Verschiebt eine Umgebung von einem Ordner in einen anderen Ordner im Integration Services-Katalog.

Syntax

move_environment [ @source_folder = ] source_folder
    , [ @environment_name = ] environment_name
    , [ @destination_folder = ] destination_folder

Argumente

  • [ @source\_folder = ] source_folder
    Der Name des Quellordners, in dem sich die Umgebung vor dem Verschieben befindet. Der source_folder ist nvarchar(128).

  • [ @environment\_name = ] environment_name
    Der Name der Umgebung, die verschoben werden soll. Der environment_name ist nvarchar(128).

  • [ @destination\_folder = ] destination_folder
    Der Name des Zielordners, in dem sich die Umgebung nach dem Verschieben befindet. Der destination_folder ist nvarchar(128).

Rückgabecodewert

0 (Erfolg)

Resultsets

Keine

Berechtigungen

Diese gespeicherte Prozedur erfordert eine der folgenden Berechtigungen:

  • READ-Berechtigung und MODIFY-Berechtigung für die Umgebung

  • 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:

  • Die Umgebung ist im Quellordner nicht vorhanden.

  • Für den Zielordner ist bereits eine Umgebung mit dem gleichen Namen vorhanden.

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

Hinweise

Umgebungsverweise aus Projekten werden nicht während des Verschiebens der Umgebung entsprechend angepasst. Umgebungsverweise müssen nach dem Verschieben aktualisiert werden. Diese gespeicherte Prozedur wird auch dann erfolgreich ausgeführt, wenn Umgebungsverweise durch das Verschieben einer Umgebung beschädigt werden. Nach Abschluss dieser gespeicherten Prozedur müssen Umgebungsverweise aktualisiert werden.

HinweisHinweis

Ein Projekt kann über relative oder absolute Umgebungsverweise verfügen. Relative Verweise verweisen mit dem Namen auf die Umgebung und erfordern, dass sich die Umgebung im gleichen Ordner wie das Projekt befindet. Absolute Verweise verweisen mit Name und Ordner auf die Umgebung, und sie verweisen auf Umgebungen, die sich in einem anderen Ordner als dem Ordner des Projekts befinden.