catalog.move_environment (SSISDB データベース)
適用対象:SQL Server Azure Data Factory の SSIS Integration Runtime
適用対象:SQL Server
特定のフォルダーの環境を Integration Services カタログ内の別のフォルダーに移動します。
構文
catalog.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 サーバー ロールのメンバーシップ
エラーおよび警告
エラーまたは警告が発生する可能性がある条件を以下に示します。
環境が移動元フォルダーに存在しない
移動先のフォルダーに同じ名前の環境が既にある
ユーザーに適切な権限がない
解説
プロジェクトの環境参照は、移動中、環境に従って更新されません。 したがって、環境参照を更新する必要があります。 このストアド プロシージャ は、環境を移動することで環境参照が壊れた場合でも成功します。 環境参照は、このストアド プロシージャが完了した後で更新する必要があります。
Note
プロジェクトでは、相対または絶対環境参照を使用できます。 相対参照の場合、名前によって環境を参照します。この環境はプロジェクトと同じフォルダーに格納されている必要があります。 絶対参照の場合、名前とフォルダーによって環境を参照します。これらの参照は、プロジェクトとは異なるフォルダーに格納されている環境を参照する場合があります。