catalog.move_environment (SSISDB-Datenbank)

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

Gilt für:SQL Server

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

Syntax

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

Bemerkungen

Umgebungsverweise aus Projekten werden nicht während des Verschiebens der Umgebung entsprechend angepasst. Umgebungsverweise müssen entsprechend 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.