Bagikan melalui

sp_add_operator (T-SQL)

  • Artikel

Berlaku untuk: SQL Server Azure SQL Managed Instance

Membuat operator (penerima pemberitahuan) untuk digunakan dengan pemberitahuan dan pekerjaan.

Konvensi sintaks transact-SQL

Sintaks

sp_add_operator
    [ @name = ] 'name'
    [ , [ @enabled = ] enabled ]
    [ , [ @email_address = ] N'email_address' ]
    [ , [ @pager_address = ] N'pager_address' ]
    [ , [ @weekday_pager_start_time = ] weekday_pager_start_time ]
    [ , [ @weekday_pager_end_time = ] weekday_pager_end_time ]
    [ , [ @saturday_pager_start_time = ] saturday_pager_start_time ]
    [ , [ @saturday_pager_end_time = ] saturday_pager_end_time ]
    [ , [ @sunday_pager_start_time = ] sunday_pager_start_time ]
    [ , [ @sunday_pager_end_time = ] sunday_pager_end_time ]
    [ , [ @pager_days = ] pager_days ]
    [ , [ @netsend_address = ] N'netsend_address' ]
    [ , [ @category_name = ] 'category' ]
[ ; ]

Argumen

[ @name = ] 'nama'

Nama operator (penerima pemberitahuan). Nama ini harus unik dan tidak boleh berisi karakter persen (%). @name adalah sysname, tanpa default.

[ @enabled = ] diaktifkan

Menunjukkan status operator saat ini. @enabled kecil, dengan default 1 (diaktifkan). Jika 0, operator tidak diaktifkan dan tidak menerima pemberitahuan.

[ @email_address = ] N'email_address'

Alamat email operator. String ini diteruskan langsung ke sistem email. @email_address adalah nvarchar(100), dengan default NULL.

Anda dapat menentukan alamat email fisik atau alias untuk @email_address. Contohnya:

fatmir.bregu atau fatmir.bregu@contoso.com

Catatan

Anda harus menggunakan alamat email untuk Email Database.

[ @pager_address = ] N'pager_address'

Alamat pager operator. String ini diteruskan langsung ke sistem email. @pager_address adalah nvarchar(100), dengan default NULL.

[ @weekday_pager_start_time = ] weekday_pager_start_time

Waktu setelah itu SQL Server Agent mengirim pemberitahuan pager ke operator yang ditentukan pada hari kerja, dari Senin hingga Jumat. @weekday_pager_start_time int, dengan default 090000, yang menunjukkan 09:00 A.M. pada jam 24 jam, dan harus dimasukkan menggunakan formulir HHmmss.

[ @weekday_pager_end_time = ] weekday_pager_end_time

Waktu setelah layanan SQL Server Agent tidak lagi mengirim pemberitahuan pager ke operator yang ditentukan pada hari kerja, dari Senin hingga Jumat. weekday_pager_end_time int, dengan default 180000, yang menunjukkan 6:00 P.M. pada jam 24 jam, dan harus dimasukkan menggunakan formulir HHmmss.

[ @saturday_pager_start_time = ] saturday_pager_start_time

Waktu setelah layanan SQL Server Agent mengirim pemberitahuan pager ke operator yang ditentukan pada hari Sabtu. saturday_pager_start_time int, dengan default 090000, yang menunjukkan 09:00 A.M. pada jam 24 jam, dan harus dimasukkan menggunakan formulir HHmmss.

[ @saturday_pager_end_time = ] saturday_pager_end_time

Waktu setelah layanan SQL Server Agent tidak lagi mengirim pemberitahuan pager ke operator yang ditentukan pada hari Sabtu. @saturday_pager_end_time int, dengan default 180000, yang menunjukkan 6:00 P.M. pada jam 24 jam, dan harus dimasukkan menggunakan formulir HHmmss.

[ @sunday_pager_start_time = ] sunday_pager_start_time

Waktu setelah layanan SQL Server Agent mengirim pemberitahuan pager ke operator yang ditentukan pada hari Minggu. @sunday_pager_start_time int, dengan default 090000, yang menunjukkan 09:00 A.M. pada jam 24 jam, dan harus dimasukkan menggunakan formulir HHmmss.

[ @sunday_pager_end_time = ] sunday_pager_end_time

Waktu setelah layanan SQL Server Agent tidak lagi mengirim pemberitahuan pager ke operator yang ditentukan pada hari Minggu. @sunday_pager_end_time int, dengan default 180000, yang menunjukkan 6:00 P.M. pada jam 24 jam, dan harus dimasukkan menggunakan formulir HHmmss.

[ @pager_days = ] pager_days

Angka yang menunjukkan hari-hari operator tersedia untuk halaman (tunduk pada waktu mulai/akhir yang ditentukan). @pager_days kecil, dengan default 0 menunjukkan operator tidak pernah tersedia untuk menerima halaman. Nilai yang valid berasal dari 0 melalui 127. @pager_days dihitung dengan menambahkan nilai individual untuk hari yang diperlukan. Misalnya, dari Senin hingga Jumat adalah 2 + 4 + 8 + 16 + 32 = 62. Tabel berikut mencantumkan nilai untuk setiap hari dalam seminggu.

Nilai Deskripsi
1 Hari Minggu
2 Senin
4 Selasa
8 Rabu
16 Kamis
32 Jumat
64 Sabtu

[ @netsend_address = ] N'netsend_address'

Alamat jaringan operator yang dikirimi pesan jaringan. @netsend_address adalah nvarchar(100), dengan default NULL.

[ @category_name = ] 'kategori'

Nama kategori untuk operator ini. @category_name adalah sysname, dengan default NULL.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Tidak ada.

Keterangan

sp_add_operator harus dijalankan dari msdb database.

Sistem email Anda harus memiliki kapabilitas email-ke-pager jika Anda ingin menggunakan halaman.

SQL Server Management Studio menyediakan cara grafis yang mudah untuk mengelola pekerjaan, dan merupakan cara yang direkomendasikan untuk membuat dan mengelola infrastruktur 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.

Contoh

Contoh berikut menyiapkan informasi operator untuk danwi. Operator diaktifkan. SQL Server Agent mengirimkan pemberitahuan oleh pager dari Senin hingga Jumat dari 8 A.M. ke 5 P.M.

USE msdb;
GO

EXEC dbo.sp_add_operator @name = N'Dan Wilson',
    @enabled = 1,
    @email_address = N'danwi',
    @pager_address = N'5551290AW@pager.adventure-works.com',
    @weekday_pager_start_time = 080000,
    @weekday_pager_end_time = 170000,
    @pager_days = 62;
GO

Konten terkait