Udostępnij za pośrednictwem


sp_addmergepublication (języka Transact-SQL)

Tworzy nową publikacja korespondencji seryjnej.Ta procedura przechowywana jest wykonywany przez wydawcę z bazy danych, która jest publikowana.

Topic link iconKonwencje składni języka Transact-SQL

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' ]

Argumenty

  • [ @publication = ] 'publication'
    Is the name of the merge publication to create.publication is sysname, with no default, and must not be the keyword ALL.Nazwę publikacja, musi być unikatowa w bazie danych.

  • [ @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.Jednostki okresu przechowywania są definiowane przez retention_period_unit. Jeśli subskrypcji nie został zsynchronizowany w okresie zachowywania oczekujące zmiany, czy otrzymano zostały usunięte przez operację oczyszczania na Dystrybutor, subskrypcja wygaśnie i ustawienie musi być ponownie inicjowane.Okres zachowywania dozwoloną maksymalną jest liczba dni między gru.31, 9999 i bieżącą data.

    Uwaga

    Okres zachowywania dla publikacji seryjnej ma 24-godzinny okres prolongaty dla subskrybentów w różnych strefach czasowych.Jeśli na przykład ustawić okres zachowywania jednego dnia, okres zachowywania rzeczywisty wynosi 48 godzin.

  • [ @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.

    Wartość

    Description

    macierzysta (domyślnie)

    Generuje dane wyjściowe programu kopiowanie masowe trybu macierzystego wszystkich tabel.

    znak

    Generuje dane wyjściowe programu kopiowanie masowe tryb znakowy wszystkich tabel.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.Należy określić, do pomocy technicznej SQL Server Compact 3.5 SP1 Subskrybentów.

  • [ @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.Do obsługi SQL Server Compact 3.5 SP1 Subskrybenci, należy określić 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.Jeśli true, pliki synchronizacji w publikacja są umieszczane w katalogu C:\Program Files\Microsoft SQL Server\MSSQL\MSSQL.x\Repldata\Ftp. Użytkownik musi utworzyć katalogu FTP.Jeśli false, publikacja nie jest włączony dostęp do Internetu.

  • [ @centralized\_conflicts =] 'centralized_conflicts'
    Tego parametru została zastąpiona i jest obsługiwany tylko w celu zapewnienia zgodności z poprzednimi wersjami skryptów.Użycie conflict_logging Aby określić lokalizację, gdzie przechowywane są rekordy konfliktu.

  • [ @dynamic\_filters =] 'dynamic_filters'
    Enables the merge publication to use parameterized row filters.dynamic_filters is nvarchar(5), with a default of FALSE.

    Uwaga

    Należy nie określono tego parametru, ale zamiast niego pozwolić SQL Server Aby automatycznie określić, czy sparametryzowana używane są filtry wierszy. Jeżeli określono wartość true dla dynamic_filters, należy zdefiniować sparametryzowany filtr wierszy do artykuł. Aby uzyskać więcej informacji zobacz Jak Definiowanie i modyfikowanie filtru sparametryzowana wiersz artykuł korespondencji seryjnej (Programowanie replikacja języka Transact-SQL).

  • [ @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.Jeśli true, migawka pliki znajdują się w folderze domyślnym. Jeśli false, migawka pliki będą przechowywane w innej lokalizacji określonej przez alternate_snapshot_folder. Alternatywnych lokalizacji może być na innym serwerze, na dysku sieciowym lub na nośniku wymiennym (np. dysku CD-ROM lub dyski wymienne).Można zapisać pliki migawka do witryny File Transfer protokół (FTP), do pobierania przez subskrybent w późniejszym czasie.Należy zauważyć, że ten parametr może mieć wartość true i nadal znajduje się w lokalizacji określonej przez alt_snapshot_folder. Określa, że ta kombinacja migawka pliki będą przechowywane w domyślnym i alternatywnych lokalizacji.

  • [ @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.Agent korespondencji seryjnej będzie uruchomić skrypt pre-migawka przed żadnych skryptów replikowanych obiektów, stosując migawka na subskrybent.Skrypt jest wykonywany w kontekście zabezpieczeń, używana przez agenta seryjny podczas nawiązywania połączenia z bazą danych subskrypcja.Skrypty Pre-migawka nie są uruchamiane SQL Server Compact 3.5 SP1 Subskrybentów.

  • [ @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.Scal Agent zostanie uruchomione post-migawka skryptu, po zastosowaniu wszystkich innych skryptów replikowanych obiektów i danych podczas wstępna synchronizacja.Skrypt jest wykonywany w kontekście zabezpieczeń, używana przez agenta seryjny podczas nawiązywania połączenia z bazą danych subskrypcja.Skrypty POST-migawka nie są uruchamiane SQL Server Compact 3.5 SP1 Subskrybentów.

  • [ @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.Nie można skompresować pliki migawka, które są większe niż 2 GB.migawka skompresowane pliki są bez kompresji w miejscu, w której działa Agent Scal; subskrypcji ściąganej są zazwyczaj używane z migawkami skompresowany tak, aby pliki były nieskompresowanych przez subskrybent.Nie można skompresować migawkę w domyślnym folderze.Do obsługi SQL Server Compact 3.5 SP1 Subskrybenci, należy określić 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.Określa, w którym znajdują się dla korespondencji seryjnej czynnika pliki migawka publikacja subskrybent aby.Ponieważ ta właściwość jest przechowywana w każdej publikacji, każda publikacja może mieć inną ftp_address. Publikacja musi obsługiwać rozmnożeniowy migawki za pomocą protokołu FTP.

  • [ @ftp\_port**=** ] ftp_port
    Is the port number of the FTP service for the Distributor.ftp_port is int, with a default of 21.Określa, w którym znajdują się dla korespondencji seryjnej czynnika pliki migawka publikacja subskrybent aby.Ponieważ ta właściwość jest przechowywana w każdej publikacja, każdą publikacja mogą mieć swoje własne 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.Ponieważ ta właściwość jest przechowywana w każdej publikacja, każdą publikacja mogą mieć swoje własne ftp_subdirctory lub wybrać opcję, aby nie podkatalogu oznaczone wartości NULL.

    Gdy pre-generating migawka dla publikacji z filtrami sparametryzowana, migawkę danych dla każdej partycji subskrybent musi znajdować się w własny folder.Struktury katalogów dla pre-generated migawki za pomocą protokołu FTP musi przestrzegać następującą strukturę:

    alternate_snapshot_folder\ftp\publisher_publicationDB_publication\partitionID.

    Uwaga

    Wartości powyżej kursywą zależy od charakterystyki publikacja i subskrybent partycji.

  • [ @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.

    Security noteSecurity Note:

    Nie należy używać pustego hasła.Należy używać silnego hasła.

  • [ @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.W przypadku korzystania z partycji precomputed, ustawianie use_partition_groups Aby true i ustaw keep_partition_changes Aby false. Aby uzyskać więcej informacji zobacz Optymalizacja sparametryzowana wydajności filtr z Precomputed partycji.

    Uwaga

    Jeżeli określono wartość true dla keep_partition_changes, podaj wartość 1 parametr agenta migawka - MaxNetworkOptimization.Aby uzyskać więcej informacji na temat tego parametru zobacz Replication Snapshot Agent. Aby uzyskać informacje dotyczące sposobu określenia parametrów agent, zobacz temat Administering Replication Agents.

  • [ @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.Rozmiar baza danych subskrypcja kopiowanego musi być mniejsza niż 2 gigabajty (GB).

  • [ @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.Ta informacja jest używana przez agenta korespondencji seryjnej do sprawdzania poprawności abonenta partycji.Na przykład jeśli SUSER_SNAME jest używany w filtrze parametrami wiersza, parametr powinien być @validate\_subscriber\_info=N'SUSER_SNAME()'.

    Uwaga

    Należy nie określono tego parametru, ale zamiast niego pozwolić SQL Server Aby automatycznie określić kryterium filtrowania.

  • [ @add\_to\_active\_directory = ] 'add_to_active_directory'
    Tego parametru została zastąpiona i jest obsługiwany tylko w celu zapewnienia zgodności z poprzednimi wersjami skryptów.Nie można dodać informacji publikacja do Microsoft Usługa 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.Wartość 0 dla tej właściwość oznacza brak limitu liczby procesów równoczesnych korespondencji seryjnej uruchomionych na każdym podane czas.Właściwość ta określa limit liczby równoczesnych korespondencji seryjnej procesów, które mogą być uruchamiane przed publikacja korespondencji seryjnej w jednym czas.Jeżeli istnieje więcej procesów korespondencji seryjnej, zaplanowane w tym samym czas niż wartość umożliwia uruchamianie, a następnie nadmiar zadania będą umieszczane w kolejce i zakończeniu oczekiwania, aż proces scalania aktualnie odtwarzany.

  • [ @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.Jeśli 0, to nie obowiązuje żaden limit liczby sesji migawka.W przypadku kilku procesów migawkę w harmonogramie w tym samym czasie niż wartość umożliwia uruchamianie zadań nadmiar będą umieszczane w kolejce i poczekaj na zakończenie procesu migawkę aktualnie uruchomione.

  • [ @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:

    Wartość

    Description

    true

    Publikacja wykorzystuje precomputed partycji.

    false

    Publikacja nie będzie używać precomputed partycji.

    NULL(default)

    System decyduje się na strategii partycjonowanie na partycje.

    Partycje precomputed są używane domyślnie.Aby uniknąć używania precomputed partycji use_partition_groups musi być zestaw do false. Jeśli wartością tą jest NULL, system podejmie decyzję precomputed partycje mogą być używane.Jeśli precomputed partycje nie mogą być używane, następnie tę wartość skutecznie staną się false bez generowania błędów. W takich przypadkach keep_partition_changes może być zestaw do true Aby zapewnić niektórych optymalizacji. Aby uzyskać więcej informacji zobacz Sparametryzowana filtry wierszy i Optymalizacja sparametryzowana wydajności filtr z Precomputed partycji.

  • [ @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:

    Wartość

    Wersja

    70RTM

    Microsoft SQL Server 7.0

    70SP1

    SQL Server 7.0 Z dodatkiem usługa Pack 1

    70SP2

    SQL Server 7.0 Z dodatkiem usługa Pack 2

    70SP3

    SQL Server 7.0 Z dodatkiem usługa Pack 3

    70SP4

    SQL Server 7.0 Z dodatkiem usługa Pack 4

    80RTM

    Microsoft SQL Server 2000

    80SP1

    SQL Server 2000 Dodatek usługa Pack 1

    80SP2

    SQL Server 2000 Dodatek usługa Pack 2

    80SP3

    SQL Server 2000 Dodatek usługa 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 wskazuje, że są replikowane instrukcji języka (DDL) definicja danych wykonane po Wydawca, a 0 wskazuje, że instrukcje DDL nie są replikowane.Aby uzyskać więcej informacji zobacz Wprowadzanie zmian schematu na bazy danych w publikacja.

  • [ @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.Aby uzyskać więcej informacji zobacz synchronizacja w sieci Web na czas replikacja łączenia. Do obsługi SQL Server Compact 3.5 SP1 Subskrybenci, należy określić 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.Definiuje domyślny do internetowego adresu URL, jeśli jedna nie jest jawnie zestaw po sp_addmergepullsubscription_agent jest wykonywany.

  • [ @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.Ustawienie allow_partition_realignment Aby false można zachować dane w subskrypcja z partycji stare, gdy dane wymaga były dostępne dla celów historycznych.

    Uwaga

    Dane, które pozostaje przez subskrybent od ustawienia allow_partition_realignment Aby false powinny być traktowane, tak jakby był on tylko do odczytu, jednak nie jest to realizowane przez system replikacja.

  • [ @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.

    Wartość

    Wersja

    dzień (domyślnie)

    Okres zachowywania jest określany w dniach.

    tydzień

    Okres zachowywania jest określona w tygodniach.

    miesiąc

    Okres zachowywania jest określony w miesiącach.

    rok

    Okres zachowywania jest określona w latach.

  • [ @generation\_leveling\_threshold = ] generation_leveling_threshold
    Określa liczbę zmian, które znajdują się do generacji.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.Aby uzyskać więcej informacji zobacz W jaki sposób replikacja łączenia ścieżki i wylicza zmiany.

  • [ @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 oznacza, że zmiany są przekazywane z subskrybent przed wystąpieniem reinicjowanie automatyczne.

    Important noteImportant Note:

    Jeśli dodać, usunąć lub zmienić filtr sparametryzowana oczekujące zmiany subskrybent nie można przekazać do Wydawca podczas reinicjowanie.Jeśli chcesz przekazać zmian do czasu, synchronizacja wszystkich subskrypcji przed zmianą filtr.

  • [ @conflict\_logging = ] 'conflict_logging'
    Specifies where conflict records are stored.conflict_logging is nvarchar(15), and can be one of the following values:

    Wartość

    Description

    Wydawca

    Konflikt rekordy są przechowywane przez wydawcę.

    Subskrybent

    Konflikt rekordy są przechowywane przez subskrybent, która spowodowała wystąpienie konfliktu.Nie jest obsługiwana dla SQL Server Compact 3.5 SP1 Subskrybentów.

    oba

    Konflikt rekordy są przechowywane Wydawca i subskrybent.

    NULL(default)

    Replikacja automatycznie ustawia. conflict_logging Aby oba , gdy wartość backward_comp_level jest 90RTM and to Wydawca w pozostałych przypadkach.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Remarks

sp_addmergepublication jest używane w korespondencji seryjnej replikacja.

Do listy publikacja obiektów usługi Active Directory przy użyciu parametru @ add_to_active_directory SQL Server Obiekt musi być już utworzony w usłudze Active Directory.

Jeśli istnieje wiele publikacji, publikowania tego samego obiektu bazy danych (tylko publikacje z replicate_ddl wartość 1 zreplikuje instrukcji ALTER tabela, ALTER VIEW, ALTER PROCEDURE, ALTER funkcja i instrukcje ALTER TRIGGER DDL.Jednak instrukcja ALTER tabela DROP kolumna DDL będzie replikowany przez wszystkich publikacji, które publikujesz porzuconych kolumna.

Dla SQL Server Compact 3.5 SP1 Subskrybenci wartości alternate_snapshot_folder jest używane tylko po wartości snapshot_in_default_folder jest 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.Po wydaniu instrukcje DDL nie replikowanie sp_changemergepublication można uruchamiać ponownie do replikacja DDL z powrotem ustawiony.

Uprawnienia

Only members of the sysadmin fixed server role or db_owner fixed database role can executesp_addmergepublication.