sp_addarticle (języka Transact-SQL)

Artykuł tworzy i dodaje ją na publikacja w sieci.Ta procedura przechowywana jest wykonywana przez wydawcę na baza danych publikacja.

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

sp_addarticle [ @publication = ] 'publication' 
        , [ @article = ] 'article' 
    [ , [ @source_table = ] 'source_table' ]
    [ , [ @destination_table = ] 'destination_table' ] 
    [ , [ @vertical_partition = ] 'vertical_partition' ] 
    [ , [ @type = ] 'type' ] 
    [ , [ @filter = ] 'filter' ] 
    [ , [ @sync_object= ] 'sync_object' ] 
        [ , [ @ins_cmd = ] 'ins_cmd' ] 
    [ , [ @del_cmd = ] 'del_cmd' ] 
        [ , [ @upd_cmd = ] 'upd_cmd' ] 
    [ , [ @creation_script = ] 'creation_script' ] 
    [ , [ @description = ] 'description' ] 
    [ , [ @pre_creation_cmd = ] 'pre_creation_cmd' ] 
    [ , [ @filter_clause = ] 'filter_clause' ] 
    [ , [ @schema_option = ] schema_option ] 
    [ , [ @destination_owner = ] 'destination_owner' ] 
    [ , [ @status = ] status ] 
    [ , [ @source_owner = ] 'source_owner' ] 
    [ , [ @sync_object_owner = ] 'sync_object_owner' ] 
    [ , [ @filter_owner = ] 'filter_owner' ] 
    [ , [ @source_object = ] 'source_object' ] 
    [ , [ @artid = ] article_ID  OUTPUT ] 
    [ , [ @auto_identity_range = ] 'auto_identity_range' ] 
    [ , [ @pub_identity_range = ] pub_identity_range ] 
    [ , [ @identity_range = ] identity_range ] 
    [ , [ @threshold = ] threshold ] 
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @use_default_datatypes = ] use_default_datatypes
    [ , [ @identityrangemanagementoption = ] identityrangemanagementoption ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @fire_triggers_on_snapshot = ] 'fire_triggers_on_snapshot' ] 

Argumenty

  • [ @publication = ] 'publication'
    Jest nazwą publikacja zawierającą artykuł.The name must be unique in the database.publication is sysname, with no default.

  • [ @article = ] 'article'
    Jest nazwą artykuł.The name must be unique within the publication.article is sysname, with no default.

  • [ @source_table = ] 'source_table'
    Tego parametru została zastąpiona; Użyj source_object w zamian.

    Ten parametr jest obsługiwana tylko dla zgodności ze starszymi wersjami programu SQL Server 6.5. Ten parametr nie jest obsługiwana dla Oracle wydawcy.

  • [ @destination_table = ] 'destination_table'
    Is the name of the destination (subscription) table, if different from source_tableor the stored procedure.destination_table is sysname, with a default of NULL, which means that source_table equals destination_table*.*

  • [ @vertical_partition = ] 'vertical_partition'
    Enables and disables column filtering on a table article.vertical_partition is nchar(5), with a default of FALSE.

    FAŁSZ wskazuje brak nie filtrowanie pionowe i publikuje wszystkie kolumny.

    wartość true czyści wszystkie kolumny z wyjątkiem deklarowanej klucz podstawowy, pustych kolumn, których brak domyślnej i kolumny klucza unikatowego.Kolumny są dodawane przy użyciu sp_articlecolumn.

  • [ @type = ] 'type'
    Is the type of article.type is sysname, and can be one of the following values.

    Wartość

    Description

    tylko agregacja schematu

    Funkcja agregacja tylko schematu.

    tylko schematu FUNC

    Działa tylko schematu.

    Widok indeksowany logbased

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

    Widok indeksowany logbased manualboth

    Widok indeksowany, opartego na dzienniku artykuł ręczne filtru i ręczne widoku.Ta opcja wymaga, aby określić oba sync_object i filter Parametry. Dla tego typu artykuł tabela bazowa nie jest konieczne publikowanie oddzielnie.Nie jest obsługiwana dla Oracle wydawcy.

    Widok indeksowany logbased manualfilter

    Widok indeksowany, opartego na dzienniku artykuł z filtrem ręcznie.Ta opcja wymaga, aby określić oba sync_object i filter Parametry. Dla tego typu artykuł tabela bazowa nie jest konieczne publikowanie oddzielnie.Nie jest obsługiwana dla Oracle wydawcy.

    Widok indeksowany logbased manualview

    Widok indeksowany, opartego na dzienniku artykuł z widokiem ręcznie.Ta opcja wymaga określenia sync_object parametr. Dla tego typu artykuł tabela bazowa nie jest konieczne publikowanie oddzielnie.Nie jest obsługiwana dla Oracle wydawcy.

    tylko schematu widok indeksowany

    Widok indeksowany tylko schematu.Dla tego typu artykuł musi również publikowane tabela bazowa.

    logbased (domyślnie)

    Artykuł opartego na dzienniku.

    logbased manualboth

    Artykuł opartego na dzienniku ręczne filtru i ręczne widoku.Ta opcja wymaga, aby określić oba sync_object i filter Parametry. Nie jest obsługiwana dla Oracle wydawcy.

    logbased manualfilter

    Artykuł opartego na dzienniku z filtrem ręcznie.Ta opcja wymaga, aby określić oba sync_object i filter Parametry. Nie jest obsługiwana dla Oracle wydawcy.

    logbased manualview

    Artykuł opartego na dzienniku z widokiem ręcznie.Ta opcja wymaga określenia sync_object parametr. Nie jest obsługiwana dla Oracle wydawcy.

    proc szefowie

    Wykonanie procedura przechowywana jest replikowany do wszystkich subskrybentów artykuł.Nie jest obsługiwana dla Oracle wydawcy.Firma Microsoft zaleca użycie opcji możliwy do serializacji proc szefowie zamiast proc szefowie.Aby uzyskać więcej informacji zobacz sekcję "Typy z przechowywana procedura wykonanie artykułów" w Publikowanie wykonanie procedura przechowywana w transakcji replikacja.

    tylko schematu proc

    Procedura tylko schematu.Nie jest obsługiwana dla Oracle wydawcy.

    możliwy do serializacji proc szefowie

    Wykonanie procedura przechowywana jest replikowany tylko wtedy, gdy jest wykonywany w kontekście transakcji możliwy do serializacji.Nie jest obsługiwana dla Oracle wydawcy.

    tylko schematu widoku

    Umożliwia wyświetlanie tylko schematu.Nie jest obsługiwana dla Oracle wydawcy.W przypadku korzystania z tej opcji, należy opublikować tabela bazowa.

  • [ @filter = ] 'filter'
    Is the stored procedure (created with FOR REPLICATION) used to filter the table horizontally.filter is nvarchar(386), with a default of NULL.sp_articleview and sp_articlefilter must be executed manually to create the view and filter stored procedure.Jeśli nie jest NULL, nie utworzono procedurę filtrowania (przy założeniu procedura przechowywana tworzone jest ręcznie).

  • [ @sync_object = ] 'sync_object'
    Is the name of the table or view used for producing the data file used to represent the snapshot for this article.sync_object is nvarchar(386), with a default of NULL.Jeśli wartością tą jest NULL, sp_articleview jest wywoływana automatycznie utworzyć widok używany do generowania pliku wyjściowego.Dzieje się tak po dodaniu wszystkich kolumn z sp_articlecolumn.Jeśli nie jest NULL, nie zostanie utworzony widok (przy założeniu ręcznego tworzenia widoku).

  • [ @ins_cmd = ] 'ins_cmd'
    Is the replication command type used when replicating inserts for this article.ins_cmd is nvarchar(255), and can be one of the following values.

    Wartość

    Description

    BRAK

    Zostanie podjęta żadna akcja.

    Wywołaj sp_MSins_tabela (domyślnie)

    - lub -

    Wywołaj custom_stored_procedure_name

    Wywołuje procedura przechowywana do wykonania przez subskrybent.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article.custom_stored_procedure is the name of a user-created stored procedure.sp_MSins_table contains the name of the destination table in place of the _table part of the parameter.Kiedy destination_owner jest określony, jest zabezpieczony na obiekt docelowy nazwę tabela. Na przykład w przypadku ProductCategory Tabela w posiadaniuProdukcja jest schematu przez subskrybent, parametrCALL sp_MSins_ProductionProductCategory. Artykuł w topologii replikacja równorzędna _table jest dołączany o wartości identyfikatora GUID. Określanie custom_stored_procedure nie jest obsługiwana w celu zaktualizowania subskrybentów.

    SQL or NULL

    Replikuje instrukcja INSERT.Instrukcja INSERT podano wartości dla wszystkich kolumn opublikowane w artykuł.To polecenie jest replikowany na wstawia:

    INSERT INTO <table name> VALUES (c1value, c2value, c3value, ..., cnvalue)

    Aby uzyskać więcej informacji zobacz Określanie, jak zmiany są rozpropagowane dla transakcji artykułów.

  • [ @del_cmd =] 'del_cmd'
    Is the replication command type used when replicating deletes for this article.del_cmd is nvarchar(255), and can be one of the following values.

    Wartość

    Description

    BRAK

    Zostanie podjęta żadna akcja.

    CALLsp_MSdel_table (default)

    - lub -

    Wywołaj custom_stored_procedure_name

    Wywołuje procedura przechowywana do wykonania przez subskrybent.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article.custom_stored_procedure is the name of a user-created stored procedure.sp_MSdel_table contains the name of the destination table in place of the _table part of the parameter.Kiedy destination_owner jest określony, jest zabezpieczony na obiekt docelowy nazwę tabela. Na przykład w przypadku ProductCategory Tabela w posiadaniuProdukcja jest schematu przez subskrybent, parametrCALL sp_MSdel_ProductionProductCategory. Artykuł w topologii replikacja równorzędna _table jest dołączany o wartości identyfikatora GUID. Określanie custom_stored_procedure nie jest obsługiwana w celu zaktualizowania subskrybentów.

    Sp_MSdel_ XCALLtabela

    - lub -

    Custom_stored_procedure_name XCALL

    Wywołuje procedura przechowywana, biorąc pod XCALL stylu parametrów.Aby użyć tej metoda replikacja, należy użyć schema_option Aby określić automatyczne tworzenie procedura przechowywana lub utworzyć określonej procedura przechowywana w obiekt docelowy z każdego subskrybent artykuł z bazy danych. Określanie procedura przechowywana utworzone przez użytkownika nie jest dozwolona w celu zaktualizowania subskrybentów.

    SQL or NULL

    Instrukcja DELETE jest replikowana.Instrukcja DELETE jest pod warunkiem że wszystkie wartości kolumna klucz podstawowy.To polecenie jest replikowany na usuwa:

    DELETE FROM <table name> WHERE pkc1 = pkc1value AND pkc2 = pkc2value AND pkcn = pkcnvalue

    Aby uzyskać więcej informacji zobacz Określanie, jak zmiany są rozpropagowane dla transakcji artykułów.

  • [ @upd_cmd =] 'upd_cmd'
    Is the replication command type used when replicating updates for this article.upd_cmd is nvarchar(255), and can be one of the following values.

    Wartość

    Description

    BRAK

    Zostanie podjęta żadna akcja.

    Wywołaj sp_MSupd_tabela

    - lub -

    Wywołaj custom_stored_procedure_name

    Wywołuje procedura przechowywana do wykonania przez subskrybent.Aby użyć tej metoda replikacja, należy użyć schema_option Aby określić automatyczne tworzenie procedura przechowywana lub utworzyć określonej procedura przechowywana w obiekt docelowy z każdego subskrybent artykuł z bazy danych.

    Sp_MSupd_ MCALLtabela

    - lub -

    Custom_stored_procedure_name MCALL

    Wywołuje procedura przechowywana, biorąc pod MCALL stylu parametrów.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article.custom_stored_procedure is the name of a user-created stored procedure.sp_MSupd_table contains the name of the destination table in place of the _table part of the parameter.Kiedy destination_owner jest określony, jest zabezpieczony na obiekt docelowy nazwę tabela. Na przykład w przypadku ProductCategory Tabela w posiadaniuProdukcja jest schematu przez subskrybent, parametrMCALL sp_MSupd_ProductionProductCategory. Artykuł w topologii replikacja równorzędna _table jest dołączany o wartości identyfikatora GUID. Określanie procedura przechowywana utworzone przez użytkownika nie jest dozwolona w celu zaktualizowania subskrybentów.

    Sp_MSupd_ SCALLtabela (domyślnie)

    - lub -

    Custom_stored_procedure_name SCALL

    Wywołuje procedura przechowywana, biorąc pod SCALL stylu parametrów.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article.custom_stored_procedure is the name of a user-created stored procedure.sp_MSupd_table contains the name of the destination table in place of the _table part of the parameter.Kiedy destination_owner jest określony, jest zabezpieczony na obiekt docelowy nazwę tabela. Na przykład w przypadku ProductCategory Tabela w posiadaniuProdukcja jest schematu przez subskrybent, parametrSCALL sp_MSupd_ProductionProductCategory. Artykuł w topologii replikacja równorzędna _table jest dołączany o wartości identyfikatora GUID. Określanie procedura przechowywana utworzone przez użytkownika nie jest dozwolona w celu zaktualizowania subskrybentów.

    Sp_MSupd_ XCALLtabela

    - lub -

    Custom_stored_procedure_name XCALL

    Wywołuje procedura przechowywana, biorąc pod XCALL stylu parametrów.Aby użyć tej metoda replikacja, należy użyć schema_option Aby określić automatyczne tworzenie procedura przechowywana lub utworzyć określonej procedura przechowywana w obiekt docelowy z każdego subskrybent artykuł z bazy danych. Określanie procedura przechowywana utworzone przez użytkownika nie jest dozwolona w celu zaktualizowania subskrybentów.

    SQL or NULL

    Replikuje instrukcja SQL UPDATE.Instrukcja UPDATE znajduje się na wszystkich wartości kolumna, a wartości kolumna klucz podstawowy.To polecenie jest replikowany na aktualizacje:

    UPDATE <table name> SET c1 = c1value, SET c2 = c2value, SET cn = cnvalue WHERE pkc1 = pkc1value AND pkc2 = pkc2value AND pkcn = pkcnvalue

    Uwaga

    Składnia Wywołaj, MCALL, SCALL i XCALL różne ilości danych te będą propagowane do subskrybent.Składnia Wywołaj przekazuje wszystkie wartości dla wszystkich kolumn wstawione i usunięte.Składnia SCALL przekazuje wartości tylko dla kolumn, których dotyczy problem.Składnia XCALL przekazuje wartości dla wszystkich kolumn, czy zmieniane lub nie, łącznie z poprzedniej wartości kolumna.Aby uzyskać więcej informacji zobacz Określanie, jak zmiany są rozpropagowane dla transakcji artykułów.

  • [ @creation_script =] 'creation_script'
    Is the path and name of an optional article schema script used to create the article in the subscription database.creation_script is nvarchar(255), with a default of NULL.

  • [ @description =] 'description'
    Is a descriptive entry for the article.description is nvarchar(255), with a default of NULL.

  • [ @pre_creation_cmd =] 'pre_creation_cmd'
    Specifies what the system should do if it detects an existing object of the same name at the subscriber when applying the snapshot for this article.pre_creation_cmd is nvarchar(10), and can be one of the following values.

    Wartość

    Description

    Brak

    Nie są używane polecenia.

    Usuwanie

    Usuwa dane z obiekt docelowy tabela przed zastosowaniem migawka.Jeżeli artykuł poziomo jest filtrowana, tylko dane z kolumn określonego przez klauzulę filtru zostanie usunięty.Po zdefiniowaniu filtru poziome nie obsługiwany dla Oracle wydawcy.

    Upuść (domyślnie)

    Krople obiekt docelowy tabela.

    Przycinanie

    Funkcja obcina tabela docelowej.Nie jest prawidłowy dla ODBC lub OLE DB subskrybentów.

  • [ @filter_clause=] 'filter_clause'
    Ograniczenie jest klauzula (WHERE), definiująca poziome filtru.When entering the restriction clause, omit the keyword WHERE.filter_clause is ntext, with a default of NULL.Aby uzyskać więcej informacji zobacz Filtrowanie opublikowane dane.

  • [ @schema_option =] schema_option
    Is a bitmask of the schema generation option for the given article.schema_option is binary(8), and can be the | (Bitwise OR) product of one or more of these values:

    Uwaga

    Jeśli wartością tą jest NULL, system automatycznie generuje opcji prawidłowego schematu do artykuł, w zależności od innych właściwości artykuł.The Default Schema Options tabela given in the Remarks shows the value that will be chosen based upon the combination of the artykuł type and the replikacja type.

    Wartość

    Description

    0x00

    Powoduje wyłączenie wykonywanie wykonywanie skryptów przez agenta migawka i używa creation_script.

    0x01

    Generuje skrypt tworzenia obiektu (CREATE tabela, CREATE PROCEDURE itd.).Ta wartość jest domyślna dla artykułów procedur przechowywanych.

    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.Nawet jeśli ta opcja nie jest zestaw, indeksy dotyczące kluczy podstawowych i ograniczeń unique są generowane, gdy zostały już zdefiniowane w tabela opublikowanych.

    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.Nawet jeśli ta opcja nie jest zestaw, indeksy dotyczące kluczy podstawowych i ograniczeń unique są generowane, gdy zostały już zdefiniowane w tabela opublikowanych.

    0x80

    Replikuje ograniczenie na klucz podstawowy.Replikowane są także żadnych indeksów związane z ograniczeniem, nawet jeśli opcje 0x10 and 0x40 nie są włączone.

    0x100

    Replikuje użytkownika wyzwalaczy w artykule tabela, jeśli została zdefiniowana.Nie jest obsługiwana dla Oracle wydawcy.

    0x200

    Replikuje ograniczenia na klucz obcy.Jeśli tabela, do którego istnieje odwołanie, nie jest częścią publikacja w sieci, nie są replikowane wszystkich ograniczeń klucz obcy dla tabeli, opublikowany.Nie jest obsługiwana dla Oracle wydawcy.

    0x400

    Replikacja ograniczeń check.Nie jest obsługiwana dla Oracle wydawcy.

    0x800

    Replikuje ustawień domyślnych.Nie jest obsługiwana dla Oracle wydawcy.

    0x1000

    Replikuje poziomie kolumna sortowanie.

    NoteNote:
    Tę opcję, należy ustawić dla Oracle wydawcy do umożliwienia porównań uwzględniana wielkość liter.

    0x2000

    Replikacja rozszerzone właściwości skojarzone z obiekt źródłowy opublikowanego artykuł.Nie jest obsługiwana dla Oracle wydawcy.

    0x4000

    Replikuje ograniczenia UNIQUE.Replikowane są także żadnych indeksów związane z ograniczeniem, nawet jeśli opcje 0x10 and 0x40 nie są włączone.

    0x8000

    Ta opcja nie jest prawidłowy dla SQL Server 2005 Wydawców.

    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)) wprowadzone w 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) wprowadzone 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 plików wykonywalnych (CLR) typów zdefiniowanych przez użytkownika (UDTs) o rozmiarze większym 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.

    WARTOŚCI NULL

    Replikacja automatycznie ustawia. schema_option do wartości domyślnych których wartość zależy od innych właściwości artykuł. Tabela "Domyślne opcje schematu" w sekcji Uwagi pokazuje domyślne opcje schematu na podstawie typu artykuł i typ replikacja.

    Wartość domyślna dla nie-SQL Server jest publikacji 0x050D3.

    Nie wszystkie schema_option wartości są prawidłowe dla każdego typu replikacja i typ artykuł. The Valid Schema Options tabela in the Remarks section shows the valid schema options that can be chosen based upon the combination of the artykuł type and the replikacja type.

  • [ @destination_owner =] 'destination_owner'
    Is the name of the owner of the destination object.destination_owner is sysname, with a default of NULL.Kiedy destination_owner nie zostanie określona, właścicielem jest określony, automatycznie w oparciu o następujące zasady:

    Warunek

    Właściciel obiektu docelowego

    Użytych do wygenerowania kopiowanie masowe trybu macierzystego migawka początkowa, który obsługuje tylko SQL Server Subskrybentów.

    Wartością domyślną jest wartość source_owner.

    Publikowane za pomocą różna-SQL Server Wydawca.

    Wartością domyślną jest właścicielem bazy danych obiekt docelowy.

    Publikacja używa kopiowanie masowe tryb znakowy wygenerować migawkę, wstępnego, który nie obsługuje-SQL Server Subskrybentów.

    Nie przypisany.

    Do obsługi innych niż-SQL Server Subskrybenci, destination_owner musi mieć wartość NULL.

  • [ @status=] status
    Specifies if the article is active and additional options for how changes are propagated.status is tinyint, and can be the | (Bitwise OR) product of one or more of these values.

    Wartość

    Description

    1

    Artykuł jest aktywny.

    8

    Zawiera nazwę kolumna w instrukcji INSERT.

    16 (domyślnie)

    Użycie parametrów instrukcji.

    24

    Zawiera nazwę kolumna w instrukcji INSERT i używa instrukcji sparametryzowana.

    64

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

    Na przykład aktywnego artykuł przy użyciu instrukcji sparametryzowana miałoby wartość 17 w tej kolumnie.Wartość 0 oznacza, że artykuł jest nieaktywny i są zdefiniowane żadne dodatkowe właściwości.

  • [ @source_owner =] 'source_owner'
    Is the owner of the source object.source_owner is sysname, with a default of NULL.source_owner must be specified for Oracle Publishers.

  • [ @sync_object_owner =] 'sync_object_owner'
    Is the owner of the view that defines the published article.sync_object_owner is sysname, with a default of NULL.

  • [ @filter_owner =] 'filter_owner'
    Is the owner of the filter.filter_owner is sysname, with a default of NULL.

  • [ @source_object =] 'source_object'
    Is the database object to be published.source_object is sysname, with a default of NULL.If source_table is NULL, source_object cannot be NULL.source_object should be used instead of source_table.Aby uzyskać więcej informacji na temat typów obiektów, które mogą być publikowane za pomocą migawka lub transakcyjnych replikacja Zobacz Obiekty bazy danych i publikowania danych.

  • [ @artid = ] article_ID OUTPUT
    Is the article ID of the new article.article_ID is int with a default of NULL, and it is an OUTPUT parameter.

  • [ @auto_identity_range = ] 'auto_identity_range'
    Enables and disables automatic identity range handling on a publication at the time it is created.auto_identity_range is nvarchar(5), and can be one of the following values:

    Wartość

    Description

    true

    Włącza obsługę zakres tożsamości automatyczne

    false

    Wyłącza automatyczne tożsamości zakres obsługi

    NULL(default)

    Obsługa zakres tożsamości jest zestaw przez identityrangemanagementoption.

    Uwaga

    auto_identity_range została zastąpiona i udostępniono w celu zachowania wstecznej zgodności.Należy używać identityrangemanagementoption do określania opcji zarządzania zakres tożsamości. Aby uzyskać więcej informacji zobacz Replikowanie kolumny tożsamości.

  • [ @pub_identity_range = ] pub_identity_range
    Controls the range size at the Publisher if the article has identityrangemanagementoption set to auto or auto_identity_range set to true.pub_identity_range is bigint, with a default of NULL.Nie jest obsługiwana dla Oracle wydawcy.

  • [ @identity_range = ] identity_range
    Controls the range size at the Subscriber if the article has identityrangemanagementoption set to auto or auto_identity_range set to true.identity_range is bigint, with a default of NULL.Kiedy używać auto_identity_range is zestaw to wartość true.Nie jest obsługiwana dla Oracle wydawcy.

  • [ @threshold = ] threshold
    Jest to wartość procentową, która kontroluje, kiedy Agent dystrybucji przypisuje nowy zakres tożsamości.When the percentage of values specified in threshold is used, the Distribution Agent creates a new identity range.threshold is bigint, with a default of NULL.Kiedy używać identityrangemanagementoption jest ustawiona na automatyczne or auto_identity_range jest ustawiona na wartość true.Nie jest obsługiwana dla Oracle wydawcy.

  • [ @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, że dodawanie artykuł nie powoduje 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 dodawanie artykuł może spowodować, że migawka jest nieprawidłowy i jeśli istnieje subskrypcji, wymaga migawka nowych daje uprawnienie dla istniejących migawka został oznaczony jako przestarzały i nowe migawka został wygenerowany.

  • [ @use_default_datatypes = ] use_default_datatypes
    Is whether the default column data type mappings are used when publishing an article from an Oracle Publisher.use_default_datatypes is bit, with a default of 1.

    1 = kolumna artykuł domyślne mapowania są używane.Domyślne mapowania typów danych może być wyświetlany przez wykonywanie sp_getdefaultdatatypemapping.

    0 = kolumna niestandardowe artykule zdefiniowano mapowania i w związku z tym sp_articleview nie jest wywołałsp_addarticle.

    Kiedy use_default_datatypes jest zestaw do 0, należy wykonać sp_changearticlecolumndatatype tylko jeden raz dla każdego mapowania kolumna zostanie zmienione z domyślnego.Po zdefiniowaniu wszystkie mapowania niestandardowe kolumna, należy wykonać sp_articleview.

    Uwaga

    Tego parametru powinna być używana tylko do wydawcy bazy danych Oracle.Ustawienie use_default_datatypes Aby 0 for a SQL Server Wydawca generuje błąd.

  • [ @identityrangemanagementoption = ] identityrangemanagementoption
    Specifies how identity range management is handled for the article.identityrangemanagementoption is nvarchar(10), and can be one of the following values.

    Wartość

    Description

    none

    Replikacja nie nie jawne tożsamości zakres zarządzania.Ta opcja jest zalecana tylko w przypadku Wstecz zgodność ze starszymi wersjami programu SQL Server.Niedozwolona dla elementu równorzędnego replikacja.

    manual

    Zaznacza kolumna tożsamości, Włącz obsługę zakres tożsamości ręcznie za pomocą nie do replikacja.

    auto

    Określa automatyczne zarządzanie zakresu tożsamości.

    NULL(default)

    Domyślnie: none gdy wartość auto_identity_range nie jest true. Domyślnie: manual w topologii typu peer-to-peer domyślne)auto_identity_range jest ignorowana).

    W celu zapewnienia zgodności z poprzednimi wersjami gdy wartość identityrangemanagementoption ma wartość NULL, wartość auto_identity_range jest sprawdzana. Niemniej jednak, jeśli wartość identityrangemanagementoption nie jest NULL, a następnie wartość auto_identity_range jest ignorowana.

    Aby uzyskać więcej informacji zobacz Replikowanie kolumny tożsamości.

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

    Uwaga

    publisher nie należy używać podczas dodawania artykuł do SQL Server Wydawca.

  • [ @fire_triggers_on_snapshot = ] 'fire_triggers_on_snapshot'
    Is if replicated user triggers are executed when the initial snapshot is applied.fire_triggers_on_snapshot is nvarchar(5), with a default of FALSE.true means that user triggers on a replicated table are executed when the snapshot is applied.W celu wyzwalaczy powinny być replikowane wartość maski bitowej schema_option musi zawierać wartość 0x100.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Remarks

sp_addarticle jest używany w replikacja migawka lub replikacji transakcyjnej.

Domyślnie, replikacja nie publikuje wszystkie kolumna w urządzenie źródłowe tabela, gdy typ danych kolumna nie jest obsługiwany przez replikację.Jeśli zachodzi konieczność opublikowania takiej kolumna, należy wykonać sp_articlecolumn , aby dodać kolumna.Aby uzyskać więcej informacji zobacz Uwagi dotyczące wszystkie typy replikacja.

Podczas dodawania artykuł do publikacja, która obsługuje replikacja transakcyjnej typu peer-to-peer, obowiązują następujące ograniczenia:

  • Instrukcje sparametryzowana musi być podany dla wszystkich artykułów logbased.Należy dołączyć 16 in the status wartość.

  • Nazwa i właściciela tabela docelowej muszą być zgodne z tabela źródłowej.

  • Nie można filtrować artykuł, poziomo lub pionowo.

  • Automatyczne tożsamości zakres zarządzania nie jest obsługiwana.Musisz określić wartość podręcznika identityrangemanagementoption.

  • Jeśli timestamp istnieje kolumna w tabela, należy dołączyć 0x08 w schema_option replikowanie kolumny jako timestamp.

  • Wartość SQL dla nie można określićins_cmd, upd_cmd, a del_cmd.

Aby uzyskać więcej informacji zobacz Typu peer-to-peer transakcyjne replikacja.

Po opublikowaniu obiektów ich definicje są kopiowane do subskrybentów.W przypadku publikowania obiektu bazy danych, która zależy od jednego lub kilku obiektów, należy opublikować wszystkie obiekty do którego istnieje odwołanie.Na przykład po opublikowaniu widok, który zależy od tabela, należy również opublikować w tabela.

Jeśli vertical_partition jest zestaw do wartość true, sp_addarticle defers Tworzenie widoku do sp_articleview nosi nazwę (po ostatnim sp_articlecolumn jest dodawany).

Jeśli publikacja umożliwia aktualizowanie subskrypcje i opublikowane tabela nie ma uniqueidentifier kolumna, sp_addarticle adds a uniqueidentifier kolumna do tabela automatycznie.

Domyślne opcje schematu

W tej tabela opisano wartości domyślne ustawione przez replikację, jeżeli schema_options nie jest określony przez użytkownika, gdy wartość ta zależy od typu replikacja (wyświetlane u góry) i typ artykuł (pokazane niedziałający pierwszej kolumna).

Typ artykuł

Typ replikacja

 

 

Transakcyjne

migawka

tylko agregacja schematu

0x01

0x01

tylko schematu FUNC

0x01

0x01

tylko schematu widok indeksowany

0x01

0x01

Widok indeksowany logbased

0x30F3

0x3071

Widok indeksowany logbase manualboth

0x30F3

0x3071

Widok indeksowany logbased manualfilter

0x30F3

0x3071

Widok indeksowany logbased manualview

0x30F3

0x3071

logbased

0x30F3

0x3071

logbased manualfilter

0x30F3

0x3071

logbased manualview

0x30F3

0x3071

proc szefowie

0x01

0x01

tylko schematu proc

0x01

0x01

możliwy do serializacji proc szefowie

0x01

0x01

tylko schematu widoku

0x01

0x01

Uwaga

Jeśli publikacja jest włączona dla aktualizacji, w kolejce schema_option wartość 0x80 jest dodawana do wartości domyślnej, przedstawione w tabela.Wartość domyślna schema_option dla różna-SQL Server publikacja jest 0x050D3.

Prawidłowe opcje schematu

W tej 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ści 0x8000 and 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, 0x4000 and 0X8000.

Uprawnienia

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