sp_add_category (T-SQL)

Berlaku untuk:SQL ServerAzure SQL Managed Instance

Menambahkan kategori pekerjaan, pemberitahuan, atau operator yang ditentukan ke server. Untuk metode alternatif, lihat Membuat Kategori Pekerjaan menggunakan SQL Server Management Studio.

Konvensi sintaks transact-SQL

Penting

Pada Azure SQL Managed Instance, sebagian besar, tetapi tidak semua fitur SQL Server Agent saat ini didukung. Lihat Perbedaan T-SQL Azure SQL Managed Instance dari SQL Server untuk detailnya.

Sintaks

sp_add_category
     [ [ @class = ] 'class' ]
     [ , [ @type = ] 'type' ]
     [ , [ @name = ] 'name' ]
[ ; ]

Argumen

[ @class = ] 'kelas'

Kelas kategori yang akan ditambahkan. @class adalah varchar(8) dengan nilai JOBdefault , dan dapat menjadi salah satu nilai ini.

Nilai Deskripsi
JOB Menambahkan kategori pekerjaan.
ALERT Menambahkan kategori pemberitahuan.
OPERATOR Menambahkan kategori operator.

[ @type = ] 'type'

Jenis kategori yang akan ditambahkan. @type adalah varchar(12), dengan nilai LOCALdefault , 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 = ] 'nama'

Nama kategori yang akan ditambahkan. Nama harus unik dalam kelas yang ditentukan. @name adalah sysname, tanpa default.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Tidak ada.

Keterangan

sp_add_category harus dijalankan dari msdb database.

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 membuat kategori pekerjaan lokal bernama AdminJobs.

USE msdb;
GO

EXEC dbo.sp_add_category
    @class = N'JOB',
    @type = N'LOCAL',
    @name = N'AdminJobs';
GO