Condividi tramite

sp_apply_job_to_targets (Transact-SQL)

  • Articolo

Si applica a: SQL Server

Applica un processo a uno o più server di destinazione o ai server appartenenti a uno o più gruppi di server di destinazione.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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' ]
[ ; ]

Argomenti

[ @job_id = ] 'job_id'

Numero di identificazione del processo da applicare ai server o ai gruppi di server di destinazione specificati. @job_id è uniqueidentifier, con un valore predefinito .NULL

È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.

[ @job_name = ] N'job_name'

Nome del processo da applicare ai server o ai gruppi di server di destinazione specificati. @job_name è sysname, con il valore predefinito NULL.

È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.

[ @target_server_groups = ] N'target_server_groups'

Elenco delimitato da virgole dei gruppi di server di destinazione ai quali si desidera applicare il processo specificato. @target_server_groups è nvarchar(2048), con un valore predefinito .NULL

[ @target_servers = ] N'target_servers'

Elenco delimitato da virgole dei server di destinazione ai quali si desidera applicare il processo specificato. @target_servers è nvarchar(2048), con il valore predefinito NULL.

[ @operation = ] 'operation'

Specifica se il processo specificato deve essere applicato o rimosso dai server di destinazione o dai gruppi di server di destinazione specificati. @operation è varchar(7), con il valore predefinito APPLY. Le operazioni valide sono APPLY e REMOVE.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_apply_job_to_targets offre un modo semplice per applicare (o rimuovere) un processo da più server di destinazione ed è un'alternativa alla chiamata sp_add_jobserver (o sp_delete_jobserver) una volta per ogni server di destinazione necessario.

Autorizzazioni

È possibile concedere EXECUTE autorizzazioni per questa procedura, ma queste autorizzazioni potrebbero essere sottoposte a override durante un aggiornamento di SQL Server.

Esempi

Nell'esempio seguente il processo Backup Customer Information creato in precedenza viene applicato a tutti i server di destinazione nel gruppo 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

Contenuto correlato