次の方法で共有

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

  • [アーティクル]

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

構文

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 サーバー ロールのメンバーシップ

エラーおよび警告

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

  • 元の環境名が無効

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

解説

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

注意注

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