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.
Hinweis |
---|
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. |