Agen Pembaca Log Replikasi
Agen Pembaca Log Replikasi adalah executable yang memantau log transaksi setiap database yang dikonfigurasi untuk replikasi transaksional dan menyalin transaksi yang ditandai untuk replikasi dari log transaksi ke database distribusi.
Catatan
Parameter dapat ditentukan dalam urutan apa pun. Ketika parameter opsional tidak ditentukan, nilai yang telah ditentukan sebelumnya berdasarkan profil agen default digunakan.
Sintaks
logread [-?]
-Publisherserver_name[\instance_name]
-PublisherDBpublisher_database
[-Continuous]
[-DefinitionFiledef_path_and_file_name]
[-Distributorserver_name[\instance_name]]
[-DistributorLogindistributor_login]
[-DistributorPassworddistributor_password]
[-DistributorSecurityMode [0|1]]
[-EncryptionLevel [0|1|2]]
[-ExtendedEventConfigFileconfiguration_path_and_file_name]
[-HistoryVerboseLevel [0|1|2]]
[-KeepAliveMessageIntervalkeep_alive_message_interval_seconds]
[-LoginTimeOutlogin_time_out_seconds]
[-LogScanThresholdscan_threshold]
[-MaxCmdsInTrannumber_of_commands]
[-MessageIntervalmessage_interval]
[-Outputoutput_path_and_file_name]
[-OutputVerboseLevel [0|1|2|3|4]]
[-PacketSizepacket_size]
[-PollingIntervalpolling_interval]
[-ProfileNameprofile_name]
[-PublisherFailoverPartnerserver_name[\instance_name] ]
[-PublisherSecurityMode [0|1]]
[-PublisherLoginpublisher_login]
[-PublisherPasswordpublisher_password]
[-QueryTimeOutquery_time_out_seconds]
[-ReadBatchSizenumber_of_transactions]
[-ReadBatchThresholdread_batch_threshold]
[-RecoverFromDataErrors]
Argumen
-?
Menampilkan informasi penggunaan.
-Publisher server_name[\instance_name]
Adalah nama Penerbit. Tentukan server_name untuk instans default Microsoft SQL Server di server tersebut. Tentukan instance_name server_name\ untuk instans SQL Server bernama di server tersebut.
-PublisherDB publisher_database
Adalah nama database Publisher.
-Terus-menerus
Menentukan apakah agen mencoba melakukan polling transaksi yang direplikasi secara berkelanjutan. Jika ditentukan, agen melakukan polling transaksi yang direplikasi dari sumber pada interval polling bahkan jika tidak ada transaksi yang tertunda.
-DefinitionFile def_path_and_file_name
Adalah jalur file definisi agen. File definisi agen berisi argumen baris perintah untuk agen. Konten file diurai sebagai file yang dapat dieksekusi. Gunakan tanda kutip ganda (") untuk menentukan nilai argumen yang berisi karakter arbitrer.
-Distributor server_name[\instance_name]
Adalah nama Distributor. Tentukan server_name untuk instans default SQL Server di server tersebut. Tentukan instance_name server_name\ untuk instans SQL Server bernama di server tersebut.
-DistributorLogin distributor_login
Adalah nama login Distributor.
-DistributorPassword distributor_password
Adalah kata sandi Distributor.
-DistributorSecurityMode [ 0| 1]
Menentukan mode keamanan Distributor. Nilai 0 menunjukkan Mode Autentikasi SQL Server (default), dan nilai 1 menunjukkan Mode Autentikasi Microsoft Windows.
-EncryptionLevel [ 0 | 1 | 2 ]
Adalah tingkat enkripsi Secure Sockets Layer (SSL) yang digunakan oleh Agen Pembaca Log saat membuat koneksi.
| Nilai EncryptionLevel | Deskripsi |
|---|---|
| 0 | Menentukan bahwa SSL tidak digunakan. |
| 1 | Menentukan bahwa SSL digunakan, tetapi agen tidak memverifikasi bahwa sertifikat server SSL ditandatangani oleh penerbit tepercaya. |
| 2 | Menentukan bahwa SSL digunakan, dan bahwa sertifikat diverifikasi. |
Catatan
Sertifikat SSL yang valid ditentukan dengan nama domain SQL Server yang sepenuhnya memenuhi syarat. Agar agen berhasil tersambung saat mengatur -EncryptionLevel ke 2, buat alias di SQL Server lokal. Parameter 'Nama Alias' harus berupa nama server dan parameter 'Server' harus diatur ke nama SQL Server yang sepenuhnya memenuhi syarat.
Untuk informasi selengkapnya, lihat Keamanan Replikasi SQL Server.
-ExtendedEventConfigFile configuration_path_and_file_name
Menentukan jalur dan nama file untuk file konfigurasi XML peristiwa yang diperluas. File konfigurasi peristiwa yang diperluas memungkinkan Anda mengonfigurasi sesi dan mengaktifkan peristiwa untuk pelacakan.
-HistoryVerboseLevel [ 0| 1| 2]
Menentukan jumlah riwayat yang dicatat selama operasi pembaca log. Anda dapat meminimalkan efek performa pengelogan riwayat dengan memilih 1.
| Nilai HistoryVerboseLevel | Deskripsi |
|---|---|
| 0 | |
| 1 | Default. Selalu perbarui pesan riwayat sebelumnya dengan status yang sama (startup, progress, success, dan sebagainya). Jika tidak ada rekaman sebelumnya dengan status yang sama, sisipkan rekaman baru. |
| 2 | Sisipkan rekaman riwayat baru kecuali rekaman untuk hal-hal seperti pesan diam atau pesan pekerjaan yang berjalan lama, dalam hal ini memperbarui rekaman sebelumnya. |
-KeepAliveMessageInterval keep_alive_message_interval_seconds
Adalah jumlah detik sebelum utas riwayat memeriksa apakah salah satu koneksi yang ada sedang menunggu respons dari server. Nilai ini dapat dikurangi untuk menghindari agen pemeriksaan menandai Agen Pembaca Log sebagai tersangka saat menjalankan batch yang berjalan lama. Defaultnya adalah 300 detik.
-LoginTimeOut login_time_out_seconds
Adalah jumlah detik sebelum waktu masuk habis. Defaultnya adalah 15 detik.
-LogScanThreshold scan_threshold
Penggunaan internal saja.
-MaxCmdsInTran number_of_commands
Menentukan jumlah maksimum pernyataan yang dikelompokkan ke dalam transaksi saat Pembaca Log menulis perintah ke database distribusi. Menggunakan parameter ini memungkinkan Agen Pembaca Log dan Agen Distribusi untuk membagi transaksi besar (terdiri dari banyak perintah) di Penerbit menjadi beberapa transaksi yang lebih kecil saat diterapkan di Pelanggan. Menentukan parameter ini dapat mengurangi ketidakcocokan di Distributor dan mengurangi latensi antara Penerbit dan Pelanggan. Karena transaksi asli diterapkan dalam unit yang lebih kecil, Pelanggan dapat mengakses baris transaksi Penerbit logis besar sebelum akhir transaksi asli, melanggar atomitas transaksional yang ketat. Defaultnya adalah 0, yang mempertahankan batas transaksi Publisher.
Catatan
Parameter ini diabaikan untuk publikasi non-SQL Server. Untuk informasi selengkapnya, lihat bagian "Mengonfigurasi Pekerjaan Set Transaksi" di Penyetelan Performa untuk Penerbit Oracle.
-MessageInterval message_interval
Adalah interval waktu yang digunakan untuk pengelogan riwayat. Peristiwa riwayat dicatat ketika nilai MessageInterval tercapai setelah peristiwa riwayat terakhir dicatat.
Jika tidak ada transaksi yang direplikasi yang tersedia di sumbernya, agen melaporkan pesan tanpa transaksi ke Distributor. Opsi ini menentukan berapa lama agen menunggu sebelum melaporkan pesan tanpa transaksi lain. Agen selalu melaporkan pesan tidak ada transaksi ketika mereka mendeteksi bahwa tidak ada transaksi yang tersedia di sumber setelah sebelumnya memproses transaksi yang direplikasi. Defaultnya adalah 60 detik.
-Output output_path_and_file_name
Adalah jalur file output agen. Jika nama file tidak disediakan, output dikirim ke konsol. Jika nama file yang ditentukan ada, output ditambahkan ke file.
-OutputVerboseLevel [ 0| 1| 2 | 3 | 4 ]
Menentukan apakah output harus verbose.
| Nilai | Deskripsi |
|---|---|
| 0 | Hanya pesan kesalahan yang dicetak. |
| 1 | Semua pesan laporan kemajuan agen dicetak. |
| 2 (default) | Semua pesan kesalahan dan pesan laporan kemajuan agen dicetak. |
| 3 | 100 byte pertama dari setiap perintah yang direplikasi dicetak. |
| 4 | Semua perintah yang direplikasi dicetak. |
Nilai 2-4 berguna saat penelusuran kesalahan.
-PacketSize packet_size
Apakah ukuran paket, dalam byte. Defaultnya adalah 4096 (byte).
-PollingInterval polling_interval
Apakah seberapa sering, dalam detik, log dikueri untuk transaksi yang direplikasi. Defaultnya adalah 5 detik.
-ProfileName profile_name
Menentukan profil agen yang akan digunakan untuk parameter agen. Jika ProfileName NULL, profil agen dinonaktifkan. Jika ProfileName tidak ditentukan, profil default untuk jenis agen akan digunakan. Untuk informasi, lihat Profil Agen Replikasi.
-PublisherFailoverPartner server_name[\instance_name]
Menentukan instans mitra failover SQL Server yang berpartisipasi dalam sesi pencerminan database dengan database publikasi. Untuk informasi selengkapnya, lihat Pencerminan dan Replikasi Database (SQL Server).
-PublisherSecurityMode [ 0| 1]
Menentukan mode keamanan Publisher. Nilai 0 menunjukkan Autentikasi SQL Server (default), dan nilai 1 menunjukkan Mode Autentikasi Windows.
-PublisherLogin publisher_login
Adalah nama masuk Publisher.
-PublisherPassword publisher_password
Adalah kata sandi Publisher.
-QueryTimeOut query_time_out_seconds
Adalah jumlah detik sebelum waktu kueri habis. Defaultnya adalah 1800 detik.
-ReadBatchSize number_of_transactions
Adalah jumlah maksimum transaksi yang dibaca dari log transaksi database penerbitan per siklus pemrosesan, dengan default 500. Agen akan terus membaca transaksi dalam batch sampai semua transaksi dibaca dari log. Parameter ini tidak didukung untuk Oracle Publishers.
-ReadBatchThreshold number_of_commands
Adalah jumlah perintah replikasi yang akan dibaca dari log transaksi sebelum dikeluarkan kepada Pelanggan oleh Agen Distribusi. Defaultnya adalah 0. Jika parameter ini tidak ditentukan, Agen Pembaca Log akan membaca ke akhir log atau ke nomor yang ditentukan dalam -ReadBatchSize (jumlah transaksi).
-RecoverFromDataErrors
Menentukan bahwa Agen Pembaca Log terus berjalan ketika mengalami kesalahan dalam data kolom yang diterbitkan dari Penerbit non-SQL Server. Secara default, kesalahan tersebut menyebabkan Agen Pembaca Log gagal. Saat Anda menggunakan -RecoverFromDataErrors, data kolom yang salah direplikasi baik sebagai NULL atau nilai nonnull yang sesuai, dan pesan peringatan dicatat ke tabel MSlogreader_history . Parameter ini hanya didukung untuk Oracle Publishers.
Keterangan
Penting
Jika Anda menginstal SQL Server Agent untuk dijalankan di bawah akun sistem lokal alih-alih di bawah akun pengguna domain (default), layanan hanya dapat mengakses komputer lokal. Jika Agen Pembaca Log yang berjalan di bawah SQL Server Agent dikonfigurasi untuk menggunakan Mode Autentikasi Windows saat masuk ke SQL Server, Agen Pembaca Log gagal. Pengaturan defaultnya adalah Autentikasi SQL Server. Untuk informasi tentang mengubah akun keamanan, lihat Menampilkan dan Mengubah Pengaturan Keamanan Replikasi.
Untuk memulai Agen Pembaca Log, jalankan logread.exe dari prompt perintah. Untuk informasi, lihat Konsep Executables Agen Replikasi.
Ubah Riwayat
| Konten yang diperbarui |
|---|
| Menambahkan parameter -ExtendedEventConfigFile. |