sp_addmergepublication (Transact-SQL)
Yeni bir birleştirme yayın oluşturur.Bu saklı yordam, yayımlanmış Veritabanı yayımcısına sırasında yürütülür.
.gif "Topic link icon")
sp_addmergepublication [ @publication = ] 'publication'
[ ,[ @description = ] 'description'
[ ,[ @retention = ] retention ]
[ ,[ @sync_mode = ]'sync_mode' ]
[ , [ @allow_push = ] 'allow_push']
[ ,[ @allow_pull = ] 'allow_pull']
[ ,[ @allow_anonymous = ]'allow_anonymous']
[ ,[ @enabled_for_internet = ] 'enabled_for_internet']
[ ,[ @centralized_conflicts = ] 'centralized_conflicts']
[ ,[ @dynamic_filters = ] 'dynamic_filters']
[ ,[ @snapshot_in_defaultfolder = ] 'snapshot_in_default_folder']
[ ,[ @alt_snapshot_folder = ] 'alternate_snapshot_folder']
[ ,[ @pre_snapshot_script = ] 'pre_snapshot_script']
[ ,[ @post_snapshot_script = ] 'post_snapshot_script']
[ ,[ @compress_snapshot = ] 'compress_snapshot']
[ ,[ @ftp_address = ] 'ftp_address']
[ ,[ @ftp_port = ] ftp_port ]
[ ,[ @ftp_subdirectory = ] 'ftp_subdirectory']
[ ,[ @ftp_login = ] 'ftp_login']
[ ,[ @ftp_password = ] 'ftp_password']
[ ,[ @conflict_retention = ] conflict_retention ]
[ ,[ @keep_partition_changes = ] 'keep_partition_changes' ]
[ ,[ @allow_subscription_copy = ] 'allow_subscription_copy']
[ ,[ @allow_synctoalternate = ] 'allow_synctoalternate']
[ , [ @validate_subscriber_info = ] 'validate_subscriber_info']
[ ,[ @add_to_active_directory = ] 'add_to_active_directory']
[ ,[ @max_concurrent_merge = ] maximum_concurrent_merge ]
[ ,[ @max_concurrent_dynamic_snapshots = ] max_concurrent_dynamic_snapshots ]
[ , [ @use_partition_groups = ] 'use_partition_groups']
[ , [ @publication_compatibility_level = ] 'backward_comp_level' ]
[ , [ @replicate_ddl = ] replicate_ddl ]
[ , [ @allow_subscriber_initiated_snapshot = ] 'allow_subscriber_initiated_snapshot' ]
[ , [ @allow_web_synchronization = ] 'allow_web_synchronization' ]
[ , [ @web_synchronization_url = ] 'web_synchronization_url' ]
[ , [ @allow_partition_realignment = ] 'allow_partition_realignment' ]
[ , [ @retention_period_unit = ] 'retention_period_unit' ]
[ , [ @generation_leveling_threshold = ] generation_leveling_threshold ]
[ , [ @automatic_reinitialization_policy = ] automatic_reinitialization_policy ]
[ , [ @conflict_logging = ] 'conflict_logging' ]
Bağımsız değişkenler
[ @publication = ] 'publication'
Is the name of the merge publication to create.publication is sysname, with no default, and must not be the keyword ALL.Yayın adı veritabanı içinde benzersiz olmalıdır.[ @description = ] 'description'
Is the publication description.description is nvarchar(255), with a default of NULL.[ @retention = ] retention
Is the retention period, in retention period units, for which to save changes for the given publication.retention is int, with a default of 14 units.Saklama dönemi birimleri tanımlanır retention_period_unit. Saklama dönemi içinde abonelik eşitlenir ve bekleyen değişiklikleri almış, temizleme işlemi sırasında dağıtımcı tarafından kaldırıldı, abonelik süresi ve yeniden gerekir.En çok izin verilen bir saklama dönemi, ara arasındaki günlerin sayısıdır.31, 9999 ve geçerli tarih.Not
Saklama dönemi birleştirme yayımları için farklı saat dilimlerinde aboneleri uyması için 24 saatlik yetkisiz kullanım süresi vardır.Örneğin, bir gün içindeki bir saklama dönemi ayarlarsanız, gerçek bir saklama dönemi 48 saattir.
[ @sync\_mode = ] 'sync_mode'
Is the mode of the initial synchronization of subscribers to the publication.sync_mode is nvarchar(10), and can be one of the following values.Değer
Açıklama
Yerel (varsayılan)
Yerel moddaki toplu kopyalama programı çıkışını tüm tabloları oluşturur.
karakter
Karakter modu toplu kopyalama programı çıkışını tüm tabloları oluşturur.Required to support Microsoft SQL Server Compact 3.5 SP1 and non-SQL Server Subscribers.
[ @allow\_push = ] 'allow_push'
Specifies if push subscriptions can be created for the given publication.allow_push is nvarchar(5), with a default of TRUE, which allows push subscriptions on the publication.[ @allow\_pull = ] 'allow_pull'
Specifies if pull subscriptions can be created for the given publication.allow_pull is nvarchar(5), with a default of TRUE, which allows pull subscriptions on the publication.Destek true belirtmelisiniz SQL Server Compact 3.5 SP1 Abonelerin.[ @allow\_anonymous = ] 'allow_anonymous'
Specifies if anonymous subscriptions can be created for the given publication.allow_anonymous is nvarchar(5), with a default of TRUE, which allows anonymous subscriptions on the publication.Destek almak için SQL Server Compact 3.5 SP1 Abonelerin, belirtmeniz gerekir true.[ @enabled\_for\_internet = ] 'enabled_for_internet'
Specifies if the publication is enabled for the Internet, and determines if file transfer protocol (FTP) can be used to transfer the snapshot files to a subscriber.enabled_for_internet is nvarchar(5), with a default of FALSE.If true, yayın için eşitleme dosyaları C:\Program Files\Microsoft SQL Server\MSSQL\MSSQL.x\Repldata\Ftp dizinine yerleştirilir. Kullanıcı FTP dizini oluşturmanız gerekir.If false, yayın, ınternet erişimi için etkinleştirilmemiştir.[ @centralized\_conflicts =] 'centralized_conflicts'
Bu parametre, onaylanmaz ve yalnızca komut dosyaları, geriye doğru uyumluluk için desteklenir.Kullanımı conflict_logging Çakışma kayıtları depolandığı konumu belirtmek için .[ @dynamic\_filters =] 'dynamic_filters'
Enables the merge publication to use parameterized row filters.dynamic_filters is nvarchar(5), with a default of FALSE.Not
Bu parametreyi belirtmek ancak bunun yerine izin verme SQL Server otomatik olarak parametreli belirlemek için satır süzgeç kullanılıyor. Bir değer belirtirseniz true için dynamic_filters, sizin tanımladığınız bir parametreli satır filtresi makale. Daha fazla bilgi için bkz: Nasıl Yapılır: Tanımlamak ve birleştirme makalesi (çoğaltma Transact-SQL programı) bir parametreli satır filtresi Değiştir.
[ @snapshot\_in\_defaultfolder = ] 'snapshot_in_default_folder'
Specifies if the snapshot files are stored in the default folder.snapshot_in_default_folder is nvarchar(5), with a default of TRUE.If true, anlık görüntü dosyaları, varsayılan klasöründe bulunabilir. If false, anlık görüntü dosyaları tarafından belirtilen farklı bir konumda depolanan alternate_snapshot_folder. Diğer konumlar, başka bir sunucuda, bir ağ sürücüsünde veya çıkarılabilir bir medyada (örneğin, CD-ROM veya kaldırılabilir disk) olabilir.Anlık görüntü dosyaları için bir Dosya Aktarım Protokolü (FTP) sitesine, daha sonra alma abone olarak da kaydedebilirsiniz.Bu parametre doğru olması ve belirtilen konum çözümlenmedi unutmayın. alt_snapshot_folder. Bu bileşim, anlık görüntü dosyalarını hem varsayılan hem de diğer konumlarda depolanacak belirtir.[ @alt\_snapshot\_folder = ] 'alternate_snapshot_folder'
Specifies the location of the alternate folder for the snapshot.alternate_snapshot_folder is nvarchar(255), with a default of NULL.[ @pre\_snapshot\_script = ] 'pre_snapshot_script'
Specifies a pointer to an .sql file location.pre_snapshot_script is nvarchar(255), with a default of NULL.Birleştirme Aracısı en anlık görüntü görüntü uygularken pre-anlık görüntü komut çoğaltılan nesne komut önce çalışacak bir abone.Komut dosyası, abonelik veritabanına bağlanırken Birleştirme Aracısı tarafından kullanılan güvenlik bağlamında yürütülür.Pre-anlık görüntü komut dosyaları çalıştırılmaz SQL Server Compact 3.5 SP1 Abonelerin.[ @post\_snapshot\_script = ] 'post_snapshot_script'
Specifies a pointer to an .sql file location.post_snapshot_script is nvarchar(255), with a default of NULL.Birleştirme Aracısı post-anlık görüntü komut dosyası, tüm diğer çoğaltılan nesne komut dosyaları ve verileri bir ilk eşitleme sırasında uygulandıktan sonra çalışır.Komut dosyası, abonelik veritabanına bağlanırken Birleştirme Aracısı tarafından kullanılan güvenlik bağlamında yürütülür.POST-anlık görüntü komut dosyaları çalıştırılmaz SQL Server Compact 3.5 SP1 Abonelerin.[ @compress\_snapshot = ] 'compress_snapshot'
Specifies that the snapshot written to the @alt\_snapshot\_folder location is to be compressed into the Microsoft CAB format.compress_snapshot is nvarchar(5), with a default of FALSE.false specifies that the snapshot will not be compressed; true specifies that the snapshot is to be compressed.2 GB'DEN daha büyük bir anlık görüntü dosyaları sıkıştırılamaz.Sıkıştırılmış bir anlık görüntü dosyaları Birleştirme Aracısı çalışır; dosyaları Abone tarafında sıkıştırılmamış olan çekme abonelikler genellikle sıkıştırılmış anlık görüntüleri ile kullanılan konumda sıkıştırılmamış durumdadır.Rapor anlık görüntü görüntü görüntüsünü varsayılan klasörde sıkıştırılamaz.Destek almak için SQL Server Compact 3.5 SP1 Abonelerin, belirtmeniz gerekir false.[ @ftp\_address = ] 'ftp_address'
Is the network address of the FTP service for the Distributor.ftp_address is sysname, with a default of NULL.yayın anlık görüntü dosyaları çekme için abone birleştirme aracının yerleştirildiği belirtir.Bu özellik her yayın için depolanan olduğundan, her birinin farklı olabilir ftp_address. yayın yayılıyor anlık görüntüleri FTP kullanarak desteklemelidir.[ @ftp\_port**=** ] ftp_port
Is the port number of the FTP service for the Distributor.ftp_port is int, with a default of 21.yayın anlık görüntü dosyaları çekme için abone birleştirme aracının yerleştirildiği belirtir.Bu özellik her yayın için depolanan olduğundan, her birinin kendi olabilir ftp_port.[ @ftp\_subdirectory = ] 'ftp_subdirectory'
Specifies where the snapshot files will be available for the Merge Agent of the subscriber to pick up if the publication supports propagating snapshots using FTP.ftp_subdirectory is nvarchar(255), with a default of NULL.Bu özellik her yayın için depolanan olduğundan, her birinin kendi olabilir ftp_subdirctory veya bir NULL değeri ile belirtilen, hiçbir alt sağlamak seçin.Parametreli filtreleriyle yayınlar için anlık görüntü görüntü görüntüleri pre-generating, her abone bölümü için veri anlık görüntü görüntü kendi klasöründe olması gerekir.FTP'YI kullanarak pre-generated anlık görüntüler için dizin yapısı aşağıdaki yapıda uyacak gerekir:
alternate_snapshot_folder\ftp\publisher_publicationDB_publication\partitionID.
Not
Yukarıdaki değerler italik ayrıntıları üzerinde bağlıdır yayın ve abone bölüm.
[ @ftp\_login = ] 'ftp_login'
Is the username used to connect to the FTP service.ftp_login is sysname, with a default of 'anonymous'.[ @ftp\_password = ] 'ftp_password'
Is the user password used to connect to the FTP service.ftp_password is sysname, with a default of NULL..gif "Security note")
Security Note:Boş parola kullanmayın.Güçlü bir parola kullanın.
[ @conflict\_retention = ] conflict_retention
Specifies the retention period, in days, for which conflicts are retained.conflict_retention is int, with a default of 14 days before the conflict row is purged from the conflict table.[ @keep\_partition\_changes = ] 'keep_partition_changes'
Specifies whether to enable partition change optimizations when precomputed partitions cannot be used.keep_partition_changes is nvarchar(5), with a default of TRUE.false means that partition changes are not optimized, and when precomputed partitions are not used, the partitions sent to all Subscribers will be verified when data changes in a partition.true means that partition changes are optimized, and only Subscribers having rows in the changed partitions are affected.Precomputed bölümleri kullanırken, küme use_partition_groups için true ve küme keep_partition_changes için false. Daha fazla bilgi için bkz: Parametreli süzgeç performans Precomputed bölümleri ile en iyi duruma getirme.Not
Bir değer belirtirseniz true için keep_partition_changes, değeri belirtin. 1 - MaxNetworkOptimization anlık görüntü Aracısı parametresi.Bu parametre hakkında daha fazla bilgi için bkz: Çoğaltma anlık görüntü Aracısı. Aracısı parametrelerini belirtme hakkında daha fazla bilgi için bkz: Çoğaltma aracıları'nı yönetme.
[ @allow\_subscription\_copy = ] 'allow_subscription_copy'
Enables or disables the ability to copy the subscription databases that subscribe to this publication.allow_subscription_copy is nvarchar(5), with a default of FALSE.Kopyalanan abonelik veritabanı boyutunu 2 gigabayttan (GB) olmalıdır.[ @allow\_synctoalternate = ] 'allow_synctoalternate'
Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.[ @validate\_subscriber\_info = ] 'validate_subscriber_info'
Lists the functions that are used to define a Subscriber partition of the published data when parameterized row filters are used.validate_subscriber_info is nvarchar(500), with a default of NULL.Bu bilgi Birleştirme Aracısı tarafından abonenin bölüm doğrulamak için kullanılır.Örneğin, suser_sname parametreli satır filtrede kullanılan, parametre olmalıdır @validate\_subscriber\_info=N'SUSER_SNAME()'.Not
Bu parametreyi belirtmek ancak bunun yerine izin verme SQL Server otomatik olarak süzme ölçütü belirlemek için .
[ @add\_to\_active\_directory = ] 'add_to_active_directory'
Bu parametre, onaylanmaz ve yalnızca komut dosyaları, geriye doğru uyumluluk için desteklenir.Yayın bilgileri artık ekleyebileceğiniz Microsoft Active Directory.[ @max\_concurrent\_merge = ] maximum_concurrent_merge
The maximum number of concurrent merge processes.maximum_concurrent_merge is int with a default of 0.Değeri 0 bu özellik için sınırsız sayıda eşzamanlı birleştirme işlemleri sırasında verilen çalıştıran bulunduğu anlamına gelir saat.Bu özellik, bir anda bir birleştirme yayın karşı çalıştırılabilen eşzamanlı birleştirme işlemleri sayısı sınırı ayarlar saat.Daha fazla mektup birleştirme işlemleri, aynı anda zamanlanmış olup olmadığını saat çalıştırmak için , değeri veren sonra fazla işlerin kuyruğa yerleştirme ve bir şu anda çalışan birleştirme kadar işlemi bekleme tamamlanır.[ @max\_concurrent\_dynamic\_snapshots =] max_concurrent_dynamic_snapshots
The maximum number of Snapshot Agent sessions that can be run concurrently to generate filtered data snapshots for Subscriber partitions.maximum_concurrent_dynamic_snapshots is int with a default of 0.If 0, numara anlık görüntü görüntü oturumları için bir sınır yoktur.Değer çalışmasına izin verdiğinden, aynı zamanda zamanlanan daha fazla anlık işlemler varsa, fazla işler kuyruğa yerleştirme ve şu anda çalışan bir anlık görüntü işlemi bitinceye kadar bekleyin.[ @use\_partition\_groups = ] 'use_partition_groups'
Specifies that precomputed partitions should be used to optimize the synchronization process.use_partition_groups is nvarchar(5), and can be one of these values:Değer
Açıklama
true
yayın precomputed bölümleri kullanır.
false
yayın precomputed bölümleri kullanın.
NULL(default)
Sistem bölümleme stratejiyi üzerinde karar verir.
Precomputed bölümleri, varsayılan olarak kullanılır.Bölüm precomputed kullanmaktan kaçınmaktır use_partition_groups olmalıdır küme için false. NULL olduğunda, sistem precomputed bölümleri, kullanılabilir karar verir.Bölümleri kullanılan precomputed, daha sonra bu değer etkin olacak false herhangi bir hata oluşturmadan. Bu gibi durumlarda, keep_partition_changes olabilir küme için true Bazı en iyileştirme sağlamak için . Daha fazla bilgi için bkz: Parametreli satır süzgeçleri ve Parametreli süzgeç performans Precomputed bölümleri ile en iyi duruma getirme.
[ @publication\_compatibility\_level = ] backward_comp_level
Indicates the backward compatibility of the publication.backward_comp_level is nvarchar(6), and can be one of these values:Değer
Sürüm
70RTM
Microsoft SQL Server 7.0
70SP1
SQL Server 7.0 hizmet Pack 1
70SP2
SQL Server 7.0 hizmet Pack 2
70SP3
SQL Server 7.0 hizmet Pack 3
70SP4
SQL Server 7.0 hizmet Pack 4
80RTM
Microsoft SQL Server 2000
80SP1
SQL Server 2000 hizmet Pack 1
80SP2
SQL Server 2000 hizmet Pack 2
80SP3
SQL Server 2000 hizmet Pack 3
90RTM
Microsoft SQL Server 2005
100RTM
Microsoft SQL Server 2008
[@replicate_ddl = ] replicate_ddl
Indicates if schema replication is supported for the publication.replicate_ddl is int, with a default of 1.1 yayımcı sırasında gerçekleştirilen veri tanımlama dili (DDL) deyimleri çoğaltılan olduğunu, gösterir ve 0 DDL) deyimleri değil yinelenmiş gösterir.Daha fazla bilgi için bkz: Üzerinde yayın Databases şema değişiklikleri yapma.[ @allow\_subscriber\_initiated\_snapshot = ] 'allow_subscriber_initiated_snapshot'
Indicates if Subscribers to this publication can initiate the snapshot process to generate the filtered snapshot for their data partition.allow_subscriber_initiated_snapshot is nvarchar(5), with a default of FALSE.true indicates that Subscribers can initiate the snapshot process.[ @allow\_web\_synchronization = ] 'allow_web_synchronization'
Specifies if the publication is enabled for Web synchronization.allow_web_synchronization is nvarchar(5), with a default of FALSE.true specifies that subscriptions to this publication can be synchronized over HTTPS.Daha fazla bilgi için bkz: Birleştirme çoğaltması için Web üzerinden eşitleme. Destek almak için SQL Server Compact 3.5 SP1 Abonelerin, belirtmeniz gerekir true.[ @web\_synchronization\_url = ] 'web_synchronization_url'
Specifies the default value of the Internet URL used for Web synchronization.web_synchronization_url is nvarchar(500), with a default of NULL.Bir açık değilse, varsayılan ınternet URL'SINI tanımlayan küme zaman sp_addmergepullsubscription_agent yürütülür.[ @allow\_partition\_realignment = ] 'allow_partition_realignment'
Determines whether deletes are sent to the subscriber when modification of the row on the publisher causes it to change its partition.allow_partition_realignment is nvarchar(5), with a default of TRUE.true sends deletes to the Subscriber to reflect the results of a partition change by removing data that is no longer part of the Subscriber's partition.false leaves the data from an old partition on the Subscriber, where changes made to this data on the Publisher will not replicate to this Subscriber, but changes made on the Subscriber will replicate to the Publisher.Ayarı allow_partition_realignment için false Veriyi Geçmiş amacıyla erişilebilir olması gerektiğinde, eski bir bölümü bir abonelikten verileri korumak için kullanılır.Not
Ayar, abone kalır veri allow_partition_realignment için false salt okunur bir şekilde gibi değerlendirilmelidir; bu ancak, çoğaltma sistemi tarafından zorlanmaz.
[ @retention\_period\_unit = ] 'retention_period_unit'
Specifies the units for the retention period set by retention.retention_period_unit is nvarchar(10), and can be one of the following values.Değer
Sürüm
günü (varsayılan)
Saklama dönemi gün olarak belirlenir.
Hafta
Saklama dönemi hafta olarak belirtildi.
ay
Saklama dönemi, ay cinsinden belirtilir.
yıl
Saklama dönemi yılda belirtildi.
[ @generation\_leveling\_threshold = ] generation_leveling_threshold
Bir oluşturma içerdiği değişiklik sayısını belirtir.A generation is a collection of changes that are delivered to a Publisher or Subscriber.generation_leveling_threshold is int, with a default value of 1000.Daha fazla bilgi için bkz: Birleştirme çoğaltması nasıl izler ve değişiklikleri numaralandırır..[ @automatic\_reinitialization\_policy = ] automatic_reinitialization_policy
Specifies whether changes are uploaded from the Subscriber before an automatic reinitialization required by a change to the publication, where a value of 1 was specified for @force_reinit_subscription.automatic_reinitialization_policy is bit, with a default value of 0.1 otomatik bir reinitialization gerçekleştirilmeden önce değişiklikleri abone karşıya demektir..gif "Important note")
Important Note:Ekleme, bırakma veya parametreli hale getirilmiş bir filtreyi değiştirin, bekleyen değişiklikleri at abone yayımcıya reinitialization sırasında yüklenemiyor.Bekleyen değişiklikler yüklemek istiyorsanız, süzgeç değiştirmeden önce tüm abonelikler eşitleyin.
[ @conflict\_logging = ] 'conflict_logging'
Specifies where conflict records are stored.conflict_logging is nvarchar(15), and can be one of the following values:Değer
Açıklama
Yayımcı
Çakışma kayıtları, Yayımcı tarafında depolanır.
abone
Çakışma kayıtları, çakışmaya neden olan Abone tarafında depolanır.Desteklenen değil SQL Server Compact 3.5 SP1 Abonelerin.
her ikisi de
Çakışma kayıtları, hem yayımcı ve abone depolanır.
NULL(default)
Çoğaltma otomatik olarak ayarlar conflict_logging için her ikisi de zaman değeri backward_comp_level olan 90RTM and to Yayımcı diğer tüm durumlarda gerekir.
Dönüş Kodu Değerleri
0 (başarılı) veya 1 (hata)
Remarks
sp_addmergepublication birleştirme çoğaltmasında kullanılır.
Liste yayın @ add_to_active_directory parametresi kullanılarak Active Directory nesneleri için SQL Server Nesne zaten Active Directory'de oluşturulması gerekir.
Birden çok yayın varsa, aynı veritabanı nesnesi, yalnızca sahip yayınlar yayımlamak bir replicate_ddl değeri 1 , ALTER tablo, ALTER VIEW, ALTER PROCEDURE, ALTER işlev ve ALTER TRIGGER DDL) deyimleri çoğaltılır.Ancak, bir SÜTUN DDL DROP tablo ALTER deyim tarafından bırakılan sütun yayım yaptığınız tüm yayınlar çoğaltılacaktır.
Için SQL Server Compact 3.5 SP1 Abonelerin, değeri alternate_snapshot_folder yalnızca kullanıldığında değeri snapshot_in_default_folder olan false.
With DDL replication enabled (replicate_ddl**=1**) for a publication, to make non-replicating DDL changes to the publication, sp_changemergepublication must first be executed to set replicate_ddl to 0.DDL olmayan çoğaltılıyor ifadeleri verildikten sonra DDL çoğaltma yeniden ayarlamak için tekrar sp_changemergepublication çalıştırılabilir.
İzinler
Only members of the sysadmin fixed server role or db_owner fixed database role can executesp_addmergepublication.
See Also