Udostępnij za pośrednictwem


sp_changemergearticle (języka Transact-SQL)

Zmienia właściwości artykuł korespondencji seryjnej.Ta procedura przechowywana jest wykonywana przez wydawcę na baza danych publikacja.

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

sp_changemergearticle [ @publication = ] 'publication'
        , [ @article = ] 'article'
    [ , [ @property = ] 'property' ]
    [ , [ @value = ] 'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]

Argumenty

  • [ @publication=] 'publication'
    Is the name of the publication in which the article exists.publication is sysname, with no default.

  • [ @article=] 'article'
    Is the name of the article to change.article is sysname, with no default.

  • [ @property=] 'property'
    Is the property to change for the given article and publication.property is nvarchar(30), and can be one of the values listed in the table.

  • [ @value=] 'value'
    Is the new value for the specified property.value is nvarchar(1000), and can be one of the values listed in the table.

    Poniższa tabela zawiera opis właściwości artykułów i wartości tych właściwości.

    Właściwość

    Values

    Description

    allow_interactive_resolver

    wartość true

    Umożliwia korzystanie z interaktywnej program rozpoznawania nazw do artykuł.

     

    FAŁSZ

    Wyłącza używanie interakcyjne programu rozpoznawania nazw do artykuł.

    article_resolver

     

    Program rozpoznawania nazw niestandardowych do artykuł.Ma zastosowanie wyłącznie w artykule tabela.

    check_permissions (mapa bitowa)

    0x00

    Uprawnienia poziom tabela nie są sprawdzane.

     

    0x10

    Uprawnienia poziom tabela są sprawdzane w Wydawca przed zastosowaniem w instrukcji INSERT dokonane przez subskrybent Wydawca.

     

    0x20

    Uprawnienia poziom tabela są sprawdzane w Wydawca przed UPDATE oświadczeń subskrybent są stosowane na Wydawca.

     

    0x40

    Uprawnienia poziom tabela są sprawdzane przez wydawcę, przed zastosowaniem instrukcji DELETE subskrybent przez wydawcę.

    column_tracking

    wartość true

    Włącza śledzenie poziom kolumna.Ma zastosowanie wyłącznie w artykule tabela.

    NoteNote:
    Śledzenie poziom kolumna nie mogą być używane podczas publikowania tabele zawierające więcej niż 246 kolumna.

     

    FAŁSZ

    Wyłącza śledzenie poziom kolumna i pozostawia wykrywanie konfliktów poziom wiersza.Ma zastosowanie wyłącznie w artykule tabela.

    compensate_for_errors

    wartość true

    Kompensacyjne akcje są wykonywane po wystąpieniu błędu podczas synchronizacji.Aby uzyskać więcej informacji zobacz sp_addmergearticle.

     

    FAŁSZ

    Kompensacyjne akcje nie są wykonywane, co jest zachowaniem domyślnym.Aby uzyskać więcej informacji zobacz sp_addmergearticle.

    Important noteImportant Note:
    Dane w wierszach usterce może się wydawać z zbieżność, tak szybko, jak rozwiązać ewentualne błędy, można zastosować zmiany, a dane będą zostanie uzyskana zbieżność funkcji.Jeśli urządzenie źródłowe tabela do artykuł jest już opublikowany w innej publikacja, a następnie wartość compensate_for_errors muszą być takie same dla obu artykułów.

    creation_script

     

    ścieżka i nazwę skryptu schematu opcjonalne artykułu używany do tworzenia artykuł w baza danych subskrypcja.

    delete_tracking

    wartość true

    DELETE instrukcje są replikowane, co jest zachowaniem domyślnym.

     

    FAŁSZ

    DELETE instrukcji nie są replikowane.

    Important noteImportant Note:
    Ustawienie delete_tracking to FAŁSZ wyniki w innych niż zbieżności oraz usunięte wiersze muszą być usunięte ręcznie.

    Opis

     

    Opisowy wpis artykuł.

    destination_owner

     

    Nazwa właściciela obiektu w bazie danych subskrypcja, jeśli nie dbo.

    identity_range

     

    bigint określająca rozmiar zakres do przypisywania nowych wartości tożsamości, jeśli zawiera artykuł identityrangemanagementoption zestaw to automatyczne or auto_identity_range zestaw to wartość true.Stosuje się do tabela tylko artykuł.Aby uzyskać więcej informacji zobacz część "Scalania replikacja" Replikowanie kolumny tożsamości.

    identityrangemanagementoption

    Ręczne

    Wyłącza automatyczne tożsamości zakres zarządzania.Oznacza kolumny identyfikacji Włącz obsługę zakres tożsamości ręcznie za pomocą nie do replikacja.Aby uzyskać więcej informacji zobacz Replikowanie kolumny tożsamości.

     

    Brak

    Wyłącza wszystkie zarządzania zakres tożsamości.

    logical_record_level_conflict_detection

    wartość true

    Wykryto konflikt, jeśli zmiany zostaną wprowadzone w dowolnym miejscu w rekord logiczny.Wymaga, aby logical_record_level_conflict_resolution be zestaw to wartość true.

     

    FAŁSZ

    Wykrywanie konfliktów domyślny jest używany określone przez column_tracking.

    logical_record_level_conflict_resolution

    wartość true

    Cały zwycięża rekord logiczny są zastępowane przegrywająca rekordu logiczne.

     

    FAŁSZ

    Wygranie wierszy nie są ograniczone do logicznego rekordu.

    partition_options

    0

    The filtering for the article either is static or does not yield a unique subset of data for each partition, i.e.an "overlapping" partition.

     

    1

    Partycje są nakładające się i DML aktualizacje dokonane przez subskrybent nie można zmienić tej partycji, do której należy dany wiersz.

     

    2

    Filtrowanie artykuł daje siebie partycji, ale wielu subskrybentów mogą odbierać tej samej partycji.

     

    3

    Filtrowanie artykuł daje siebie partycje, które są unikatowe dla każdej subskrypcja.

    NoteNote:
    Jeżeli określono wartość 3 for partition_options, może istnieć tylko jeden subskrypcja dla każdej partycji danych w tym artykuł.Jeśli tworzony jest drugim subskrypcja, w którym kryterium filtrowania nowej subskrypcja zamienia się na tej samej partycji co istniejących subskrypcja, zostanie usunięte istniejących subskrypcja.

    pre_creation_command

    Brak

    Jeśli istnieje już w tabela przez subskrybent, nie zostaną podjęte żadne akcja.

     

    Usuwanie

    Problemy, usuwanie, oparte na klauzulę WHERE w filtrze podzbiór.

     

    Upuść

    Już w tabela przed jej odtwarzania.

     

    Przycinanie

    Funkcja obcina tabela docelowej.

    processing_order

     

    int oznacza to, kolejność przetwarzania artykułach w publikacja korespondencji seryjnej.

    pub_identity_range

     

    bigint określająca rozmiar zakres, przydzielony do subskrybent z serwerem subskrypcja jeśli artykuł identityrangemanagementoption zestaw to automatyczne or auto_identity_range zestaw to wartość true.Ten zakres tożsamości jest zarezerwowany dla subskrybent republishing przypisanej do swoich własnych subskrybent.Stosuje się do tabela tylko artykuł.Aby uzyskać więcej informacji zobacz część "Scalania replikacja" Replikowanie kolumny tożsamości.

    published_in_tran_pub

    wartość true

    Artykuł jest też publikowana w publikacja transakcyjnych.

     

    FAŁSZ

    Artykuł nie jest też publikowana w publikacja transakcyjnych.

    resolver_info

     

    Służy do określania dodatkowe informacje wymagane przez niestandardowego programu rozpoznawania nazw.Some of the Microsoft Resolvers require a column provided as input to the resolver.resolver_info is nvarchar(255), with a default of NULL.Aby uzyskać więcej informacji zobacz Programy rozpoznawania nazw opartych na modelu COM firmy Microsoft.

    schema_option (mapa bitowa)

    Aby uzyskać więcej informacji zobacz sekcję Spostrzeżenia w dalszej części tego tematu.

     

    0x00

    Powoduje wyłączenie wykonywanie wykonywanie skryptów przez agenta migawka i wykorzystuje w skrypcie creation_script.

     

    0x01

    Generuje skrypt tworzenia obiektu (CREATE tabela, CREATE PROCEDURE itd.).

     

    0x10

    Generuje odpowiedni indeks klastrowany.

     

    0x20

    Konwertuje typy danych zdefiniowane przez użytkownika oparcie typów danych przez subskrybent.Nie można użyć tej opcji, gdy istnieje wyboru lub DEFAULT ograniczenia w odniesieniu do kolumny, typ zdefiniowany przez użytkownika (UDT), jeśli kolumna UDT jest częścią klucz podstawowy lub kolumna obliczana odwołuje się do kolumny UDT.

     

    0x40

    Generuje odpowiednie ponownego zbudowania indeksów nie klastrowanych.

     

    0x80

    Zawiera zadeklarowanej więzów integralność dla kluczy podstawowych.

     

    0x100

    Replikuje użytkownika wyzwalaczy w artykule tabela, jeśli została zdefiniowana.

     

    0x200

    Replikuje ograniczenia klucz obcy.Jeśli tabela, do którego istnieje odwołanie, nie jest częścią publikacja w sieci, nie są replikowane wszystkie ograniczenia klucz obcy dla tabeli, opublikowany.

     

    0x400

    Replikuje ograniczeń CHECK.

     

    0x800

    Replikuje ustawień domyślnych.

     

    0x1000

    Replikuje poziomie kolumna sortowanie.

     

    0x2000

    Replikacja rozszerzone właściwości skojarzone z obiekt źródłowy opublikowanego artykuł.

     

    0x4000

    Jeśli została zdefiniowana w artykule tabela jest replikowany unikatowe klucze.

     

    0x8000

    Generuje instrukcji ALTER tabela, gdy wykonywanie wykonywanie skryptów ograniczeń.

     

    0x10000

    Replikuje ograniczeń CHECK jako nie dla replikacja, tak aby ograniczenia nie są wymuszane podczas synchronizacji.

     

    0x20000

    Replikuje ograniczenia klucz obcy jako nie dla replikacja, tak aby ograniczenia nie są wymuszane podczas synchronizacji.

     

    0x40000

    Replikuje filegroups skojarzonych z tabela partycjonowana lub indeksu.

     

    0x80000

    Replikuje schemat partycji tabela partycjonowana.

     

    0x100000

    Replikuje schemat partycji indeks partycjonowany.

     

    0x200000

    Replikacja tabela statystyk.

     

    0x400000

    Replikuje wiązania domyślnego

     

    0x800000

    Powiązania reguł powtórzeń

     

    0x1000000

    Replikuje indeks pełnotekstowy

     

    0x2000000

    Powiązany z kolekcji schematu XML xml kolumny nie są replikowane.

     

    0x4000000

    Replikuje indeksy na xml kolumny.

     

    0x8000000

    Utwórz wszystkie schematy nie jest już obecny na subskrybent.

     

    0x10000000

    Konwertuje xml kolumny ntext na subskrybent.

     

    0x20000000

    Konwertuje dużego obiektu (typy danychnvarchar(max), varchar(max), a varbinary(max)) w programie wprowadzono SQL Server 2005 typy danych, które są obsługiwane w SQL Server 2000. Aby uzyskać informacje na temat sposobu mapowania tego typu zobacz sekcję "Mapowanie nowych danych typy dla starszych wersji" w Using Multiple Versions of SQL Server in a Replication Topology.

     

    0x40000000

    Replikowanie uprawnienia.

     

    0x80000000

    Spróbuj usunąć zależności do żadnych obiektów, które nie są dodawane do publikacja.

    0x100000000

    Użyj tej opcji, aby replikować atrybut FILESTREAM, jeśli jest określona na varbinary(max) kolumny. Nie określono tej opcji, jeśli jest replikowana tabel do SQL Server 2005 Subskrybentów. Replikowanie tabele, które mają FILESTREAM kolumny SQL Server 2000 Subskrybenci nie jest obsługiwany, niezależnie od tego, w jaki sposób ta opcja schematu zestaw. Zobacz pokrewne opcji 0x800000000.

    0x200000000

    Konwertuje data i czas (typy danychdate, time, datetimeoffset, a datetime2), są wprowadzane w SQL Server 2008 typy danych, które są obsługiwane we wcześniejszych wersjach SQL Server. Aby uzyskać informacje na temat sposobu mapowania tego typu zobacz sekcję "Mapowanie nowych danych typy dla starszych wersji" w Using Multiple Versions of SQL Server in a Replication Topology.

    0x400000000

    Replikuje opcję kompresji dla danych i indeksów.Aby uzyskać więcej informacji zobacz Creating Compressed Tables and Indexes.

    0x800000000

    zestaw tę opcję, aby przechowywać dane FILESTREAM na swoją własną grupa plików przez subskrybent.Jeśli ta opcja nie jest zestaw, FILESTREAM dane są przechowywane na grupa plików domyślnych.Replikacja nie tworzy filegroups; z tego powodu, jeśli wybierzesz tę opcję, należy utworzyć grupa plików, w przed zastosowaniem migawka przez subskrybent.Aby uzyskać więcej informacji na temat tworzenia obiektów, przed zastosowaniem migawka zobacz Wykonywanie skryptów przed i po migawka jest stosowana..

    Zobacz pokrewne opcji 0x100000000.

    0x1000000000

    Konwertuje typowych języków plików wykonywalnych (CLR) typów zdefiniowanych przez użytkownika (UDTs) varbinary(max) tak, aby kolumny typu UDT mogą być replikowane do subskrybentów, na których jest uruchomiony SQL Server 2005.

    0x2000000000

    Konwertuje hierarchyid Typ danych varbinary(max) tak, aby kolumny typu hierarchyid mogą być replikowane do subskrybentów, na których jest uruchomiony SQL Server 2005. Aby uzyskać więcej informacji na temat sposobów korzystania z hierarchyid kolumny w zreplikowanych tabelach, zobacz hierarchyid (Transact-SQL).

    0x4000000000

    Replikuje żadnych filtrowane indeksów w tabela.Aby uzyskać więcej informacji na temat indeksów filtrowane zobacz Wskazówki dotyczące projektowania indeks filtrowane.

     

    0x8000000000

    Konwertuje geography i geometry typy danych do varbinary(max) tak, aby kolumny tego typu mogą być replikowane do subskrybentów, na których jest uruchomiony SQL Server 2005.

     

    0x10000000000

    Replikuje indeksy na kolumnach typu geography i geometry.

     

    WARTOŚCI NULL

    System automatycznie generuje opcji prawidłowego schematu do artykuł.

    Stan

    aktywne

    Wstępne przetwarzanie skryptu do opublikowania w tabela jest uruchamiany.

     

    unsynced

    Wstępne przetwarzanie do opublikowania w tabela uruchomieniu czas uruchomienia agenta migawka.

    stream_blob_columns

    wartość true

    Optymalizacją strumień danych jest używany podczas replikowania kolumn duży obiekt binarny.Jednak niektóre funkcje replikacja łączenia, takich jak logiczne, nadal można zapobiec optymalizacji strumienia z użycia.

    Important noteImportant Note:
    Włączanie Optymalizacja pamięci może być wówczas wykonywania korespondencji seryjnej Agent podczas synchronizacji.Ta opcja powinna być używana tylko wtedy, podczas replikowania kolumny zawierające megabajtów danych.

     

    FAŁSZ

    Optymalizację nie jest używany podczas replikowania kolumn duży obiekt binarny.

    subscriber_upload_options

    0

    Nie ograniczenia dotyczące aktualizacji subskrybent z klient subskrypcja; zmiany są przekazywane do Wydawca.Zmiana tej właściwość może wymagać, czy istniejące ustawienie ponownie subskrybentów być inicjowane.

     

    1

    Zmiany są dozwolone na subskrybent z subskrypcja kliencka, ale nie są one przekazywane do Wydawca.

     

    2

    Zmiany nie są dozwolone w subskrybent z subskrypcją klient.

    subset_filterclause

     

    Określając poziomy filtrowanie klauzula WHERE.Ma zastosowanie wyłącznie w artykule tabela.

    Important noteImportant Note:
    Ze względu na wydajność zaleca się nie zastosowanie funkcji nazw kolumn w sparametryzowana wiersz filtru klauzule, takie jak LEFT([MyColumn]) = SUSER_SNAME(). Jeśli używasz HOST_NAME w klauzula filtru i zastępowania wartości HOST_NAME, może zajść potrzeba konwersji typów danych przy użyciu KONWERTOWANIE.Aby uzyskać więcej informacji o najważniejszych wskazówkach dotyczących tej przypadek zobacz sekcję "Zastępowanie HOST_NAME() wartość" w Sparametryzowana filtry wierszy.

    próg

     

    Percentage value used for Subscribers running SQL Server Compact 3.5 SP1 or earlier versions of SQL Server.threshold controls when the Merge Agent assigns a new identity range.Użyto wartości procentowej wartości określonej w próg Agent scalanie tworzy nowy zakres tożsamości.Kiedy używać identityrangemanagementoption is zestaw to automatyczne or auto_identity_range is zestaw to wartość true.Stosuje się do tabela tylko artykuł.Aby uzyskać więcej informacji zobacz część "Scalania replikacja" Replikowanie kolumny tożsamości.

    verify_resolver_signature

    1

    Podpis cyfrowy niestandardowego programu rozpoznawania nazw jest weryfikowana w celu ustalenia, czy jest on z zaufanego urządzenie źródłowe.

     

    0

    Podpis cyfrowy niestandardowego programu rozpoznawania nazw nie został zweryfikowany można określić, czy jest on z zaufanego urządzenie źródłowe.

    NULL (default)

     

    Zwraca listę obsługiwanych wartości property.

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

    0 Określa, które zmienia się na scalanie artykuł nie powodują migawka jest nieprawidłowy.Jeśli procedura przechowywana wykryje, że zmiana wymaga nowej migawka, wystąpi błąd i nie są wprowadzane żadne zmiany.

    1 oznacza, że zmiany do korespondencji seryjnej artykuł może spowodować, że migawka jest nieprawidłowa, a w przypadku istniejących subskrypcji, wymagające nowych migawka daje uprawnienie dla istniejących migawka został oznaczony jako przestarzały i generowane nowe migawka.

    Zobacz sekcję Spostrzeżenia dla właściwości, które po zmianie wymagają generowanie nowych migawka.

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

    0 Określa, które zmienia się na scalanie artykuł nie powodują subskrypcję, aby się ustawienie ponownie inicjowane.Jeśli procedura przechowywana wykryje, że zmiana wymaga istniejącej subskrypcji na ustawienie można ponownie inicjowane, wystąpi błąd i nie są wprowadzane żadne zmiany.

    1 oznacza, że zmiany do korespondencji seryjnej artykuł spowodować istniejących subskrypcja ustawienie ponownie inicjowane i daje uprawnienia dla reinicjowanie subskrypcja wystąpienia.

    Zobacz sekcję Spostrzeżenia dla właściwości, które po zmianie wymagają ustawienie ponownie czy wszystkich istniejących subskrypcji jest inicjowane.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Remarks

sp_changemergearticle jest używany w replikacja łączenia.

Ponieważ sp_changemergearticle Umożliwia zmianę właściwości artykuł, które pierwotnie zostały określone za pomocą sp_addmergearticle, refer to sp_addmergearticle , aby uzyskać dodatkowe informacje na temat tych właściwości.

Zmienianie następujących właściwości wymaga, że można wygenerować nowego migawka i należy określić wartość 1 for the force_invalidate_snapshot parametr:

  • check_permissions

  • column_tracking

  • destination_owner

  • pre_creation_cmd

  • schema_options

  • subset_filterclause

Zmienianie następujących właściwości wymaga, czy istniejące ustawienie subskrypcji ponownie być inicjowane, a należy określić wartość 1 for the force_reinit_subscription parametr:

  • check_permissions

  • column_tracking

  • destination_owner

  • subscriber_upload_options

  • subset_filterclause

Podczas określania wartości 3 partition_options, metadane jest czyszczona za każdym razem, gdy działa agent korespondencji seryjnej i podzielonym na partycje migawka wygasa szybciej.W przypadku korzystania z tej opcji, należy rozważyć włączenie subskrybent żądanych partycjonowana migawka.Aby uzyskać więcej informacji zobacz Migawki publikacji korespondencji seryjnej z filtrami sparametryzowana.

Podczas ustawiania column_tracking właściwość, jeśli tabela jest już opublikowany w innych publikacjach scalających kolumna, śledzenie musi być taka sama jak wartość używana przez istniejącą artykułów na podstawie tej tabeli.Ten parametr dotyczy tylko artykuły tabela.

Wiele publikacji publikowania artykułów na podstawie tej samej tabela podstawowej, zmiana delete_tracking Właściwość lub compensate_for_errors właściwości w jednym artykule powoduje, że te same zmiany mają być wprowadzone do innych artykułów, które są oparte na tej samej tabela.

Jeśli konto logowania użytkownika/Wydawca używane przez proces korespondencji seryjnej nie ma uprawnień właściwej tabela, jak konflikty są rejestrowane zmiany nieprawidłowe.

Po zmianie wartości schema_option, system wykonuje bitowe aktualizacji.Oznacza to, że po ustawieniu schema_option using sp_changemergearticle, istniejące ustawienia bitowego może być wyłączona.Aby zachować istniejące ustawienia, należy wykonać & (I bitowe) między wartością, której ustawiasz i bieżącą wartość schema_option, które mogą być określone przez sp_helpmergearticle.

Prawidłowa tabela opcji schematu

The following table describes the allowed schema_optionvalues, depending on article type.

Typ artykuł

Wartości opcji schematu

tylko schematu FUNC

0x01 and 0x2000

tylko schematu widok indeksowany

0x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000, and 0x200000

tylko schematu proc

0x01 and 0x2000

tabela

Wszystkie opcje.

tylko schematu widoku

0x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000, and 0x200000

Uprawnienia

Tylko członkowie sysadmin Rola serwera lub db_owner stała rola bazy danych może być wykonywany sp_changemergearticle.