sp_changelogreader_agent (T-SQL)

Berlaku untuk:SQL ServerAzure SQL Managed Instance

Mengubah properti keamanan agen Pembaca Log. Prosedur tersimpan ini dijalankan di Publisher pada database publikasi.

Penting

Saat mengonfigurasi Penerbit dengan Distributor jarak jauh, nilai yang disediakan untuk semua parameter, termasuk job_login dan job_password, dikirim ke Distributor sebagai teks biasa. Anda harus mengenkripsi koneksi antara Publisher dan Distributor jarak jauhnya sebelum menjalankan prosedur tersimpan ini. Untuk informasi selengkapnya, lihat Mengaktifkan Koneksi terenkripsi ke Mesin Database (Pengelola Konfigurasi SQL Server).

Sintaks

  
sp_changelogreader_agent [ [ @job_login = ] 'job_login' ]  
    [ , [ @job_password = ] 'job_password' ]  
    [ , [ @publisher_security_mode = ] publisher_security_mode ]  
    [ , [ @publisher_login = ] 'publisher_login' ]  
    [ , [ @publisher_password = ] 'publisher_password' ]   
    [ , [ @publisher = ] 'publisher' ]  

Argumen

[ @job_login = ] 'job_login' Adalah login untuk akun tempat agen berjalan. job_login adalah nvarchar(257), dengan default NULL. Di Azure SQL Managed Instance, gunakan akun SQL Server. Ini tidak dapat diubah untuk penerbit non-Microsoft SQL Server .

[ @job_password = ] 'job_password' Adalah kata sandi untuk akun tempat agen berjalan. job_password adalah sysname, dengan default NULL.

Penting

Jika memungkinkan, minta pengguna untuk memasukkan kredensial keamanan saat runtime. Jika Anda harus menyimpan kredensial dalam file skrip, Anda harus mengamankan file untuk mencegah akses yang tidak sah.

[ @publisher_security_mode = ] publisher_security_mode

Catatan

ID Microsoft Entra sebelumnya dikenal sebagai Azure Active Directory (Azure AD).

Adalah mode keamanan yang digunakan oleh agen saat menyambungkan ke Publisher. publisher_security_mode kecil, dengan default NULL. Nilai berikut menentukan mode keamanan:

• 0 menentukan Autentikasi SQL Server.
• 1 menentukan autentikasi Windows.
• 2 menentukan autentikasi kata sandi Microsoft Entra yang dimulai dengan SQL Server 2022 (16.x) CU 6.
• 3 menentukan autentikasi terintegrasi Microsoft Entra yang dimulai dengan SQL Server 2022 (16.x) CU 6.
• 4 menentukan autentikasi token Microsoft Entra yang dimulai dengan SQL Server 2022 (16.x) CU 6.

Penting

Jika memungkinkan, gunakan autentikasi Windows.

[ @publisher_login = ] 'publisher_login' Apakah login digunakan saat menyambungkan ke Publisher. publisher_login adalah sysname, dengan default NULL. publisher_login harus ditentukan ketika publisher_security_mode adalah 0. Jika publisher_login NULL dan publisher_security_mode adalah 1, maka akun Windows yang ditentukan dalam job_login digunakan saat menyambungkan ke Publisher.

[ @publisher_password = ] 'publisher_password' Apakah kata sandi digunakan saat menyambungkan ke Publisher. publisher_password adalah sysname, dengan default NULL.

Penting

Jangan gunakan kata sandi kosong. Gunakan kata sandi yang kuat. Jika memungkinkan, minta pengguna untuk memasukkan kredensial keamanan saat runtime. Jika Anda harus menyimpan kredensial dalam file skrip, Anda harus mengamankan file untuk mencegah akses yang tidak sah.

[ @publisher = ] 'publisher' Adalah nama Penerbit. publisher adalah sysname, dengan default NULL. Parameter ini hanya didukung untuk Penerbit non-SQL Server.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Keterangan

sp_changelogreader_agent digunakan dalam replikasi transaksional.

sp_changelogreader_agent digunakan untuk mengubah akun Windows tempat agen Pembaca Log berjalan. Anda dapat mengubah kata sandi log masuk Windows yang ada atau menyediakan log masuk dan kata sandi Windows baru.

Setelah mengubah login atau kata sandi agen, Anda harus menghentikan dan memulai ulang agen sebelum perubahan berlaku.

Izin

Hanya anggota peran server tetap sysadmin atau peran database tetap db_owner yang dapat menjalankan sp_changelogreader_agent.

Lihat Juga

Menampilkan dan Mengubah Pengaturan Keamanan Replikasi
sp_helplogreader_agent (T-SQL)
sp_addlogreader_agent (T-SQL)