sp_changemergepublication (języka Transact-SQL)

Zmienia właściwości publikacja korespondencji seryjnej.Ta procedura składowana jest wykonywany na Wydawca na bazie publikacja.

Ikona łącza do tematuKonwencje składni Transact-SQL

Składnia

sp_changemergepublication [ @publication= ] 'publication'
    [ , [ @property= ] 'property' ]
    [ , [ @value= ] 'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]

Argumenty

  • [ @publication=\] 'publication'
    The name of the publication.publication is sysname, with no default.

  • [ @property=\] 'property'
    The property to change for the given publication.property is sysname, and can be one of the values listed in the table that follows.

  • [ @value=\] 'value'
    The new value for the specified property.value is nvarchar(255), and can be one of the values listed in the table that follows.

    W tej tabela opisano właściwości publikacja, w której mogą być zmieniane i opisuje ograniczenia dotyczące wartości tych właściwości.

    Właściwość

    Wartość

    Opis

    allow_anonymous

    true

    Subskrypcje anonimowe są dozwolone.

     

    false

    Subskrypcje anonimowe są niedozwolone.

    allow_partition_realignment

    true

    Usuwa są wysyłane do subskrybenta w celu odzwierciedlenia wyniki partycji zmienić przez usunięcie danych, która nie jest już częścią partycji abonenta.Jest to zachowanie domyślne.

     

    false

    Dane z partycji starego pozostaje na subskrybenta, gdzie zmiany danych Wydawca nie replikuj tego abonenta.Natomiast zmiany wprowadzone na subskrybenta replikowane na Wydawca.Służy to zachowuje dane muszą być dostępne do celów historycznych danych subskrypcja z partycji starego.

    allow_pull

    true

    Subskrypcji ściąganej są dozwolone dla danej publikacja.

     

    false

    Subskrypcji ściąganej nie są dozwolone dla danej publikacja.

    allow_push

    true

    Subskrypcji wypychanych są dozwolone dla danej publikacja.

     

    false

    Subskrypcji wypychanych nie są dozwolone dla danej publikacja.

    allow_subscriber_initiated_snapshot

    true

    Subskrybent mogą inicjować proces migawka.

     

    false

    Abonent nie może zainicjować proces migawka.

    allow_subscription_copy

    true

    Można skopiować bazy danych subskrypcja, które subskrybować tej publikacja.

     

    false

    Nie można skopiować bazy danych subskrypcja, które subskrybować tej publikacja.

    allow_synctoalternate

    true

    Umożliwia partner alternatywnych synchronizacji do synchronizacji z tym Wydawca.

     

    false

    Nie zezwala na partner alternatywnych synchronizacji do synchronizacji z tym Wydawca.

    allow_web_synchronization

    true

    Subskrypcje mogą być synchronizowane za pośrednictwem protokołu HTTPS.

     

    false

    Subskrypcje nie mogą być synchronizowane za pośrednictwem protokołu HTTPS.

    alt_snapshot_folder

     

    Określa lokalizację alternatywnego folderu dla migawka.

    automatic_reinitialization_policy

    1

    Zmiany są przekazywane od subskrybenta przed ustawienie ponownie inicjowane subskrypcja.

     

    0

    Subskrypcja jest zainicjować ponownie bez zmiany przekazywania pierwszego.

    centralized_conflicts

    true

    Wszystkie rekordy konfliktowe są przechowywane w Wydawca.Jeśli zmienisz tę właściwość, należy ponownie zainicjować istniejących subskrybentów.

     

    false

    Konflikt rekordy są przechowywane na serwerze, który utracił w Rozwiązywanie konfliktów.Jeśli zmienisz tę właściwość, należy ponownie zainicjować istniejących subskrybentów.

    compress_snapshot

    true

    migawka w folderze alternatywnych migawka jest kompresowany do formatu pliku CAB.Nie można skompresować migawkę w domyślnym folderze migawka.Zmiana ta właściwość wymaga Nowa migawka.

     

    false

    Domyślnie migawka nie jest skompresowany.Zmiana ta właściwość wymaga Nowa migawka.

    conflict_logging

    publisher

    Konflikt rekordy są przechowywane w Wydawca.

     

    subscriber

    Konflikt rekordy są przechowywane przez subskrybenta, które spowodowało konflikt.Nie obsługiwany dla SQL Server Compact 3.5 z dodatkiem SP1 abonentów.

     

    both

    Konflikt rekordy są przechowywane w obu Wydawca i abonenta.

    conflict_retention

     

    int , Który określa okres zachowywania dni, dla których konflikty są zachowywane.Ustawienie conflict_retention do 0 oznacza oczyszczanie konflikt nie jest niezbędna.

    description

     

    Opis publikacja.

    dynamic_filters

    true

    Publikacja jest filtrowany według klauzula dynamiczne.

     

    false

    Publikacja nie jest filtrowany dynamicznie.

    enabled_for_internet

    true

    Publikacja jest włączona dla Internetu.Protokół FTP (File Transfer Protocol) może służyć do transferu plików migawka do subskrybenta.Pliki synchronizacji w publikacja są umieszczane w katalogu C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\ftp.

     

    false

    Publikacja nie jest włączona dla Internetu.

    ftp_address

     

    Adres sieciowy usługa FTP dla dystrybutora.Określa, gdzie są przechowywane pliki migawka publikacja.

    ftp_login

     

    Nazwa użytkownika jest używane do łączenia się z usługa FTP.

    ftp_password

     

    Hasło użytkownika, który jest używany do łączenia się z usługa FTP.

    ftp_port

     

    Numer portu usługa FTP dla dystrybutora.Określa numer portu TCP witryny FTP, w którym są przechowywane pliki migawka publikacja.

    ftp_subdirectory

     

    Określa, gdzie tworzone są pliki migawka, gdy publikacja obsługuje rozmnożeniowy migawek przy użyciu protokołu FTP.

    generation_leveling_threshold

    int

    Określa liczbę zmian, które są zawarte w pokolenia.Generowanie jest kolekcja zmian, które są dostarczane do Wydawca lub abonenta.Aby uzyskać więcej informacji, zobacz Sposób scalania replikacji śledzi i wylicza zmian.

    keep_partition_changes

    true

    Zoptymalizowane synchronizacji i dotyczy subskrybenci zawierające wiersze w zmienionych partycji.Zmiana ta właściwość wymaga Nowa migawka.

     

    false

    Synchronizacja nie jest optymalizowany i partycje, które są wysyłane do subskrybentów są weryfikowane po zmianie danych w partycji.Zmiana ta właściwość wymaga Nowa migawka.

    max_concurrent_merge

     

    Jest to int reprezentująca maksymalną liczbę równoczesnych korespondencji seryjnej procesów, które mogą być uruchamiane przeciwko publikacja.Jeśli jest to 0, jest nieograniczona.Jeśli więcej niż liczba procesów seryjnej zaplanowane w tym samym czas, nadmiar zadania są wprowadzane do kolejki, dopóki nie zakończy procesu currentlmerge.

    max_concurrent_dynamic_snapshots

     

    Jest to int reprezentująca maksymalną liczbę sesji migawka wygenerować migawkę filtrowanych danych, można jednocześnie uruchomić przeciwko publikacja seryjnej że sparametryzowana zastosowań filtrów wiersza.Jeśli 0, nie ma żadnego limitu.Jeśli więcej niż liczba procesów migawka zaplanowane w tym samym czas, nadmiar zadania są wprowadzane do kolejki, dopóki nie zakończy się bieżący proces scalania.

    post_snapshot_script

     

    Określa wskaźnik .sql lokalizacji pliku.Agent dystrybucji lub scalić agenta uruchamia skrypt post-migawka, po wszystkie skrypty replikowanych obiektów i dane zostały zastosowane podczas synchronizacja początkowa.Zmiana ta właściwość wymaga Nowa migawka.

    pre_snapshot_script

     

    Określa wskaźnik .sql lokalizacji pliku.Agent scalić uruchamia skrypt pre-migawka przed jakimkolwiek skrypty replikowanych obiektów, stosując migawkę na subskrybenta.Zmiana ta właściwość wymaga Nowa migawka.

    publication_compatibility_level

    100RTM

    SQL Server 2008

    90RTM

    SQL Server 2005

     

    80SP3

    SQL Server 2000 SP3

    80SP2

    SQL Server 2000 Z DODATKIEM SP2

     

    80SP1

    SQL Server 2000 Z DODATKIEM SP2

     

    80RTM

    SQL Server 2000

     

    70 SP4

    SQL Server 7.0 Z DODATKIEM SP4

     

    70SP3

    SQL Server 7.0 Z DODATKIEM SP3

     

    70SP2

    SQL Server 7.0 Z DODATKIEM SP2

     

    70SP1

    SQL Server 7,0 SP1

     

    70RTM

    SQL Server 7.0

    publish_to_activedirectory

    true

    Ten parametr zaniechano i jest obsługiwany tylko dla zgodności ze starszymi wersjami skryptów.Nie można dodawać publikacja informacji w usłudze Active Directory.

     

    false

    Usuwa publikacja informacji z usługi Active Directory.

    replicate_ddl

    1

    Instrukcji Definition Language (DDL) danych, które są wykonywane w Wydawca są replikowane.

     

    0

    Instrukcje DDL nie są replikowane.

    retention

     

    Jest to int , reprezentuje liczbę retention_period_unit jednostki, dla której chcesz zapisać zmiany w danej publikacja.Jeśli subskrypcja nie jest zsynchronizowane w okresie zachowywania i oczekujące zmiany, czy otrzymały zostały usunięte przez operację oczyszczania na dystrybutora, subskrypcja wygasa i należy ponownie zainicjować.Okres zachowywania maksymalny dopuszczalny jest liczba dni między 31 grudnia 9999, a data bieżącą.

    UwagaUwaga:
    Okres zachowywania dla publikacji seryjnej ma 24-godzinny okres prolongaty, aby pomieścić subskrybentów w różnych czas stref.

    retention_period_unit

    day

    Okres zachowywania jest określony w dniach.

     

    week

    Okres zachowywania jest określona w tygodniach.

     

    month

    Okres zachowywania jest określona w miesiącach.

     

    year

    Okres zachowywania podano w latach.

    snapshot_in_defaultfolder

    true

    migawka pliki są przechowywane w folderze domyślnym migawka.

     

    false

    Migawki pliki są przechowywane w lokalizacji alternatywnej, jest określona przez alt_snapshot_folder.Ta kombinacja Określa, że pliki migawka są przechowywane w lokalizacji domyślnej i alternatywne.

    snapshot_ready

    true

    Migawki publikacja jest dostępny.

     

    false

    Migawki w publikacja nie jest dostępna.

    status

    active

    Publikacja jest w stanie aktywnym.

     

    inactive

    Publikacja jest nieaktywny.

    sync_mode

    native lub

    bcp native

    Dane wyjściowe programu bulk copy trybu macierzystego wszystkich tabel jest używany dla migawka początkowa.

     

    character

    lub bcp character

    Dane wyjściowe programu bulk copy tryb znakowy wszystkich tabel jest używany dla migawka początkowa, który jest wymagany dla wszystkich innych niż-SQL Server abonentów.

    use_partition_groups

    UwagaUwaga:
    Po użyciu partition_groups, jeśli można przywrócić za pomocą setupbelongs, i zestaw use_partition_groups=false w changemergearticle, to może nie być poprawnie odzwierciedlone po podjęciu migawka.Wyzwalacze generowanych przez migawka są zgodne z grupami partycji.Obejście problemu w tym scenariuszu jest zestaw zmodyfikować stan nieaktywny, use_partition_groups, a następnie zestaw stan aktywny.

    true

    Publikacja używa precomputed partycji.

     

    false

    Publikacja nie używać partycji precomputed.

    validate_subscriber_info

     

    Wyświetla listę funkcji, które są używane do pobierania informacji subskrybenta.Następnie sprawdza dynamiczne kryteria filtrowania, które jest używane dla subskrybenta zweryfikować, że informacja jest podzielony na partycje konsekwentnie.

    web_synchronization_url

     

    Domyślna wartość internetowy adres URL używany dla synchronizacja w sieci Web.

    NULL(default)

     

    Zwraca listę obsługiwanych wartości dla property.

  • [ @force_invalidate_snapshot = ] force_invalidate_snapshot
    Acknowledges that the action taken by this stored procedure might invalidate an existing snapshot.force_invalidate_snapshot is a bit, with a default of 0.

    0 Określa, że zmiana publikacja nie unieważnia migawka.Jeżeli procedura składowana wykryje, że zmiana wymaga Nowa migawka, wystąpi błąd i nie wprowadzono żadnych zmian.

    1 Określa, zmiana invvalidate może publikacja migawka.W przypadku istniejących subskrypcji, wymagające Nowa migawka daje uprawnienie dla istniejących migawki oznaczone jako przestarzałe i Nowa migawka ma być generowany.

    Zobacz sekcję Spostrzeżenia właściwości, po zmianie wymagają Nowa migawka mają zostać wygenerowane.

  • [ @force_reinit_subscription = ] force_reinit_subscription
    Acknowledges that the action taken by this stored procedure might require existing subscriptions to be reinitialized.force_reinit_subscription is a bit with a default of 0.

    0 Określa, że zmiana publikacja nie wymaga subskrypcji należy ponownie zainicjować.Jeżeli procedura składowana wykryje, że zmiana wymaga istniejących subskrypcji należy ponownie zainicjować, wystąpi błąd i nie wprowadzono żadnych zmian.

    1 Określa, że zmiana publikacja powoduje istniejących subskrypcja należy ponownie zainicjować i daje uprawnienie dla ponownego zainicjowania subskrypcja występuje.

    Zobacz sekcję Spostrzeżenia właściwości, po zmianie wymagają wszystkich istniejących subskrypcji należy ponownie zainicjować.

Wartości kodów powrotnych

0(sukces) lub 1 (błąd)

Uwagi

sp_changemergepublication jest używany w replikacja scalająca.

Zmienianie następujących właściwości wymaga wygenerowana Nowa migawka.Użytkownik musi określić wartość 1 dla force_invalidate_snapshot parametru.

  • alt_snapshot_folder

  • compress_snapshot

  • dynamic_filters

  • ftp_address

  • ftp_login

  • ftp_password

  • ftp_port

  • ftp_subdirectory

  • post_snapshot_script

  • publication_compatibility_level(do 80SP3 only)

  • pre_snapshot_script

  • snapshot_in_defaultfolder

  • sync_mode

  • use_partition_groups

Zmiana następujących właściwości wymaga, czy istniejące subskrypcji należy ponownie zainicjować.Należy określić wartość 1 dla force_reinit_subscription parametru.

  • dynamic_filters

  • validate_subscriber_info

Do listy obiektów publikacja do usługi Active Directory przy użyciu publish_to_active_directory, SQL Server obiektu musi być już utworzony w usłudze Active Directory.

Przykład

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge'; 

-- Disable DDL replication for the publication.
USE [AdventureWorks2008R2]
EXEC sp_changemergepublication 
  @publication = @publication, 
  @property = N'replicate_ddl', 
  @value = 0,
  @force_invalidate_snapshot = 0, 
  @force_reinit_subscription = 0;
GO

Uprawnienia

Tylko członkowie sysadmin stała rola serwera lub db_owner ustaloną rola bazy danych można wykonać sp_changemergepublication.