Bagikan melalui

sp_add_proxy (T-SQL)

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 atau NULL 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

Anda dapat memberikan EXECUTE izin pada prosedur ini, tetapi izin ini mungkin 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 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.

USE msdb;
GO

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

Konten terkait

  • Last updated on