Bagikan melalui

sp_help_category (T-SQL)

  • Artikel

Berlaku untuk: SQL Server

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

Konvensi sintaks transact-SQL

Sintaks

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

Argumen

[ @class = ] 'kelas'

Menentukan kelas tentang informasi mana yang diminta. @class adalah varchar(8), dan bisa menjadi salah satu nilai ini.

Nilai Deskripsi
JOB (default) Menyediakan informasi tentang kategori pekerjaan.
ALERT Menyediakan informasi tentang kategori pemberitahuan.
OPERATOR Menyediakan informasi tentang kategori operator.

[ @type = ] 'type'

Jenis kategori yang informasinya diminta. @type adalah varchar(12), dan dapat menjadi salah satu nilai ini.

Nilai Deskripsi
LOCAL Kategori pekerjaan lokal.
MULTI-SERVER Kategori pekerjaan multiserver.
NONE Kategori untuk kelas selain JOB.

[ @name = ] N'name'

Nama kategori yang informasinya diminta. @name adalah sysname, dengan default NULL.

[ @suffix = ] akhiran

Menentukan apakah category_type kolom dalam kumpulan hasil adalah ID atau nama. @suffix adalah bit, dengan default 0.

  • 1category_type menunjukkan sebagai nama.
  • 0category_type menampilkan sebagai ID.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Saat @suffix adalah 0, sp_help_category mengembalikan tataan hasil berikut:

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

1 = Lokal
2 = Multiserver
3 = Tidak ada
name nama sysname Nama kategori

Saat @suffix adalah 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 dari LOCAL, MULTI-SERVER, atau NONE
name nama sysname Nama kategori

Keterangan

sp_help_category harus dijalankan dari msdb database.

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

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.

Pengguna lain harus diberikan salah satu peran database tetap SQL Server Agent berikut dalam msdb database:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

Contoh

J. 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

Konten terkait