Çoğaltma Anlık Görüntü Aracısı

Şunlar için geçerlidir:SQL ServerAzure SQL Veritabanı

Çoğaltma Anlık Görüntüsü Aracısı, yayımlanan tabloların ve veritabanı nesnelerinin şemasını ve verilerini içeren anlık görüntü dosyalarını hazırlayan, dosyaları anlık görüntü klasöründe depolayan ve eşitleme işlerini dağıtım veritabanında kaydeden yürütülebilir bir dosyadır.

Uyarı

• Parametreler herhangi bir sırada belirtilebilir.

Uyarı

Azure SQL Yönetilen Örnek, anlık görüntü ve işlem çoğaltması için yayımcı, dağıtıcı ve abone olarak kullanılabilir. Azure SQL Veritabanı'ndaki veritabanları yalnızca anlık görüntü ve işlem çoğaltması için gönderim aboneleri olabilir. Daha fazla bilgi için bkz. Azure SQL Veritabanı ve Azure SQL Yönetilen Örneği ile işlem çoğaltması.

Sözdizimi

  
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|3|4]]  
[-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]  

Tartışmalar

-?
Kullanılabilir tüm parametreleri yazdırır.

-Yayıncıserver_name[\instance_name]
Yayımcının adıdır. Bu sunucudaki varsayılan Microsoft SQL Server örneği için server_name belirtin. Bu\ sunucudaki adlandırılmış bir SQL Server örneği içinserver_name instance_name belirtin.

-Yayınyayını
Yayının adıdır. Bu parametre yalnızca yayın her zaman yeni veya yeniden başlatılmış abonelikler için kullanılabilir bir anlık görüntüye sahip olacak şekilde ayarlandıysa geçerlidir.

-70Ubscribers
Aboneler SQL Server sürüm 7.0 çalıştırıyorsa kullanılmalıdır.

-BcpBatchSizebcp_ batch_ boyut
Toplu kopyalama işleminde gönderilecek satır sayısıdır. İşlemde bir bcp gerçekleştirirken, toplu iş boyutu sunucuya tek bir işlem olarak gönderilecek satır sayısıdır ve ayrıca Dağıtım Aracısı bir bcp ilerleme iletisini günlüğe kaydetmeden önce gönderilmesi gereken satır sayısıdır. Bcp out işlemi gerçekleştirilirken 1000 sabit toplu iş boyutu kullanılır. 0 değeri ileti günlüğünün olmadığını gösterir.

-DefinitionFiledef_path_and_file_name
Aracı tanım dosyasının yoludur. Aracı tanım dosyası, aracı için komut satırı bağımsız değişkenleri içerir. Dosyanın içeriği yürütülebilir dosya olarak ayrıştırılır. Rastgele karakterler içeren bağımsız değişken değerlerini belirtmek için çift tırnak işareti (") kullanın.

-Dağıtıcıserver_name[\instance_name]
Dağıtımcı adıdır. Bu sunucudaki varsayılan SQL Server örneği için server_name belirtin. Bu\ sunucudaki adlandırılmış bir SQL Server örneği içinserver_name instance_name belirtin.

-DağıtıcıDeadlockPriority [-1|0|1]
Bir kilitlenme oluştuğunda Dağıtımcı ile Anlık Görüntü Aracısı bağlantısının önceliğidir. Anlık görüntü oluşturma sırasında Anlık Görüntü Aracısı ile kullanıcı uygulamaları arasında oluşabilecek kilitlenmeleri çözmek için bu parametre belirtilir.

DistributorDeadlockPriority değeri	Açıklama
-1	Dağıtımcıda kilitlenme oluştuğunda Anlık Görüntü Aracısı dışındaki uygulamaların önceliği vardır.
0 (Varsayılan)	Öncelik atanmadı.
1	Dağıtımcıda bir kilitlenme oluştuğunda Anlık Görüntü Aracısı'nın önceliği vardır.

-DistributorLogindistributor_login
SQL Server Kimlik Doğrulaması kullanarak Dağıtımcıya bağlanırken kullanılan oturum açma bilgisidir.

-DistributorPassworddistributor_password
SQL Server Kimlik Doğrulaması kullanarak Dağıtımcıya bağlanırken kullanılan paroladır.

-DağıtıcıGüvenlik Modu [ 0| 1]
Dağıtımcının güvenlik modunu belirtir. 0 değeri SQL Server Kimlik Doğrulama Modu'nu (varsayılan) ve 1 değeri Windows Kimlik Doğrulama Modu'nu gösterir.

-DynamicFilterHostNamedynamic_filter_host_name
Dinamik anlık görüntü oluşturulduğunda filtrelemede HOST_NAME (Transact-SQL) için bir değer ayarlamak için kullanılır. Örneğin, bir makale için alt küme filtre yan tümcesi rep_id = HOST_NAME() belirtilirse ve Birleştirme Aracısı'nı çağırmadan önce DynamicFilterHostName özelliğini "FBJones" olarak ayarlarsanız, yalnızca rep_id sütununda "FBJones" bulunan satırlar çoğaltılır.

-DynamicFilterLogindynamic_filter_login
Dinamik anlık görüntü oluşturulduğunda filtrelemede SUSER_SNAME (Transact-SQL) için bir değer ayarlamak için kullanılır. Örneğin, bir makale için alt küme filtre yan tümcesi user_id = SUSER_SNAME() belirtilirse ve SQLSnapshot nesnesinin Run yöntemini çağırmadan önce DynamicFilterLogin özelliğini "rsmith" olarak ayarlarsanız, anlık görüntüye yalnızca user_id sütununda "rsmith" içeren satırlar eklenir.

-DynamicSnapshotLocationdynamic_snapshot_location
Dinamik anlık görüntünün oluşturulması gereken konumdur.

-Şifreleme Seviyesi [ 0 | 1 | 2 | 3 | 4]
Daha önce Güvenli Yuva Katmanı (SSL) olarak bilinen Aktarım Katmanı Güvenliği (TLS), bağlantı kurarken Anlık Görüntü Aracısı tarafından kullanılan şifreleme düzeyidir.

EncryptionLevel değeri	Açıklama
0	TLS'nin kullanılmadığını belirtir.
1	TLS 1.2'nin kullanıldığını belirtir, ancak aracı TLS/SSL sunucu sertifikasının güvenilir bir veren tarafından imzalandığını doğrulamaz.
2	TLS 1.2'nin kullanıldığını ve sertifikanın doğrulandığını belirtir.
3	Azure SQL Yönetilen Örneği veya SQL Server 2025 ve sonraki sürümlerinden Azure SQL Yönetilen Örneği'ne yapılan bağlantılar için TLS 1.3'ün kullanıldığını ve sertifikanın doğrulandığını belirtir. SQL Server'a (desteklenen herhangi bir sürüm) yönelik bağlantılar için TLS 1.3 seçeneğiyle 3zorlanmaz.
4	Azure SQL Yönetilen Örneği veya SQL Server 2025 ve sonraki sürümlerinden Azure SQL Yönetilen Örneği'ne yapılan bağlantılar için TLS 1.3'ün kullanıldığını ve sertifikanın doğrulandığını belirtir. Azure SQL Yönetilen Örneği veya SQL Server 2025 ve sonraki sürümlerinden SQL Server'a (desteklenen herhangi bir sürüm) yapılan bağlantılar için TLS 1.3 kullanılır ve sertifika doğrulanır. ile bağlantı alan SQL Server konaklarına EncryptionLevel sertifikanın yüklenmesini 4gerektirir.

GEÇERLI bir TLS/SSL sertifikası, SQL Server'ın tam etki alanı adıyla tanımlanır. aracının -EncryptionLevel 2 olarak ayarlarken başarıyla bağlanması için yerel SQL Server'da bir diğer ad oluşturun. 'Diğer Ad' parametresi sunucu adı, 'Server' parametresi ise SQL Server'ın tam adı olarak ayarlanmalıdır.

Daha fazla bilgi için bkz. Çoğaltma güvenlik ayarlarını görüntüleme ve değiştirme.

-FieldDelimiterfield_delimiter
SQL Server toplu kopyalama veri dosyasındaki bir alanın sonunu işaretleyen karakter veya karakter dizisidir. Varsayılan değer \n<x$3>\n' dir.

-TarihVerboseSeviye [ 1| 2| 3]
Anlık görüntü işlemi sırasında günlüğe kaydedilen geçmiş miktarını belirtir. 1'i seçerek geçmiş günlüğünün performans üzerindeki etkisini en aza indirebilirsiniz.

HistoryVerboseLevel değeri	Açıklama
0	İlerleme iletileri konsola veya bir çıkış dosyasına yazılır. Geçmiş kayıtları dağıtım veritabanında günlüğe kaydedilmez.
1	Her zaman aynı durumdaki önceki bir geçmiş iletisini güncelleştirin (başlangıç, ilerleme, başarı vb.). Aynı durumda önceki bir kayıt yoksa, yeni bir kayıt ekleyin.
2 (varsayılan)	Kayıt boşta iletiler veya uzun süre çalışan iş iletileri gibi durumlar için değilse yeni geçmiş kayıtları ekleyin ve bu durumda önceki kayıtları güncelleştirin.
3	Boşta iletiler için olmadığı sürece her zaman yeni kayıtlar ekleyin.

-HRBcpBlocksnumber_of_blocks
Yazıcı ve okuyucu iş parçacıkları arasında kuyruğa alınan bcp veri bloklarının sayısıdır. Varsayılan değer 50'dir. HRBcpBlocks yalnızca Oracle yayınlarıyla birlikte kullanılır.

Uyarı

Bu parametre, Oracle Publisher'dan bcp performansının performansını ayarlamak için kullanılır.

- HRBcpBlockBoyutblock_size
Her bcp veri bloğunun kilobayt (KB) cinsinden boyutudur. Varsayılan değer 64 KB'tır. HRBcpBlocks yalnızca Oracle yayınlarıyla birlikte kullanılır.

Uyarı

Bu parametre, Oracle Publisher'dan bcp performansının performansını ayarlamak için kullanılır.

-HRBcpDynamicBlocks
Her bcp veri bloğunun boyutunun dinamik olarak büyüyüp büyüyemeyeceğidir. HRBcpBlocks yalnızca Oracle yayınlarıyla birlikte kullanılır.

Uyarı

Bu parametre, Oracle Publisher'dan bcp performansının performansını ayarlamak için kullanılır.

-KeepAliveMessageIntervalkeep_alive_interval
Anlık Görüntü Aracısı'nın MSsnapshot_history tablosunda " arka uç iletisi bekleniyor" olarak günlüğe kaydetmeden önce beklediği saniye cinsinden süredir. Varsayılan değer 300 saniyedir.

-LoginTimeOutlogin_time_out_seconds
Oturum açma zaman aşımına uğramadan önceki saniye sayısıdır. Varsayılan değer 15 saniyedir.

-MaxBcpThreadsnumber_of_threads
Paralel olarak gerçekleştirilebilecek toplu kopyalama işlemlerinin sayısını belirtir. Aynı anda var olan en fazla iş parçacığı ve ODBC bağlantısı sayısı , MaxBcpThreads sayısı veya dağıtım veritabanındaki eşitleme işleminde görüntülenen toplu kopyalama isteklerinin sayısıdır. MaxBcpThreads değerinin 0'dan büyük olması ve sabit kodlanmış üst sınırı olmaması gerekir. Varsayılan değer, işlemci sayısının iki katıdır.

Uyarı

Çoğaltılan nesnenin bir filtresi varsa, Snapshot aracısı birden çok BCP dosyası oluşturmak yerine bu makale için yalnızca bir BCP dosyası oluşturur.

- MaxNetworkOptimization [ 0| 1]
Ilgisiz silmelerin Aboneye gönderilip gönderilmediğini gösterir. Ilgisiz silmeler, Abonenin bölümüne ait olmayan satırlar için Abonelere gönderilen DELETE komutlarıdır. Ilgisiz silme işlemleri veri bütünlüğünü veya yakınsamasını etkilemez, ancak gereksiz ağ trafiğine neden olabilir. MaxNetworkOptimization varsayılan değeri 0'dır. MaxNetworkOptimization'ın1 olarak ayarlanması, ilgisiz silme olasılığını en aza indirerek ağ trafiğini azaltır ve ağ iyileştirmesini en üst düzeye çıkarır. Bu parametrenin 1 olarak ayarlanması da meta verilerin depolanmasını artırabilir ve birden çok birleştirme filtresi düzeyi ve karmaşık alt küme filtreleri varsa Publisher'da performansın düşmesine neden olabilir. Çoğaltma topolojinizi dikkatle değerlendirmeniz ve MaxNetworkOptimization değerini yalnızca ilgisiz silmelerden gelen ağ trafiğinin kabul edilemez derecede yüksek olması durumunda 1 olarak ayarlamanız gerekir.

Uyarı

Bu parametrenin 1 olarak ayarlanması, yalnızca birleştirme yayınının eşitleme iyileştirme seçeneği true (@keep_partition_changes**sp_addmergepublication (Transact-SQL) parametresi) olarak ayarlandığında kullanışlıdır.

-Çıkışoutput_path_and_file_name
Aracı çıkış dosyasının yoludur. Dosya adı sağlanmazsa, çıkış konsola gönderilir. Belirtilen dosya adı varsa, çıktı dosyaya eklenir.

-OutputVerboseLevel [ 0| 1| 2]
Çıkışın ayrıntılı olup olmayacağını belirtir.

OutputVerboseLevel değeri	Açıklama
0	Yalnızca hata iletileri yazdırılır.
1 (varsayılan)	Tüm ilerleme raporu iletileri yazdırılır (varsayılan).
2	Hata ayıklama için yararlı olan tüm hata iletileri ve ilerleme raporu iletileri yazdırılır.

-PacketSizepacket_size
SQL Server'a bağlanırken Snapshot Agent tarafından kullanılan paket boyutu (bayt cinsinden). Varsayılan değer 8192 bayttır.

Uyarı

Performansı artıracağından emin değilseniz paket boyutunu değiştirmeyin. Çoğu uygulama için varsayılan paket boyutu en iyisidir.

-PrefetchTables [ 0| 1]
Tablo nesnelerinin önceden oluşturulup önbelleğe alınıp alınmadığını belirten isteğe bağlı parametre. Varsayılan davranış, bir iç hesaplamaya göre SMO bileşenini kullanarak belirli tablo özelliklerini önceden seçmektir. Bu parametre, SMO prefetch işleminin çalıştırılmasının çok daha uzun sürdüğü senaryolarda yararlı olabilir. Bu parametre kullanılmazsa, bu karar çalışma zamanında yayına makale olarak eklenen tabloların yüzdesine göre yapılır.

OutputVerboseLevel değeri	Açıklama
0	SMO bileşeninin Prefetch yöntemine çağrı devre dışı bırakıldı.
1	Snapshot Agent, SMO kullanarak bazı tablo özelliklerini önbelleğe almak için Prefetch yöntemini çağırır

-ProfileNameprofile_name
Aracı parametreleri için kullanılacak aracı profilini belirtir. ProfileName NULL ise aracı profili devre dışı bırakılır. ProfileName belirtilmezse aracı türü için varsayılan profil kullanılır. Bilgi için bkz . Çoğaltma Aracısı Profilleri.

-PublisherDBpublisher_database
Yayın veritabanının adıdır. Bu parametre Oracle Publishers için desteklenmez.

-YayıncıDeadlockPriority [-1|0|1]
Kilitlenme oluştuğunda Yayımcı ile Anlık Görüntü Aracısı bağlantısının önceliğidir. Anlık görüntü oluşturma sırasında Anlık Görüntü Aracısı ile kullanıcı uygulamaları arasında oluşabilecek kilitlenmeleri çözmek için bu parametre belirtilir.

PublisherDeadlockPriority değeri	Açıklama
-1	Publisher'da kilitlenme oluştuğunda Anlık Görüntü Aracısı dışındaki uygulamaların önceliği vardır.
0 (Varsayılan)	Öncelik atanmadı.
1	Publisher'da bir kilitlenme oluştuğunda Anlık Görüntü Aracısı'nın önceliği vardır.

-YayıncıFailoverPartnerserver_name[\instance_name]
Yayın veritabanıyla veritabanı yansıtma oturumuna katılan SQL Server'ın yük devretme iş ortağı örneğini belirtir. Daha fazla bilgi için bkz. Veritabanı Yansıtma ve Çoğaltma (SQL Server).

-PublisherLoginpublisher_login
SQL Server Kimlik Doğrulaması kullanarak Publisher'a bağlanırken kullanılan oturum açma bilgisidir.

-PublisherPasswordpublisher_password
SQL Server Kimlik Doğrulaması kullanarak Publisher'a bağlanırken kullanılan paroladır.

-YayıncıGüvenlik Modu [ 0| 1]
Publisher'ın güvenlik modunu belirtir. 0 değeri SQL Server Kimlik Doğrulaması'nın (varsayılan) ve 1 değerinin olması Windows Kimlik Doğrulama Modu'nu gösterir.

-QueryTimeOutquery_time_out_seconds
Sorgu zaman aşımına uğramadan önceki saniye sayısıdır. Varsayılan değer 1800 saniyedir.

-Replikasyon Türü [ 1| 2]
Çoğaltma türünü belirtir. 1 değeri işlem çoğaltmayı, 2 değeri ise birleştirme çoğaltmayı gösterir.

-RowDelimiterrow_delimiter
SQL Server toplu kopyalama veri dosyasındaki bir satırın sonunu işaretleyen karakter veya karakter dizisidir. Varsayılan olarak \n<\n@g> .

-StartQueueTimeoutstart_queue_timeout_seconds
Çalışan eşzamanlı dinamik anlık görüntü işlemlerinin sayısı @max_concurrent_dynamic_snapshots özelliği tarafından ayarlanan sınırda olduğunda Anlık Görüntü Aracısı'nın beklediği en fazla saniye sayısıdır. En fazla saniye sayısına ulaşılırsa ve Anlık Görüntü Aracısı hala bekliyorsa, çıkar. 0 değeri, aracının süresiz olarak beklediği, ancak iptal edilebileceği anlamına gelir.

- UsePerMakaleIçerik use_per_article_contents_view Görüntüle.
Bu parametre kullanım dışı bırakıldı ve yalnızca geriye dönük uyumluluk için desteklenir.

Açıklamalar

Önemli

SQL Server Agent'ı Etki Alanı Kullanıcı hesabı (varsayılan) yerine Yerel Sistem hesabı altında çalıştırılacak şekilde yüklediyseniz, hizmet yalnızca yerel bilgisayara erişebilir. SQL Server Aracısı altında çalışan Anlık Görüntü Aracısı, SQL Server'da oturum açtığında Windows Kimlik Doğrulama Modu'nu kullanacak şekilde yapılandırılmışsa, Anlık Görüntü Aracısı başarısız olur. Varsayılan ayar SQL Server Kimlik Doğrulaması'dır.

Snapshot Agent'ı başlatmak için komut isteminden snapshot.exe yürütür. Bilgi için bkz . Çoğaltma Aracısı Yürütülebilir Dosyaları.

İlgili içerik

• Çoğaltma Aracısı Yönetimi