sp_apply_job_to_targets (Transact-SQL)

適用対象: SQL サーバー

1 つ以上のターゲット サーバーまたは 1 つ以上のターゲット サーバー グループに属するターゲット サーバーにジョブを適用します。

Transact-SQL 構文表記規則

構文

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

関連するコンテンツ

• sp_add_jobserver (Transact-SQL)
• sp_delete_jobserver (Transact-SQL)
• sp_remove_job_from_targets (Transact-SQL)
• システム ストアド プロシージャ (Transact-SQL)