Share via

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

  • [アーティクル]

特定のフォルダーの環境を Integration Services カタログ内の別のフォルダーに移動します。

構文

move_environment [ @source_folder = ] source_folder
    , [ @environment_name = ] environment_name
    , [ @destination_folder = ] destination_folder

引数

  • [ @source\_folder = ] source_folder
    環境が、移動前に配置されていたソース フォルダーの名前。 source_folder は nvarchar(128) 型です。

  • [ @environment\_name = ] environment_name
    移動される環境の名前。 environment_name は nvarchar(128) 型です。

  • [ @destination\_folder = ] destination_folder
    環境が移動後に配置される移動先フォルダーの名前。 destination_folder は nvarchar(128) 型です。

リターン コードの値

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

結果セット

なし

権限

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

  • 環境の READ および MODIFY 権限

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

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

エラーおよび警告

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

  • 環境が移動元フォルダーに存在しない

  • 移動先のフォルダーに同じ名前の環境が既にある

  • ユーザーに適切な権限がない

解説

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

注意注

プロジェクトでは、相対または絶対環境参照を使用できます。 相対参照の場合、名前によって環境を参照します。この環境はプロジェクトと同じフォルダーに格納されている必要があります。 絶対参照の場合、名前とフォルダーによって環境を参照します。これらの参照は、プロジェクトとは異なるフォルダーに格納されている環境を参照する場合があります。