sp_changearticle (języka Transact-SQL)

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

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

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

Argumenty

  • [ @publication=] 'publication'
    Is the name of the publication that contains the article.publication is sysname, with a default of NULL.

  • [ @article=] 'article'
    Is the name of the article whose property is to be changed.article is sysname, with a default of NULL.

  • [ @property=] 'property'
    Is an article property to change.property is nvarchar(100).

  • [ @value=] 'value'
    Is the new value of the article property.value is nvarchar(255).

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

    Właściwość

    Values

    Description

    creation_script

     

    Ścieżka i nazwa skryptu schematu artykuł używane do tworzenia tabel miejsce docelowe.Wartość domyślna jest równa NULL.

    del_cmd

     

    Instrukcja DELETE wykonać; w przeciwnym wypadku jest konstruowana z dziennika.

    Opis

     

    Nowy wpis opisowe artykuł.

    dest_object

     

    Dostarczane w celu zapewnienia zgodności z poprzednimi wersjami.Użycie dest_table.

    dest_table

     

    Nowe obiekt docelowy tabeli.

    destination_owner

     

    Nazwa właściciela obiekt docelowy obiektu.

    filtr

     

    Nowa procedura przechowywana ma być używana do filtrowania w tabela (filtrowanie poziomej).Wartość domyślna jest równa NULL.Nie można zmienić dla publikacji w replikacja równorzędna.

    fire_triggers_on_snapshot

    wartość true

    Replikowane wyzwalacze użytkownika są wykonywane, gdy migawka początkowa jest stosowana.

    NoteNote:
    Wyzwalaczy powinny być replikowane wartość maski bitowej schema_option musi zawierać wartość 0x100.

     

    FAŁSZ

    Replikowane użytkownika wyzwalacze nie są wykonywane po zastosowaniu początkowego migawka.

    identity_range

     

    Formanty rozmiar zakresów przypisanych tożsamość przypisana przez subskrybent.Nie jest obsługiwana dla replikacja równorzędna.

    ins_cmd

     

    Instrukcja INSERT; w przeciwnym razie jest konstruowana z dziennika.

    pre_creation_cmd

    Polecenie Pre-Creation, usuwanie, usuwanie lub obcinania obiekt docelowy tabela przed zastosowaniem synchronizacji.

     

    Brak

    Nie są używane polecenia.

     

    Upuść

    Krople obiekt docelowy tabela.

     

    Usuwanie

    Usuwa tabela docelową.

     

    Przycinanie

    Funkcja obcina tabela docelowej.

    pub_identity_range

     

    Formanty rozmiar zakresów przypisanych tożsamość przypisana przez subskrybent.Nie jest obsługiwana dla replikacja równorzędna.

    schema_option

    Specifies the bitmap of the schema generation option for the given article.schema_option is binary(8).Aby uzyskać więcej informacji zobacz sekcję Spostrzeżenia w dalszej części tego tematu.

     

    0x00

    Wyłącza wykonywanie wykonywanie skryptów przez agenta migawka.

     

    0x01

    Generuje tworzenia obiektów (CREATE tabela, CREATE PROCEDURE itd.).

     

    0x02

    Generuje procedur przechowywanych, które propagowanie zmian do artykuł, jeśli została zdefiniowana.

     

    0x04

    Kolumny identyfikacji są przetwarzane przez skrypty przy użyciu właściwość IDENTITY.

     

    0x08

    Replikowanie timestamp kolumny. Jeśli nie zestaw, timestamp kolumny są replikowane jako binary.

     

    0x10

    Generuje odpowiedni indeks klastrowany.

     

    0x20

    Typy danych zdefiniowane przez użytkownika konwertuje (UDT) Aby oprzeć typów danych przez subskrybent.Nie można użyć tej opcji, gdy istnieje ograniczenie wyboru lub DEFAULT kolumną UDT kolumny UDT jest częścią klucz podstawowy lub kolumna obliczana odwołuje się do kolumny UDT.Nie jest obsługiwana dla Oracle wydawcy.

     

    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

    Replikuje dane na klucz podstawowy i unikatowe klucze w artykule tabela jako warunki ograniczające przy użyciu instrukcji ALTER tabela.

    NoteNote:
    Opcja ta została zaniechana.Użycie 0x80 and 0x4000 zamiast niego.

     

    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

    Domyślnie powiązania

     

    0x800000

    Powiązania reguł

     

    0x1000000

    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 wspólnego języka (CLR) w czasie wykonywania typów zdefiniowanych przez użytkownika (UDTs) większy niż 8000 bajtów przeznaczonych do 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.

    0x20000000000

    Replikuje ROZRZEDZANIA atrybut dla kolumny.Aby uzyskać więcej informacji na temat tego atrybut zobacz Using Sparse Columns.

    Stan

    Określa stan nowej właściwość.

     

    partycje poziome DTS

    Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.

     

    Dołącz kolumna nazw

    kolumna nazw znajdują się w replikowanych instrukcja INSERT.

     

    nie kolumna nazw

    kolumna nazwy nie są zawarte w replikowanych instrukcja INSERT.

     

    na żadnych partycjach poziome dts

    Poziomy partycji artykuł nie jest zdefiniowany przez umożliwiającego przejście subskrypcja.

     

    Brak

    Czyści wszystkie opcje stanu w sysarticles tabela i oznacza artykuł jako nieaktywne.

     

    parametry

    Zmiany są propagowane do subskrybent za pomocą poleceń z parametrami.Jest to ustawienie domyślne dla nowego artykuł.

     

    string literals

    Zmiany są propagowane do subskrybent przy użyciu wartości literału ciąg.

    sync_object

     

    Nazwa tabela lub widoku używanego do utworzenia pliku wyjściowego do synchronizacji.Wartość domyślna jest równa NULL.Nie jest obsługiwana dla Oracle wydawcy.

    obszar tabel

    Identyfikuje obszar tabel, używane przez tabela rejestrowania artykuł opublikowane z bazy danych Oracle.Aby uzyskać więcej informacji zobacz Zarządzanie Tablespaces bazy danych Oracle.

    próg

     

    Wartość procentową, która kontroluje, kiedy Agent dystrybucji przypisuje nowy zakres tożsamości.Nie jest obsługiwana dla replikacja równorzędna.

    Typ

     

    Nie jest obsługiwana dla Oracle wydawcy.

     

    logbased

    Artykuł opartego na dzienniku.

     

    logbased manualboth

    Artykuł opartego na dzienniku ręczne filtru i ręczne widoku.Ta opcja wymaga, aby sync_object i filter również zestaw właściwości. Nie jest obsługiwana dla Oracle wydawcy.

     

    logbased manualfilter

    Artykuł opartego na dzienniku z filtrem ręcznie.Ta opcja wymaga, aby sync_object i filter również zestaw właściwości. Nie jest obsługiwana dla Oracle wydawcy.

     

    logbased manualview

    Artykuł opartego na dzienniku z widokiem ręcznie.Ta opcja wymaga, aby sync_object Właściwość również być zestaw. Nie jest obsługiwana dla Oracle wydawcy.

     

    indexed viewlogbased

    Widok indeksowany, opartego na dzienniku artykuł.Nie jest obsługiwana dla Oracle wydawcy.Dla tego typu artykuł tabela bazowa nie jest konieczne publikowanie oddzielnie.

     

    indexed viewlogbased manualboth

    Widok indeksowany, opartego na dzienniku artykuł ręczne filtru i ręczne widoku.Ta opcja wymaga, aby sync_object i filter również zestaw właściwości. Dla tego typu artykuł tabela bazowa nie jest konieczne publikowanie oddzielnie.Nie jest obsługiwana dla Oracle wydawcy.

     

    indexed viewlogbased manualfilter

    Widok indeksowany, opartego na dzienniku artykuł z filtrem ręcznie.Ta opcja wymaga sync_object i filter również zestaw właściwości. Dla tego typu artykuł tabela bazowa nie jest konieczne publikowanie oddzielnie.Nie jest obsługiwana dla Oracle wydawcy.

     

    indexed viewlogbased manualview

    Widok indeksowany, opartego na dzienniku artykuł z widokiem ręcznie.Ta opcja wymaga, aby sync_object Właściwość również być zestaw. Dla tego typu artykuł tabela bazowa nie jest konieczne publikowanie oddzielnie.Nie jest obsługiwana dla Oracle wydawcy.

    upd_cmd

     

    Instrukcja UPDATE do wykonać; w przeciwnym wypadku jest konstruowana z dziennika.

    WARTOŚCI NULL

    WARTOŚCI NULL

    Zwraca listę właściwości artykuł, które mogą być zmieniane.

  • [ @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óry zmienia się na 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 Określa, że zmiany w artykule może spowodować, że migawka jest nieprawidłowa, a w przypadku istniejących subskrypcji, wymagające migawka nowych 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óry zmienia się na 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 Określa, że zmiany w artykule powoduje 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.

  • [ Wydawca @ = ] "publisher'
    Specifies a non-SQL Server Publisher.publisher is sysname, with a default of NULL.

    Uwaga

    publisher nie należy używać podczas zmiany właściwości artykuł na SQL Server Wydawca.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Remarks

sp_changearticle jest używana w przypadku replikacja migawka i replikacji transakcyjnej.

Gdy artykuł należy do publikacja, która obsługuje replikacja transakcyjnej typu peer-to-peer, można zmieniać tylko Opis, ins_cmd, upd_cmd, and del_cmd właściwości.

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

  • del_cmd

  • dest_table

  • destination_owner

  • ins_cmd

  • pre_creation_cmd

  • schema_options

  • upd_cmd

Zmiana dowolnego z 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.

  • del_cmd

  • dest_table

  • destination_owner

  • filter

  • ins_cmd

  • status

  • upd_cmd

W ramach istniejącej publikacja można użyć sp_changearticle zmianę artykuł bez konieczności usunąć i odtworzyć w całej publikacja.

Uwaga

Po zmianie wartości schema_option, system nie wykonuje aktualizacji bitowe. Oznacza to, że po ustawieniu schema_option za pomocą sp_changearticle, 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_helparticle.

Prawidłowe opcje schematu

W poniższej tabela opisano wartości dopuszczalne schema_option na podstawie typu replikacja (wyświetlane u góry) oraz typ artykuł (przedstawione w pierwszej kolumnie).

Typ artykuł

Typ replikacja

 

 

Transakcyjne

migawka

logbased

Wszystkie opcje

Wszystkie opcje, ale 0x02

logbased manualfilter

Wszystkie opcje

Wszystkie opcje, ale 0x02

logbased manualview

Wszystkie opcje

Wszystkie opcje, ale 0x02

Widok indeksowany logbased

Wszystkie opcje

Wszystkie opcje, ale 0x02

Widok indeksowany logbased manualfilter

Wszystkie opcje

Wszystkie opcje, ale 0x02

Widok indeksowany logbased manualview

Wszystkie opcje

Wszystkie opcje, ale 0x02

Widok indeksowany logbase manualboth

Wszystkie opcje

Wszystkie opcje, ale 0x02

proc szefowie

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000

możliwy do serializacji proc szefowie

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000

tylko schematu proc

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000

tylko schematu widoku

0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, a 0x80000000

0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, a 0x80000000

tylko schematu FUNC

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000

tylko schematu widok indeksowany

0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, a 0x80000000

0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, a 0x80000000

Uwaga

W kolejce aktualizujące publikacje schema_option wartość 0x80 musi być włączony.Obsługiwanych schema_option wartości nie-SQL Server publikacje są następujące: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000 and 0x4000.

Uprawnienia

Tylko członkowie sysadmin Rola serwera lub db_owner ustalone rola bazy danych mogą być wykonać sp_changearticle.