catalog.rename_environment (SSISDB データベース)

適用対象:SQL Server Azure Data Factory の SSIS Integration Runtime

適用対象:SQL Server

Integration Services カタログの環境の名前を変更します。

構文

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

引数

[ @folder_name = ] folder_name
環境を含むフォルダーの名前です。 folder_name は nvarchar(128) です。

[ @environment_name = ] environment_name
環境の元の名前。 Environment_name は nvarchar(128) です。

[ @new_environment_name = ] new_environment_name
環境の新しい名前。 new_environment_name は nvarchar(128) です。

リターン コード値

成功した場合は 0 を返します。

結果セット

なし

アクセス許可

このストアド プロシージャには、次の権限のいずれかが必要です。

• 環境の MODIFY 権限

• ssis_admin データベース ロールのメンバーシップ

• sysadmin サーバー ロールのメンバーシップ

エラーおよび警告

エラーまたは警告が発生する可能性がある条件を以下に示します。

• 元の環境名が無効

• 新しい名前が既存の環境で既に使用されている

解説

環境の名前を変更しても、プロジェクトの環境参照は自動的に更新されません。 したがって、環境参照を更新する必要があります。 このストアド プロシージャ は、環境名を変更することで環境参照が壊れた場合でも成功します。 環境参照は、このストアド プロシージャが完了した後で更新する必要があります。

Note

環境参照が有効でない場合、これらの参照を使用する対応するパッケージの検証および実行が失敗します。