Konsep Executables Agen Replikasi

  • Artikel

Berlaku untuk:SQL ServerAzure SQL Managed Instance

Agen replikasi dapat dikontrol secara terprogram dengan cara berikut:

  • Menggunakan antarmuka pemrograman agen terkelola di Microsoft.SqlServer.Replication Namespace layanan.

  • Memanggil file agen yang dapat dieksekusi dari prompt perintah dengan sekumpulan parameter yang disediakan.

Langsung memanggil agen replikasi dari prompt perintah memungkinkan agen diakses secara terprogram dari pembuatan skrip baris perintah dalam file batch. Ketika agen dipanggil dari prompt perintah, agen berjalan di bawah akun keamanan Microsoft Windows pengguna yang memanggil agen atau memulai file batch.

Instans agen replikasi berikut dapat dijalankan menggunakan file yang dapat dieksekusi.

Saat memanggil agen replikasi, Anda dapat menggunakan profil performa untuk secara otomatis meneruskan sekumpulan parameter yang ditentukan ke agen yang dapat dieksekusi. Untuk informasi selengkapnya, lihat Profil Agen Replikasi.

Contoh

Contoh berikut menunjukkan cara memanggil agen replikasi dari prompt perintah. Agen replikasi juga dapat dipanggil menggunakan Objek Manajemen Replikasi (RMO). Untuk informasi selengkapnya, lihat Menyinkronkan Langganan (Replikasi).

Catatan

Pemisah baris dalam contoh ini ditambahkan untuk meningkatkan keterbacaan. Dalam file batch, perintah harus dibuat dalam satu baris.

Menjalankan Agen Rekam Jepret

Contoh file batch ini memanggil Agen Rekam Jepret dari prompt perintah untuk menghasilkan rekam jepret untuk publikasi AdvWorksSalesOrdersMerge . (Skrip di bawah ini menggunakan jalur ke file SQL Server 2016 (13.x) (versi 130). Anda harus menyesuaikan skrip untuk menunjuk ke file untuk versi SQL Server Anda.)

REM -- Declare variables  
SET Publisher=%InstanceName%;  
SET PublicationDB=AdventureWorks2022;   
SET Publication=AdvWorksSalesOrdersMerge;   
  
REM --Start the Snapshot Agent to generate the snapshot for AdvWorksSalesOrdersMerge.  
"C:\Program Files\Microsoft SQL Server\130\COM\SNAPSHOT.EXE" -Publication %Publication%   
-Publisher %Publisher% -Distributor %Publisher% -PublisherDB %PublicationDB%   
-ReplicationType 2 -OutputVerboseLevel 1 -DistributorSecurityMode 1 ;

Menjalankan Agen Distribusi

Contoh file batch ini memanggil Agen Distribusi dari prompt perintah untuk terus mereplikasi perubahan dari publikasi AdvWorksProductTran ke pelanggan push.

REM -- Declare the variables.  
SET Publisher=%instancename%;  
SET Subscriber=%instancename%;  
SET PublicationDB=AdventureWorks2022;  
SET SubscriptionDB=AdventureWorks2022Replica;   
SET Publication=AdvWorksProductsTran;  
  
REM -- Start the Distribution Agent with four subscription streams.  
REM -- The following command must be supplied without line breaks.  
"C:\Program Files\Microsoft SQL Server\130\COM\DISTRIB.EXE" -Subscriber %Subscriber%   
-SubscriberDB %SubscriptionDB% -SubscriberSecurityMode 1 -Publication %Publication%   
-Publisher %Publisher% -PublisherDB %PublicationDB% -Distributor %Publisher%   
-DistributorSecurityMode 1 -Continuous -SubscriptionType 0 -SubscriptionStreams 4 ;

Menjalankan Agen Penggabungan

Contoh file batch ini memanggil Agen Penggabungan dari prompt perintah untuk menyinkronkan langganan penarikan ke publikasi AdvWorksSalesOrdersMerge .

REM -- Declare the variables.  
SET Publisher=%instancename%;  
SET Subscriber=%instancename%;  
SET PublicationDB=AdventureWorks2022;  
SET SubscriptionDB=AdventureWorks2022Replica;   
SET Publication=AdvWorksSalesOrdersMerge;  
  
REM --Start the Merge Agent with concurrent upload and download processes.  
REM -- The following command must be supplied without line breaks.  
"C:\Program Files\Microsoft SQL Server\130\COM\REPLMERG.EXE" -Publication %Publication%    
-Publisher %Publisher%  -Subscriber  %Subscriber%  -Distributor %Publisher%    
-PublisherDB %PublicationDB%  -SubscriberDB %SubscriptionDB% -PublisherSecurityMode 1    
-OutputVerboseLevel 2  -SubscriberSecurityMode 1  -SubscriptionType 1 -DistributorSecurityMode 1    
-Validate 3  -ParallelUploadDownload 1 ;