Bagikan melalui

sp_changelogreader_agent (T-SQL)

  • Artikel

Berlaku untuk: SQL Server Azure 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 Mengonfigurasi Mesin Database SQL Server untuk mengenkripsi koneksi.

Sintaks

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

Argumen

[ @job_login = ] N'job_login'

Login untuk akun tempat agen berjalan. @job_login adalah nvarchar(257), dengan default NULL. Di Azure SQL Managed Instance, gunakan akun SQL Server.

Catatan

Ini tidak dapat diubah untuk penerbit non-SQL Server.

[ @job_password = ] N'job_password'

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

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, dimulai dengan SQL Server 2022 (16.x) CU 6.
  • 3 menentukan autentikasi terintegrasi Microsoft Entra, dimulai dengan SQL Server 2022 (16.x) CU 6.
  • 4 menentukan autentikasi token Microsoft Entra, dimulai dengan SQL Server 2022 (16.x) CU 6.

Penting

Jika memungkinkan, gunakan autentikasi Windows.

[ @publisher_login = ] N'publisher_login'

Login yang 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 adalah NULL dan @publisher_security_mode adalah 1, maka akun Windows yang ditentukan dalam @job_login digunakan saat menyambungkan ke Publisher.

[ @publisher_password = ] N'publisher_password'

Kata sandi yang 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 = ] N'publisher'

Nama Publisher. @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.

Konten terkait