次の方法で共有

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

  • [アーティクル]

適用対象: SQL Server Azure Data Factory の SSIS 統合ランタイム

適用対象: 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

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