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.
.gif "Topic link icon")
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.
.gif "Note")
Note:
Ś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.
.gif "Important note")
Important 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 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.
Note:
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 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 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.
See Also