sp_apply_job_to_targets （Transact-SQL）

  • 文章

適用於：SQL Server

將作業套用至一或多個目標伺服器，或套用至屬於一或多個目標伺服器群組的目標伺服器。

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 提供從多個目標伺服器套用（或移除）作業的簡單方法，而且是針對每個所需的目標伺服器呼叫 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

相關內容