sp_apply_job_to_targets (T-SQL)

Berlaku untuk:SQL Server

Menerapkan pekerjaan ke satu atau beberapa server target atau ke server target milik satu atau beberapa grup server target.

Konvensi sintaks transact-SQL

Sintaks

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

Argumen

[ @job_id = ] 'job_id'

Nomor identifikasi pekerjaan dari pekerjaan yang akan diterapkan ke server target atau grup server target yang ditentukan. @job_id adalah uniqueidentifier, dengan default NULL.

Baik @job_id atau @job_name harus ditentukan, tetapi keduanya tidak dapat ditentukan.

[ @job_name = ] N'job_name'

Nama pekerjaan yang akan diterapkan ke server target terkait yang ditentukan atau grup server target. @job_name adalah sysname, dengan default NULL.

Baik @job_id atau @job_name harus ditentukan, tetapi keduanya tidak dapat ditentukan.

[ @target_server_groups = ] N'target_server_groups'

Daftar grup server target yang dipisahkan koma tempat pekerjaan yang ditentukan akan diterapkan. @target_server_groups adalah nvarchar(2048), dengan default NULL.

[ @target_servers = ] N'target_servers'

Daftar server target yang dipisahkan koma tempat pekerjaan yang ditentukan akan diterapkan. @target_servers adalah nvarchar(2048), dengan default NULL.

[ @operation = ] 'operasi'

Menentukan apakah pekerjaan yang ditentukan harus diterapkan atau dihapus dari server target atau grup server target yang ditentukan. @operation adalah varchar(7), dengan default APPLY. Operasi yang valid adalah APPLY dan REMOVE.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_apply_job_to_targets menyediakan cara mudah untuk menerapkan (atau menghapus) pekerjaan dari beberapa server target, dan merupakan alternatif untuk memanggil sp_add_jobserver (atau sp_delete_jobserver) sekali untuk setiap server target yang diperlukan.

Izin

Prosedur tersimpan ini dimiliki oleh peran db_owner . Anda dapat memberikan EXECUTE izin untuk pengguna mana pun, tetapi izin ini dapat ditimpa selama peningkatan SQL Server.

Contoh

Contoh berikut menerapkan pekerjaan yang dibuat Backup Customer Information sebelumnya ke semua server target dalam Servers Maintaining Customer Information grup.

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