sp_help_downloadlist (T-SQL)
Berlaku untuk: SQL Server
Mencantumkan sysdownloadlist
semua baris dalam tabel sistem untuk pekerjaan yang disediakan, atau semua baris jika tidak ada pekerjaan yang ditentukan.
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 diunduh1 = 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