Bagikan melalui

sp_help_downloadlist (T-SQL)

  • Artikel

Berlaku untuk: SQL Server

Mencantumkan sysdownloadlist semua baris dalam tabel sistem untuk pekerjaan yang disediakan, atau semua baris jika tidak ada pekerjaan yang ditentukan.

Konvensi sintaks transact-SQL

Sintaks

sp_help_downloadlist
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @operation = ] 'operation' ]
    [ , [ @object_type = ] 'object_type' ]
    [ , [ @object_name = ] N'object_name' ]
    [ , [ @target_server = ] N'target_server' ]
    [ , [ @has_error = ] has_error ]
    [ , [ @status = ] status ]
    [ , [ @date_posted = ] date_posted ]
[ ; ]

Argumen

[ @job_id = ] 'job_id'

Nomor identifikasi pekerjaan untuk mengembalikan informasi. @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. @job_name adalah sysname, dengan default NULL.

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

[ @operation = ] 'operasi'

Operasi yang valid untuk pekerjaan yang ditentukan. @operation adalah varchar(64), dan dapat menjadi salah satu nilai ini.

Nilai Deskripsi
DEFECT Operasi server yang meminta server target untuk cacat dari layanan Master SQL Server Agent.
DELETE Operasi pekerjaan yang menghapus seluruh pekerjaan.
INSERT Operasi pekerjaan yang menyisipkan seluruh pekerjaan atau me-refresh pekerjaan yang sudah ada. Operasi ini mencakup semua langkah dan jadwal pekerjaan, jika berlaku.
RE-ENLIST Operasi server yang menyebabkan server target mengirim ulang informasi pendaftarannya, termasuk interval polling dan zona waktu ke domain multiserver. Server target juga mengunduh ulang detailnya MSXOperator .
SET-POLL Operasi server yang mengatur interval, dalam detik, untuk server target guna melakukan polling domain multiserver. Jika ditentukan, @value ditafsirkan sebagai nilai interval yang diperlukan, dan dapat berupa nilai dari 10 hingga 28.800.
START Operasi pekerjaan yang meminta dimulainya eksekusi pekerjaan.
STOP Operasi pekerjaan yang meminta penghentian eksekusi pekerjaan.
SYNC-TIME Operasi server yang menyebabkan server target menyinkronkan jam sistemnya dengan domain multiserver. Karena ini adalah operasi yang mahal, lakukan operasi ini secara terbatas dan jarang.
UPDATE Operasi pekerjaan yang hanya sysjobs memperbarui informasi untuk pekerjaan, bukan langkah atau jadwal pekerjaan. Secara otomatis dipanggil oleh sp_update_job.

[ @object_type = ] 'object_type'

Jenis objek untuk pekerjaan yang ditentukan. @object_type adalah varchar(64), dengan default NULL. @object_type dapat berupa JOB atau SERVER. Untuk informasi selengkapnya tentang nilai @object_typeyang valid, lihat sp_add_category.

[ @object_name = ] N'object_name'

Nama objek. @object_name adalah sysname, dengan default NULL. Jika @object_type adalah JOB, @object_name adalah nama pekerjaan. Jika @object_type adalah SERVER, @object_name adalah nama server.

[ @target_server = ] N'target_server'

Nama server target. @target_server adalah sysname, dengan default NULL.

[ @has_error = ] has_error

Menentukan apakah pekerjaan harus mengakui kesalahan. @has_error kecil, dengan default NULL, yang menunjukkan tidak ada kesalahan yang harus diakui. 1 menunjukkan bahwa semua kesalahan harus diakui.

[ @status = ] status

Status untuk pekerjaan tersebut. @status kecil, dengan default NULL.

[ @date_posted = ] date_posted

Tanggal dan waktu yang semua entrinya dibuat pada atau setelah tanggal dan waktu yang ditentukan harus disertakan dalam tataan hasil. @date_posted adalah datetime, dengan default NULL.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Nama kolom Jenis data Deskripsi
instance_id int Nomor identifikasi bilangan bulat unik dari instruksi.
source_server nvarchar(30) Nama komputer server tempat instruksi berasal.
operation_code nvarchar(4000) Kode operasi untuk instruksi.
object_name nama sysname Objek yang dipengaruhi oleh instruksi.
object_id pengidentifikasi unik Nomor identifikasi objek yang dipengaruhi oleh instruksi (job_id untuk objek pekerjaan, atau 0x00 untuk objek server) atau nilai data khusus untuk operation_code.
target_server nvarchar(30) Server target yang harus diunduh oleh instruksi ini.
error_message nvarchar(1024) Pesan kesalahan (jika ada) dari server target jika mengalami masalah saat memproses instruksi ini.

Catatan: Setiap pesan kesalahan memblokir semua unduhan lebih lanjut oleh server target.
date_posted datetime Tanggal instruksi diposting ke tabel.
date_downloaded datetime Tanggal server target mengunduh instruksi.
status kecil Status pekerjaan:

0 = Belum diunduh
1 = Berhasil diunduh.

Izin

Izin untuk menjalankan prosedur ini secara default kepada anggota peran server tetap sysadmin .

Contoh

Contoh berikut mencantumkan sysdownloadlist baris dalam untuk pekerjaan tersebut NightlyBackups .

USE msdb;
GO

EXEC dbo.sp_help_downloadlist
    @job_name = N'NightlyBackups',
    @operation = N'UPDATE',
    @object_type = N'JOB',
    @object_name = N'NightlyBackups',
    @target_server = N'SEATTLE2',
    @has_error = 1,
    @status = NULL,
    @date_posted = NULL;
GO

Konten terkait