sp_apply_job_to_targets (Transact-SQL)
適用対象:SQL Server
1 つ以上のターゲット サーバーまたは 1 つ以上のターゲット サーバー グループに属するターゲット サーバーにジョブを適用します。
構文
sp_apply_job_to_targets
[ [ @job_id = ] 'job_id' ]
[ , [ @job_name = ] N'job_name' ]
[ , [ @target_server_groups = ] N'target_server_groups' ]
[ , [ @target_servers = ] N'target_servers' ]
[ , [ @operation = ] 'operation' ]
[ ; ]
引数
[ @job_id = ] 'job_id'
指定したターゲット サーバーまたはターゲット サーバー グループに適用するジョブの、ジョブ識別番号を指定します。 @job_idは uniqueidentifier で、既定値は NULL
.
@job_idまたは@job_nameを指定する必要がありますが、両方を指定することはできません。
[ @job_name = ] N'job_name'
指定したターゲット サーバーまたはターゲット サーバー グループに適用するジョブの名前を指定します。 @job_nameは sysname で、既定値は NULL
.
@job_idまたは@job_nameを指定する必要がありますが、両方を指定することはできません。
[ @target_server_groups = ] N'target_server_groups'
指定したジョブを適用するターゲット サーバー グループのコンマ区切りのリスト。 @target_server_groupsは nvarchar(2048) で、既定値は NULL
.
[ @target_servers = ] N'target_servers'
指定したジョブの適用先となるターゲット サーバーのコンマ区切りのリスト。 @target_serversは nvarchar(2048) で、既定値は NULL
.
[ @operation = ] 'operation'
指定したジョブを、指定したターゲット サーバーまたはターゲット サーバー グループに適用するか、またはターゲット サーバー グループから削除するかを指定します。 @operationは varchar(7) で、既定値は APPLY
. 有効な操作は次のとおりですAPPLY
REMOVE
。
リターン コードの値
0
(成功) または 1
(失敗)。
解説
sp_apply_job_to_targets
は、複数のターゲット サーバーからジョブを適用 (または削除) する簡単な方法を提供します。これは、必要なターゲット サーバーごとに 1 回呼び出す sp_add_jobserver
(または sp_delete_jobserver
) 代替手段です。
アクセス許可
このストアド プロシージャは、db_owner ロールによって所有されています。 任意のユーザーにアクセス許可を付与 EXECUTE
できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。
例
次の例では、以前に作成 Backup Customer Information
したジョブをグループ内のすべてのターゲット サーバーに Servers Maintaining Customer Information
適用します。
USE msdb;
GO
EXEC dbo.sp_apply_job_to_targets
@job_name = N'Backup Customer Information',
@target_server_groups = N'Servers Maintaining Customer Information',
@operation = N'APPLY' ;
GO
関連するコンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示