Teilen über


catalog.rename_environment (SSISDB-Datenbank)

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

Gilt für:SQL Server

Benennt eine Umgebung im Integration Services -Katalog um.

Syntax

catalog.rename_environment [ @folder_name = ] folder_name  
    , [ @environment_name = ] environment_name  
    , [ @new_environment_name= ] new_environment_name  

Argumente

[ @folder_name = ] folder_name
Der Name des Ordners, der die Umgebung enthält. Der folder_name ist nvarchar(128) .

[ @environment_name = ] environment_name
Der ursprüngliche Name der Umgebung. Der environment_name ist nvarchar(128) .

[ @new_environment_name = ] new_environment_name
Der neue Name der Umgebung. Der new_environment_name ist nvarchar(128).

Rückgabecodewert

0 (Erfolg)

Resultsets

Keine

Berechtigungen

Diese gespeicherte Prozedur erfordert eine der folgenden Berechtigungen:

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

  • Der ursprüngliche Umgebungsname ist ungültig.

  • Der neue Name wurde bereits für eine vorhandene Umgebung verwendet.

Bemerkungen

Umgebungsverweise aus Projekten werden nicht automatisch aktualisiert, wenn Sie die Umgebung umbenennen. Umgebungsverweise müssen entsprechend aktualisiert werden. Diese gespeicherte Prozedur wird auch dann erfolgreich ausgeführt, wenn Umgebungsverweise durch das Ändern des Umgebungsnamens beschädigt werden. Nach Abschluss dieser gespeicherten Prozedur müssen Umgebungsverweise aktualisiert werden.

Hinweis

Wenn ein Umgebungsverweis ungültig ist, schlagen Überprüfung und Ausführung der entsprechenden Pakete fehl, von denen diese Verweise verwendet werden.