sp_apply_job_to_targets (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

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. 有効な操作は次のとおりですAPPLYREMOVE。

リターン コードの値

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

関連するコンテンツ