sp_help_category (Transact-SQL)

Berlaku untuk: SQL Server (semua versi yang didukung)

Menyediakan informasi tentang kelas pekerjaan, pemberitahuan, atau operator yang ditentukan.

Ikon tautan topikKonvensi Sintaks Transact-SQL

Sintaks

  
sp_help_category [ [ @class = ] 'class' ]   
     [ , [ @type = ] 'type' ]   
     [ , [ @name = ] 'name' ]   
     [ , [ @suffix = ] suffix ]   

Argumen

[ @class = ] 'class' Kelas tentang informasi mana yang diminta. kelas adalah varchar(8), dengan nilai default JOB. kelas dapat menjadi salah satu nilai ini.

Nilai Deskripsi
Pekerjaan Menyediakan informasi tentang kategori pekerjaan.
WASPADA Menyediakan informasi tentang kategori pemberitahuan.
OPERATOR Menyediakan informasi tentang kategori operator.

[ @type = ] 'type' Jenis kategori yang informasinya diminta. jenisnya adalah varchar(12), dengan default NULL, dan dapat menjadi salah satu nilai ini.

Nilai Deskripsi
LOKAL Kategori pekerjaan lokal.
MULTI -SERVER Kategori pekerjaan multiserver.
TIDAK Kategori untuk kelas selain JOB.

[ @name = ] 'name' Nama kategori yang informasinya diminta. nama adalah sysname, dengan default NULL.

[ @suffix = ] suffix Menentukan apakah kolom category_type dalam kumpulan hasil adalah ID atau nama. akhiranadalah bit, dengan default 0. 1 menunjukkan category_type sebagai nama, dan 0 menunjukkannya sebagai ID.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Tataan Hasil

Saat @suffixadalah 0, sp_help_category mengembalikan tataan hasil berikut:

Nama kolom Jenis data Deskripsi
category_id int ID Kategori
category_type tinyint Jenis kategori:

1 = Lokal

2 = Multiserver

3 = Tidak ada
nama nama sysname Nama kategori

Saat @suffixadalah 1, sp_help_category mengembalikan tataan hasil berikut:

Nama kolom Jenis data Deskripsi
category_id int ID Kategori
category_type nama sysname Jenis kategori. Salah satu LOKAL, MULTI-SERVER, atau TIDAK ADA
nama nama sysname Nama kategori

Keterangan

sp_help_category harus dijalankan dari database msdb .

Jika tidak ada parameter yang ditentukan, kumpulan hasil memberikan informasi tentang semua kategori pekerjaan.

Izin

Secara default, anggota peran server tetap sysadmin dapat menjalankan prosedur tersimpan ini. Pengguna lain harus diberikan salah satu peran database tetap SQL Server Agent berikut dalam database msdb:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Untuk detail tentang izin peran ini, lihat SQL Server Agent Peran Database Tetap.

Contoh

A. Mengembalikan informasi pekerjaan lokal

Contoh berikut mengembalikan informasi tentang pekerjaan yang dikelola secara lokal.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_category  
    @type = N'LOCAL' ;  
GO  

B. Mengembalikan informasi pemberitahuan

Contoh berikut mengembalikan informasi tentang kategori pemberitahuan Replikasi.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_category  
    @class = N'ALERT',  
    @name = N'Replication' ;  
GO  

Lihat juga

sp_add_category (Transact-SQL)
sp_delete_category (Transact-SQL)
sp_update_category (Transact-SQL)
Prosedur Tersimpan Sistem (Transact-SQL)