Agen Rekam Jepret Replikasi
Berlaku untuk:
SQL ServerAzure SQL Database
Agen Replikasi Snapshot adalah file yang dapat dieksekusi yang menyiapkan file Snapshot yang berisi skema dan data tabel dan objek database yang diterbitkan, menyimpan file di folder Snapshot, dan mencatat pekerjaan sinkronisasi dalam database distribusi.
Catatan
- Parameter dapat ditentukan dalam urutan apa pun.
Catatan
Azure SQL Managed Instance dapat menjadi penerbit, distributor, dan pelanggan untuk rekam jepret dan replikasi transaksional. Database di Azure SQL Database hanya dapat menjadi pelanggan pendorongan untuk rekam jepret dan replikasi transaksional. Untuk informasi selengkapnya, lihat Replikasi transaksional dengan Azure SQL Database dan Azure SQL Managed Instance.
Sintaks
snapshot [ -?]
-Publisher server_name[\instance_name]
-Publication publication_name
[-70Subscribers]
[-BcpBatchSize bcp_batch_size]
[-DefinitionFile def_path_and_file_name]
[-Distributor server_name[\instance_name]]
[-DistributorDeadlockPriority [-1|0|1] ]
[-DistributorLogin distributor_login]
[-DistributorPassword distributor_password]
[-DistributorSecurityMode [0|1] ]
[-DynamicFilterHostName dynamic_filter_host_name]
[-DynamicFilterLogin dynamic_filter_login]
[-DynamicSnapshotLocation dynamic_snapshot_location]
[-EncryptionLevel [0|1|2]]
[-FieldDelimiter field_delimiter]
[-HistoryVerboseLevel [0|1|2|3] ]
[-HRBcpBlocks number_of_blocks ]
[-HRBcpBlockSize block_size ]
[-HRBcpDynamicBlocks ]
[-KeepAliveMessageInterval keep_alive_interval]
[-LoginTimeOut login_time_out_seconds]
[-MaxBcpThreads number_of_threads ]
[-MaxNetworkOptimization [0|1]]
[-Output output_path_and_file_name]
[-OutputVerboseLevel [0|1|2] ]
[-PacketSize packet_size]
[-PrefetchTables [0|1] ]
[-ProfileName profile_name]
[-PublisherDB publisher_database]
[-PublisherDeadlockPriority [-1|0|1] ]
[-PublisherFailoverPartner server_name[\instance_name] ]
[-PublisherLogin publisher_login]
[-PublisherPassword publisher_password]
[-PublisherSecurityMode [0|1] ]
[-QueryTimeOut query_time_out_seconds]
[-ReplicationType [1|2] ]
[-RowDelimiter row_delimiter]
[-StartQueueTimeout start_queue_timeout_seconds]
[-UsePerArticleContentsView use_per_article_contents_view]
Argumen
-?
Mencetak semua parameter yang tersedia.
-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.
-Publikasi publikasi
Adalah nama publikasi. Parameter ini hanya valid jika publikasi diatur untuk selalu memiliki rekam jepret yang tersedia untuk langganan baru atau yang diinisialisasi ulang.
-70Subscriber
Harus digunakan jika ada Pelanggan yang menjalankan SQL Server versi 7.0.
-BcpBatchSize bcp_ batch_ size
Adalah jumlah baris yang akan dikirim dalam operasi penyalinan massal. Saat melakukan operasi bcp , ukuran batch adalah jumlah baris yang akan dikirim ke server sebagai satu transaksi, dan juga jumlah baris yang harus dikirim sebelum Agen Distribusi mencatat pesan kemajuan bcp . Saat melakukan operasi bcp out , ukuran batch tetap 1000 digunakan. Nilai 0 menunjukkan tidak ada pengelogan pesan.
-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.
-DistributorDeadlockPriority [-1|0|1]
Adalah prioritas koneksi Agen Rekam Jepret ke Distributor ketika kebuntuan terjadi. Parameter ini ditentukan untuk mengatasi kebuntuan yang mungkin terjadi antara Agen Rekam Jepret dan aplikasi pengguna selama pembuatan rekam jepret.
| Nilai DistributorDeadlockPriority | Deskripsi |
|---|---|
| -1 | Aplikasi selain Agen Rekam Jepret memiliki prioritas ketika kebuntuan terjadi di Distributor. |
| 0 (Default) | Prioritas tidak ditetapkan. |
| 1 | Agen Rekam Jepret memiliki prioritas ketika kebuntuan terjadi di Distributor. |
-DistributorLogin distributor_login
Apakah login digunakan saat menyambungkan ke Distributor menggunakan Autentikasi SQL Server.
-DistributorPassword distributor_password
Apakah kata sandi digunakan saat menyambungkan ke Distributor menggunakan Autentikasi SQL Server. .
-DistributorSecurityMode [ 0| 1]
Menentukan mode keamanan Distributor. Nilai 0 menunjukkan Mode Autentikasi SQL Server (default), dan nilai 1 menunjukkan Mode Autentikasi Windows.
-DynamicFilterHostName dynamic_filter_host_name
Digunakan untuk mengatur nilai untuk HOST_NAME (Transact-SQL) dalam pemfilteran saat rekam jepret dinamis dibuat. Misalnya, jika klausa rep_id = HOST_NAME() filter subset ditentukan untuk artikel, dan Anda mengatur properti DynamicFilterHostName ke "FBJones" sebelum memanggil Agen Penggabungan, hanya baris yang memiliki "FBJones" di kolom rep_id yang akan direplikasi.
-DynamicFilterLogin dynamic_filter_login
Digunakan untuk mengatur nilai untuk SUSER_SNAME (Transact-SQL) dalam pemfilteran saat rekam jepret dinamis dibuat. Misalnya, jika klausul user_id = SUSER_SNAME() filter subset ditentukan untuk artikel, dan Anda mengatur properti DynamicFilterLogin ke "rsmith" sebelum memanggil metode Jalankan objek SQLSnapshot, hanya baris yang memiliki "rsmith" di kolom user_id yang akan disertakan dalam rekam jepret.
-DynamicSnapshotLocation dynamic_snapshot_location
Adalah lokasi di mana rekam jepret dinamis harus dihasilkan.
-EncryptionLevel [ 0 | 1 | 2 ]
Adalah tingkat Keamanan Lapisan Transportasi (TLS), yang sebelumnya dikenal sebagai Secure Sockets Layer (SSL), enkripsi yang digunakan oleh Agen Rekam Jepret saat membuat koneksi.
| Nilai EncryptionLevel | Deskripsi |
|---|---|
| 0 | Menentukan bahwa TLS tidak digunakan. |
| 1 | Menentukan bahwa TLS digunakan, tetapi agen tidak memverifikasi bahwa sertifikat server TLS/SSL ditandatangani oleh penerbit tepercaya. |
| 2 | Menentukan bahwa TLS digunakan, dan bahwa sertifikat diverifikasi. |
Catatan
Sertifikat TLS/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 Menampilkan dan mengubah pengaturan keamanan replikasi.
-FieldDelimiter field_delimiter
Adalah urutan karakter atau karakter yang menandai akhir bidang dalam file data salinan massal SQL Server. Defaultnya adalah \n<x$3>\n.
-HistoryVerboseLevel [ 1| 2| 3]
Menentukan jumlah riwayat yang dicatat selama operasi rekam jepret. Anda dapat meminimalkan efek pencatatan riwayat pada performa dengan memilih 1.
| Nilai HistoryVerboseLevel | Deskripsi |
|---|---|
| 0 | Pesan kemajuan ditulis baik ke konsol atau ke file output. Rekaman riwayat tidak dicatat dalam database distribusi. |
| 1 | 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 (default) | Sisipkan rekaman riwayat baru kecuali rekaman untuk hal-hal seperti pesan diam atau pesan pekerjaan yang berjalan lama, dalam hal ini memperbarui rekaman sebelumnya. |
| 3 | Selalu sisipkan rekaman baru, kecuali untuk pesan diam. |
-HRBcpBlocks number_of_blocks
Adalah jumlah blok data bcp yang diantrekan antara utas penulis dan pembaca. Nilai defaultnya adalah 50. HRBcpBlocks hanya digunakan dengan publikasi Oracle.
Catatan
Parameter ini digunakan untuk penyetelan performa performa bcp dari Oracle Publisher.
-HRBcpBlockSizeblock_size
Adalah ukurannya, dalam kilobyte (KB), dari setiap blok data bcp . Nilai defaultnya adalah 64 KB. HRBcpBlocks hanya digunakan dengan publikasi Oracle.
Catatan
Parameter ini digunakan untuk penyetelan performa performa bcp dari Oracle Publisher.
-HRBcpDynamicBlocks
Apakah ukuran setiap blok data bcp dapat tumbuh secara dinamis atau tidak. HRBcpBlocks hanya digunakan dengan publikasi Oracle.
Catatan
Parameter ini digunakan untuk penyetelan performa performa bcp dari Oracle Publisher.
-KeepAliveMessageInterval keep_alive_interval
Adalah jumlah waktu, dalam detik, bahwa Agen Rekam Jepret menunggu sebelum mencatat "menunggu pesan backend" ke tabel MSsnapshot_history . Nilai defaultnya adalah 300 detik.
-LoginTimeOut login_time_out_seconds
Adalah jumlah detik sebelum waktu masuk habis. Defaultnya adalah 15 detik.
-MaxBcpThreads number_of_threads
Menentukan jumlah operasi penyalinan massal yang dapat dilakukan secara paralel. Jumlah maksimum utas dan koneksi ODBC yang ada secara bersamaan adalah lebih sedikit dari MaxBcpThreads atau jumlah permintaan salinan massal yang muncul dalam transaksi sinkronisasi dalam database distribusi. MaxBcpThreads harus memiliki nilai yang lebih besar dari 0 dan tidak memiliki batas atas yang dikodekan secara permanen. Defaultnya adalah dua kali jumlah prosesor.
Catatan
Jika objek yang direplikasi memiliki filter, maka agen Snapshot hanya akan menghasilkan satu file BCP untuk artikel tersebut alih-alih menghasilkan beberapa file BCP.
- MaxNetworkOptimization [ 0| 1]
Apakah jika penghapusan yang tidak relevan dikirim ke Pelanggan. Penghapusan yang tidak relevan adalah perintah DELETE yang dikirim ke Pelanggan untuk baris yang bukan milik partisi Pelanggan. Penghapusan yang tidak relevan tidak memengaruhi integritas atau konvergensi data, tetapi dapat mengakibatkan lalu lintas jaringan yang tidak perlu. Nilai default MaxNetworkOptimization adalah 0. Mengatur MaxNetworkOptimization ke 1 meminimalkan kemungkinan penghapusan yang tidak relevan sehingga mengurangi lalu lintas jaringan dan memaksimalkan pengoptimalan jaringan. Mengatur parameter ini ke 1 juga dapat meningkatkan penyimpanan metadata dan menyebabkan penurunan performa di Publisher jika ada beberapa tingkat filter gabungan dan filter subset yang kompleks. Anda harus menilai topologi replikasi Anda dengan hati-hati dan mengatur MaxNetworkOptimization ke 1 hanya jika lalu lintas jaringan dari penghapusan yang tidak relevan tidak dapat diterima tinggi.
Catatan
Mengatur parameter ini ke 1 hanya berguna ketika opsi pengoptimalan sinkronisasi publikasi penggabungan diatur ke true ( @keep_partition_changes** parameter sp_addmergepublication (Transact-SQL)).
-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]
Menentukan apakah output harus verbose.
| Nilai OutputVerboseLevel | Deskripsi |
|---|---|
| 0 | Hanya pesan kesalahan yang dicetak. |
| 1 (default) | Semua pesan laporan kemajuan dicetak (default). |
| 2 | Semua pesan kesalahan dan pesan laporan kemajuan dicetak, yang berguna untuk penelusuran kesalahan. |
-PacketSize packet_size
Adalah ukuran paket (dalam byte) yang digunakan oleh Agen Rekam Jepret saat menyambungkan ke SQL Server. Nilai defaultnya adalah 8192 byte.
Catatan
Jangan mengubah ukuran paket kecuali Anda yakin bahwa itu akan meningkatkan performa. Untuk sebagian besar aplikasi, ukuran paket default adalah yang terbaik.
-PrefetchTables [ 0| 1]
Parameter opsional yang menentukan apakah objek tabel akan diambil sebelumnya dan di-cache. Perilaku defaultnya adalah melakukan prefetch properti tabel tertentu menggunakan komponen SMO berdasarkan perhitungan internal. Parameter ini dapat membantu dalam skenario di mana operasi prefetch SMO membutuhkan waktu cukup lama untuk dijalankan. Jika parameter ini tidak digunakan, keputusan ini dibuat pada runtime berdasarkan persentase tabel yang ditambahkan sebagai artikel ke publikasi.
| Nilai OutputVerboseLevel | Deskripsi |
|---|---|
| 0 | Panggilan ke metode Prefetch komponen SMO dinonaktifkan. |
| 1 | Agen Rekam Jepret akan memanggil metode Prefetch untuk menyimpan beberapa properti tabel menggunakan SMO |
-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.
-PublisherDB publisher_database
Adalah nama database publikasi. Parameter ini tidak didukung untuk Oracle Publishers.
-PublisherDeadlockPriority [-1|0|1]
Adalah prioritas koneksi Agen Rekam Jepret ke Penerbit saat kebuntuan terjadi. Parameter ini ditentukan untuk mengatasi kebuntuan yang mungkin terjadi antara Agen Rekam Jepret dan aplikasi pengguna selama pembuatan rekam jepret.
| Nilai PublisherDeadlockPriority | Deskripsi |
|---|---|
| -1 | Aplikasi selain Agen Rekam Jepret memiliki prioritas ketika kebuntuan terjadi di Publisher. |
| 0 (Default) | Prioritas tidak ditetapkan. |
| 1 | Agen Rekam Jepret memiliki prioritas ketika kebuntuan terjadi di Publisher. |
-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).
-PublisherLogin publisher_login
Apakah login digunakan saat menyambungkan ke Publisher menggunakan Autentikasi SQL Server.
-PublisherPassword publisher_password
Apakah kata sandi digunakan saat menyambungkan ke Publisher menggunakan Autentikasi SQL Server. .
-PublisherSecurityMode [ 0| 1]
Menentukan mode keamanan Publisher. Nilai 0 menunjukkan Autentikasi SQL Server (default), dan nilai 1 menunjukkan Mode Autentikasi Windows.
-QueryTimeOut query_time_out_seconds
Adalah jumlah detik sebelum waktu kueri habis. Defaultnya adalah 1800 detik.
-ReplicationType [ 12| ]
Menentukan jenis replikasi. Nilai 1 menunjukkan replikasi transaksional, dan nilai 2 menunjukkan replikasi penggabungan.
-RowDelimiter row_delimiter
Adalah urutan karakter atau karakter yang menandai akhir baris dalam file data salinan massal SQL Server. Defaultnya adalah \n<,@g>\n.
-StartQueueTimeout start_queue_timeout_seconds
Adalah jumlah detik maksimum yang ditunggu Agen Rekam Jepret ketika jumlah proses rekam jepret dinamis bersamaan yang berjalan berada pada batas yang ditetapkan oleh @max_concurrent_dynamic_snapshots properti sp_addmergepublication (Transact-SQL). Jika jumlah detik maksimum tercapai dan Agen Rekam Jepret masih menunggu, itu akan keluar. Nilai 0 berarti bahwa agen menunggu tanpa batas waktu, meskipun dapat dibatalkan.
- UsePerArticleContentsView use_per_article_contents_view
Parameter ini tidak digunakan lagi dan hanya didukung untuk kompatibilitas mundur.
Keterangan
Penting
Jika Anda telah menginstal SQL Server Agent untuk dijalankan di bawah akun Sistem Lokal daripada di bawah akun Pengguna Domain (default), layanan hanya dapat mengakses komputer lokal. Jika Agen Rekam Jepret yang berjalan di bawah SQL Server Agent dikonfigurasi untuk menggunakan Mode Autentikasi Windows saat masuk ke SQL Server, Agen Rekam Jepret gagal. Pengaturan defaultnya adalah Autentikasi SQL Server.
Untuk memulai Agen Rekam Jepret, jalankan snapshot.exe dari prompt perintah. Untuk informasi, lihat Agen Replikasi Yang Dapat Dieksekusi.