sp_add_proxy (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Menambahkan proksi SQL Server Agent yang ditentukan.

Konvensi sintaks transact-SQL

Sintaks

sp_add_proxy
    [ @proxy_name = ] 'proxy_name'
    , [ @enabled = ] is_enabled
    , [ @description = ] 'description'
    , [ @credential_name = ] 'credential_name'
    , [ @credential_id = ] credential_id
    , [ @proxy_id = ] id OUTPUT
[ ; ]

Argumen

[ @proxy_name = ] 'proxy_name'

Nama proksi yang akan dibuat. @proxy_name adalah sysname, dengan default NULL. Saat @proxy_name adalah NULL atau string kosong, nama proksi default ke @credential_name atau @credential_id disediakan.

[ @enabled = ] is_enabled

Menentukan apakah proksi diaktifkan. Bendera @enabled kecil, dengan default 1. Saat @enabled adalah 0, proksi tidak diaktifkan, dan tidak dapat digunakan oleh langkah pekerjaan.

[ @description = ] 'deskripsi'

Deskripsi proksi. Deskripsinya adalah nvarchar(512), dengan default NULL. Deskripsi memungkinkan Anda mendokumen proksi, tetapi tidak digunakan oleh SQL Server Agent. Oleh karena itu, argumen ini bersifat opsional.

[ @credential_name = ] 'credential_name'

Nama kredensial untuk proksi. @credential_name adalah sysname, dengan default NULL. Baik @credential_name atau @credential_id harus ditentukan.

[ @credential_id = ] credential_id

Nomor identifikasi kredensial untuk proksi. @credential_id int, dengan default NULL. Baik @credential_name atau @credential_id harus ditentukan.

[ @proxy_id = ] proxy_id OUTPUT

Nomor identifikasi proksi yang ditetapkan ke proksi jika berhasil dibuat.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Tidak ada.

Keterangan

Prosedur tersimpan msdb ini harus dijalankan dalam database.

Proksi SQL Server Agent mengelola keamanan untuk langkah-langkah pekerjaan yang melibatkan subsistem selain subsistem Transact-SQL. Setiap proksi sesuai dengan kredensial keamanan. Proksi mungkin memiliki akses ke sejumlah subsistem.

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.

Anggota peran keamanan tetap sysadmin dapat membuat langkah-langkah pekerjaan yang menggunakan proksi apa pun. Gunakan prosedur tersimpan sp_grant_login_to_proxy (Transact-SQL) untuk memberikan akses masuk lain ke proksi.

Contoh

Contoh ini membuat proksi untuk kredensial CatalogApplicationCredential. Kode mengasumsikan bahwa kredensial sudah ada. Untuk informasi selengkapnya tentang kredensial, lihat MEMBUAT KREDENSIAL (Transact-SQL).

USE msdb;
GO

EXEC dbo.sp_add_proxy
    @proxy_name = 'Catalog application proxy',
    @enabled = 1,
    @description = 'Maintenance tasks on catalog application.',
    @credential_name = 'CatalogApplicationCredential';
GO

Konten terkait