sp_addarticle (języka Transact-SQL)

Artykuł tworzy i dodaje go do publikacja.Ta procedura składowana jest wykonywany na Wydawca na bazie publikacja.

Konwencje składni Transact-SQL

Składnia

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

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

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

• [ @ source_table = 'source_table"
  Ten parametr została zaniechana; Użyj source_object zamiast.

  Ten parametr jest obsługiwana tylko ze względu na zgodność z SQL Server 6.5.Ten parametr nie jest obsługiwana dla wydawców Oracle.

• [ @ 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.

  FALSE wskazuje istnieje nie filtrowanie pionowe i publikuje wszystkie kolumny.

  TRUE czyści wszystkie kolumny z wyjątkiem deklarowanych klucz podstawowy, pustych kolumn, brak domyślnej i unikatowy klucz kolumn.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ść	Opis
  tylko wartość zagregowana schematu	Funkcja agregująca tylko schematu.
  Schemat FUNC tylko	Działać tylko schematu.
  indeksowany widok logbased	Artykuł dziennika na podstawie indeksowany widok.Nie jest obsługiwana dla wydawców Oracle.Dla tego typu artykuł tabela bazowa nie trzeba osobno opublikowane.
  indeksowany widok logbased manualboth	Artykuł dziennika na podstawie indeksowany widok filtru ręcznego i ręczne widoku.Ta opcja wymaga, określić zarówno sync_object i filter Parametry.Dla tego typu artykuł tabela bazowa nie trzeba osobno opublikowane.Nie jest obsługiwana dla wydawców Oracle.
  indeksowany widok logbased manualfilter	indeksowany widok dziennika na podstawie artykuł ręczne filtr.Ta opcja wymaga, określić zarówno sync_object i filter Parametry.Dla tego typu artykuł tabela bazowa nie trzeba osobno opublikowane.Nie jest obsługiwana dla wydawców Oracle.
  indeksowany widok logbased manualview	indeksowany widok dziennika na podstawie artykuł ręczne widoku.Opcja ta wymaga określenia sync_object parametru.Dla tego typu artykuł tabela bazowa nie trzeba osobno opublikowane.Nie jest obsługiwana dla wydawców Oracle.
  indeksowany widok schematu tylko	Widok indeksowany tylko schematu.Na ten rodzaj artykuł musi również publikowane tabela bazowa.
  logbased (domyślnie)	Artykuł na podstawie dziennika.
  logbased manualboth	Artykuł na podstawie dziennika z filtru ręcznego i ręczne widoku.Ta opcja wymaga, określić zarówno sync_object i filter Parametry.Nie jest obsługiwana dla wydawców Oracle.
  logbased manualfilter	Artykuł na podstawie dziennika z filtrem ręczne.Ta opcja wymaga, określić zarówno sync_object i filter Parametry.Nie jest obsługiwana dla wydawców Oracle.
  logbased manualview	Na podstawie dziennika artykuł ręczne widoku.Opcja ta wymaga określenia sync_object parametru.Nie jest obsługiwana dla wydawców Oracle.
  szefowie proc	Wykonanie procedura składowana jest replikowana do wszystkich subskrybentów artykuł.Nie jest obsługiwana dla wydawców Oracle.Firma Microsoft zaleca użycie opcji exec serializować proc zamiast proc exec.Aby uzyskać więcej informacji zobacz sekcję "Typy z przechowywane procedury realizacji artykułów" in Publikowanie wykonanie procedury przechowywanej w replikacji transakcyjnej.
  Schemat proc tylko	Procedura tylko schematu.Nie jest obsługiwana dla wydawców Oracle.
  szefowie proc serializować	Wykonanie procedura składowana jest replikowany tylko wtedy, gdy jest wykonywany w kontekście transakcji możliwy do serializacji.Nie jest obsługiwana dla wydawców Oracle.
  tylko schematu widoku	Wyświetl tylko schematu.Nie jest obsługiwana dla wydawców Oracle.Korzystając z tej opcji, należy opublikować tabela bazowa.

• [ @ Filtr = '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.Not NULL procedury filtr nie zostanie utworzony (założono procedura składowana jest tworzona 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 ma wartość NULL, sp_articleview jest wywoływana automatycznie utworzyć widok używany do generowania pliku wyjściowego.Dzieje się tak po dodaniu kolumny z sp_articlecolumn.NIEZEROWA, widok nie zostanie utworzony (założono widoku jest tworzone ręcznie).

• [ @ 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ść	Opis
  BRAK	Zostaną podjęte żadne akcja.
  Wywołanie sp_MSins_tabela (domyślnie) - lub - Wywołanie custom_stored_procedure_name	Wywołuje procedura składowana, aby wykonywane przez subskrybenta.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.Gdy destination_owner jest określony, jest poprzedzany do obiekt docelowy tabela Nazwa.Na przykład dla ProductCategory tabela posiadanych przez produkcji schematu subskrybent byłoby parametr CALL sp_MSins_ProductionProductCategory.Artykuł peer-to-peer topologia replikacji, _table zostaje dołączony wartość identyfikatora GUID.Określanie custom_stored_procedure nie jest obsługiwana dla aktualizacji subskrybentów.
  SQL lub 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 sposobu zmiany są propagowane transakcyjnych 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ść	Opis
  BRAK	Zostaną podjęte żadne akcja.
  CALLsp_MSdel_table (default) - lub - Wywołanie custom_stored_procedure_name	Wywołuje procedura składowana, aby wykonywane przez subskrybenta.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.Gdy destination_owner jest określony, jest poprzedzany do obiekt docelowy tabela Nazwa.Na przykład dla ProductCategory tabela posiadanych przez produkcji schematu subskrybent byłoby parametr CALL sp_MSdel_ProductionProductCategory.Artykuł peer-to-peer topologia replikacji, _table zostaje dołączony wartość identyfikatora GUID.Określanie custom_stored_procedure nie jest obsługiwana dla aktualizacji subskrybentów.
  XCALL sp_MSdel_tabela - lub - XCALL custom_stored_procedure_name	Wywołuje procedura składowana, biorąc pod XCALL styl parametrów.Aby użyć tej metoda replikacja, należy schema_option określić automatyczne tworzenie procedura składowana lub utworzyć określonej procedura składowana w obiekt docelowy baza danych subskrybenta każdego artykuł.Określający procedura składowana utworzone przez użytkownika nie jest dozwolone aktualizowania subskrybentów.
  SQL lub NULL	Replikuje Instrukcja DELETE.Instrukcja DELETE jest pod warunkiem że wszystkie klucz podstawowy wartości kolumn.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 sposobu zmiany są propagowane transakcyjnych 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ść	Opis
  BRAK	Zostaną podjęte żadne akcja.
  Wywołanie sp_MSupd_tabela - lub - Wywołanie custom_stored_procedure_name	Wywołuje procedura składowana, aby wykonywane przez subskrybenta.Aby użyć tej metoda replikacja, należy schema_option określić automatyczne tworzenie procedura składowana lub utworzyć określonej procedura składowana w obiekt docelowy baza danych subskrybenta każdego artykuł.
  MCALL sp_MSupd_tabela - lub - MCALL custom_stored_procedure_name	Wywołuje procedura składowana, biorąc pod MCALL styl 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.Gdy destination_owner jest określony, jest poprzedzany do obiekt docelowy tabela Nazwa.Na przykład dla ProductCategory tabela posiadanych przez produkcji schematu subskrybent byłoby parametr MCALL sp_MSupd_ProductionProductCategory.Artykuł peer-to-peer topologia replikacji, _table zostaje dołączony wartość identyfikatora GUID.Określający procedura składowana utworzone przez użytkownika nie jest dozwolone aktualizowania subskrybentów.
  SCALL sp_MSupd_tabela (domyślnie) - lub - SCALL custom_stored_procedure_name	Wywołuje procedura składowana, biorąc pod SCALL styl 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.Gdy destination_owner jest określony, jest poprzedzany do obiekt docelowy tabela Nazwa.Na przykład dla ProductCategory tabela posiadanych przez produkcji schematu subskrybent byłoby parametr SCALL sp_MSupd_ProductionProductCategory.Artykuł peer-to-peer topologia replikacji, _table zostaje dołączony wartość identyfikatora GUID.Określający procedura składowana utworzone przez użytkownika nie jest dozwolone aktualizowania subskrybentów.
  XCALL sp_MSupd_tabela - lub - XCALL custom_stored_procedure_name	Wywołuje procedura składowana, biorąc pod XCALL styl parametrów.Aby użyć tej metoda replikacja, należy schema_option określić automatyczne tworzenie procedura składowana lub utworzyć określonej procedura składowana w obiekt docelowy baza danych subskrybenta każdego artykuł.Określający procedura składowana utworzone przez użytkownika nie jest dozwolone aktualizowania subskrybentów.
  SQL lub NULL	Replikuje instrukcja UPDATE.Instrukcja UPDATE jest dostarczany na wszystkie wartości kolumna oraz klucz podstawowy wartości kolumn.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

  Ostrzeżenie

  Składnia WYWOŁANIA, MCALL, SCALL i XCALL różne ilości danych propagowane do subskrybent.Składnia WYWOŁANIA przekazuje wszystkie wartości dla wszystkich kolumn wstawionych i usuniętych.Składnia SCALL przekazuje wartości tylko dla dotkniętych kolumn.Składnia XCALL przekazuje wartości dla wszystkich kolumn, czy zmienione lub nie, łącznie z poprzedniej wartości kolumna.Aby uzyskać więcej informacji, zobacz Określanie sposobu zmiany są propagowane transakcyjnych 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.

• [ @ Opis = '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ść	Opis
  Brak	Nie używać polecenia.
  Usuń	Usuwa dane z obiekt docelowy tabela przed zastosowaniem migawka.Gdy artykuł poziomo jest filtrowany, tylko dane w kolumnach określona przez filtr klauzula jest usuwany.Nieobsługiwana dla wydawców Oracle zdefiniowane na poziomie filtr.
  Upuść (domyślnie)	Krople obiekt docelowy tabela.
  obciąć	Obcina obiekt docelowy tabela.Nie jest prawidłowy dla ODBC lub OLE DB subskrybentów.

• [ @ filter_clause = 'filter_clause"
  Ograniczenie jest klauzula (gdzie) definiujący 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:

  Ostrzeżenie

  Jeśli wartością tą jest NULL, system auto generuje opcja prawidłowym schematem artykuł, w zależności od innych właściwości artykułu.Domyślne opcje schematu uwagi tabela zawiera wartość, która zostanie wybrany na podstawie kombinacji typu artykuł i replikacja.

  Wartość	Opis
  0x00	Wyłącza wykonywanie skryptów przez agenta migawki i używa creation_script.
  0x01	Generuje skrypt tworzenia obiektu (CREATE TABLE, CREATE PROCEDURE itd.).Ta wartość jest domyślna dla artykułów procedura składowana.
  0x02	Generuje procedur przechowywanych, które propaguje zmiany w artykuł, jeśli została zdefiniowana.
  0x04	Kolumny identyfikacji są tworzone przy użyciu właściwość tożsamości.
  0x08	Replikuj 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, dotyczące indeksy kluczy podstawowych i ograniczeń unique są generowane, jeśli zostały już zdefiniowane w tabela opublikowanych.
  0x20	Typy danych zdefiniowane przez użytkownika konwertuje (UDT) oparcie typów danych przez subskrybenta.Tej opcji nie można używać po wyboru lub domyślne ograniczenie na kolumnie UDT, jeśli kolumna UDT klucz podstawowy, lub jeśli kolumna UDT odwołuje się kolumna obliczana.Nieobsługiwane dla wydawców Oracle.
  0x40	Generuje odpowiednie zbudowania indeksów nie klastrowanych.Nawet jeśli ta opcja nie jest zestaw, dotyczące indeksy kluczy podstawowych i ograniczeń unique są generowane, jeśli zostały już zdefiniowane w tabela opublikowanych.
  0x80	Replikuje klucz podstawowy ograniczenia.Wszystkie indeksy związanych z ograniczeniem są również replikowana, nawet jeśli opcje 0x10 i 0x40 nie są włączone.
  0x100	Replikuje użytkownika wyzwalaczy w tabela artykuł, jeśli została zdefiniowana.Nieobsługiwane dla wydawców Oracle.
  0x200	Replikuje ograniczenia na klucz obcy.Odwołanie tabela nie jest częścią publikacja, wszystkich ograniczeń klucz obcy tabeli opublikowane, nie są replikowane.Nieobsługiwane dla wydawców Oracle.
  0x400	Replikuje ograniczeń check.Nieobsługiwane dla wydawców Oracle.
  0x800	Replikuje ustawień domyślnych.Nieobsługiwane dla wydawców Oracle.
  0x1000	Replikuje kolumna -poziom sortowanie. Uwaga: Ta opcja powinna być zestaw dla wydawców Oracle włączyć porównań uwzględniające wielkość liter.
  0x2000	Replikuje właściwości rozszerzone, skojarzone z opublikowanego artykuł obiekt źródłowy.Nieobsługiwane dla wydawców Oracle.
  0x4000	Replikuje ograniczeń UNIQUE.Wszystkie indeksy związanych z ograniczeniem są również replikowana, nawet jeśli opcje 0x10 i 0x40 nie są włączone.
  0x8000	Ta opcja nie jest prawidłowy dla SQL Server 2005 wydawcy.
  0x10000	Replikuje ograniczeń CHECK jako nie dla replikacji, tak aby ograniczenia nie są wymuszane podczas synchronizacji.
  0x20000	Replikuje ograniczenia klucza OBCEGO jako nie dla replikacji, tak aby ograniczenia nie są wymuszane podczas synchronizacji.
  0x40000	Replikuje skojarzonych z aplikacjami tabela partycjonowana lub indeks.
  0x80000	Replikuje schemat partycji dla tabela partycjonowana.
  0x100000	Replikuje schemat partycji indeks partycjonowany.
  0x200000	Replikuje tabela statystyk.
  0x400000	Domyślne powiązania
  0x800000	Reguła powiązania
  0x1000000	Indeks pełnotekstowy
  0x2000000	Kolekcje schematu XML powiązane z xml kolumny nie są replikowane.
  0x4000000	Replikuje indeksów na xml kolumny.
  0x8000000	Utwórz wszystkie schematy już obecny na subskrybent.
  0x10000000	Konwertuje xml kolumny do ntext na subskrybenta.
  0x20000000	Konwertowania dużych obiektu typów danych (nvarchar(max), varchar(max), i varbinary(max)) wprowadzone w SQL Server 2005 do typów danych, które są obsługiwane w SQL Server 2000.Aby uzyskać informacje, jak te typy są mapowane zobacz "Mapowanie nowe dane typy dla starszych wersji" sekcja w W topologii replikacji przy użyciu wielu wersji programu SQL Server.
  0x40000000	Replikuj uprawnienia.
  0x80000000	Próba upuść zależności obiekty nie należące do publikacja.
  0x100000000	Ta opcja służy do replikowania atrybut FILESTREAM, jeśli jest określony na varbinary(max) kolumny.Nie określono tę opcję, jeśli jest replikowana tabel do SQL Server 2005 abonentów.Replikowanie tabele, które mają FILESTREAM kolumny do SQL Server 2000 abonentów nie jest obsługiwany, niezależnie od tego, jak opcja schematu jest zestaw. Zobacz pokrewne opcja 0x800000000.
  0x200000000	Konwertuje datę i czas typów danych (date, time, datetimeoffset, i datetime2) wprowadzone w SQL Server 2008 do typów danych, które są obsługiwane w starszych wersjach SQL Server.Aby uzyskać informacje, jak te typy są mapowane zobacz "Mapowanie nowe dane typy dla starszych wersji" sekcja w W topologii replikacji przy użyciu wielu wersji programu SQL Server.
  0x400000000	Replikuje opcję kompresji dla danych i indeksów.Aby uzyskać więcej informacji, zobacz Tworzenie skompresowanego tabel i indeksów.
  0x800000000	Tej opcji do przechowywania danych FILESTREAM samodzielnie grupa plików przez subskrybenta.Jeśli ta opcja nie jest zestaw, FILESTREAM dane są przechowywane w domyślnej grupie plików.Replikacja nie tworzy aplikacjami; Dlatego jeśli użytkownik zestaw tę opcję, należy utworzyć grupa plików przed zastosowaniem migawka subskrybent.Aby uzyskać więcej informacji o tworzeniu obiektów przed zastosowaniem migawka, zobacz Wykonywanie skryptów przed i po zastosowaniu migawki. Zobacz pokrewne opcja 0x100000000.
  0x1000000000	Konwertuje language runtime (CLR) użytkownika typowych (UDTs) większych niż 8000 bajtów varbinary(max) Tak, aby kolumny typu UDT mogą być replikowane do subskrybentów systemem SQL Server 2005.
  0x2000000000	Konwertuje hierarchyid Typ danych do varbinary(max) , aby kolumny typu hierarchyid mogą być replikowane do subskrybentów systemem SQL Server 2005.Aby uzyskać więcej informacji na temat używania hierarchyid kolumn w zreplikowanych tabelach, zobacz hierarchyid (języka Transact-SQL).
  0x4000000000	Replikuje żadnych filtrowane indeksów w tabela.Więcej informacji o filtrowane indeksy, zobacz Filtrowane wskazówek indeksu.
  0x8000000000	Konwertuje geography i geometry typów danych do varbinary(max) Tak, aby kolumny te typy mogą być replikowane do subskrybentów systemem SQL Server 2005.
  0x10000000000	Replikuje indeksów na kolumnach typu geography i geometry.
  0x20000000000	Replikuje atrybut SPARSE dla kolumny.Aby uzyskać więcej informacji dotyczących tego atrybut, zobacz Przy użyciu kolumn Sparse.
  NULL	Replikacja automatycznie ustawia schema_option na wartość domyślną wartość zależy od innych właściwości artykuł."Domyślne opcje schematu" Tabela w sekcji Uwagi pokazuje domyślne opcje schematu na podstawie typu artykuł i typ replikacja. Domyślnie dla nie-SQL Server publikacji jest 0x050D3.

  Nie wszystkie schema_option wartości są prawidłowe dla każdego typu replikacja i typu artykuł.Prawidłowe opcje schematu tabela w uwagach sekcji przedstawiono opcje prawidłowego schematu, które można wybrać na podstawie kombinacji typu artykuł i replikacja.

• [ @ destination_owner = 'destination_owner"
  Is the name of the owner of the destination object.destination_owner is sysname, with a default of NULL.Gdy destination_owner nie jest 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 trybu macierzystego kopiowanie masowe migawka początkowa, który obsługuje tylko SQL Server abonentów.	Domyślnie wartość source_owner.
  Opublikowane z nie-SQL Server Wydawca.	Domyślnie właścicielem obiekt docelowy bazy danych.
  Użytych do wygenerowania znak tryb kopiowanie masowe migawka początkowa, który nie obsługuje-SQL Server abonentów.	Nie przypisano.

  Do obsługi innych niż-SQL Server abonentów, destination_owner musi być NULL.

• [ @ Stan = 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ść	Opis
  1	Artykuł jest aktywny.
  8	Zawiera nazwę kolumna w instrukcji INSERT.
  16 (domyślnie)	Używa sparametryzowana sprawozdania.
  24	Zawiera nazwę kolumna w instrukcji INSERT i używa instrukcji sparametryzowanej.
  64	Określone tylko w celach informacyjnych. Nieobsługiwane. Przyszła zgodność nie jest gwarantowana.

  Na przykład artykuł aktywny przy użyciu instrukcji sparametryzowana miałoby wartość 17 w tym kolumna.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 dotyczących typów obiektów, które mogą być publikowane przy użyciu migawka lub replikacja transakcyjna, zobacz Publikowanie danych i obiektów bazy danych.

• [ @ artid = article_ID danych wyjściowych
  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ść	Opis
  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.

  Ostrzeżenie

  auto_identity_range zaniechano i zapewnić zgodność z poprzednimi wersjami.Należy używać identityrangemanagementoption do określania tożsamości zakres zarządzania opcje.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.Nieobsługiwane dla wydawców Oracle.

• [ @ 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.Używana, gdy auto_identity_range jest zestaw do true.Nieobsługiwane dla wydawców Oracle.

• [ @ progu = threshold
  Jest wartością procentową, sterujące, gdy 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.Used when identityrangemanagementoption is zestaw to auto or auto_identity_range is zestaw to true.Nieobsługiwane dla wydawców Oracle.

• [ @ 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 spowoduje migawka nieprawidłowa.Jeżeli procedura składowana wykryje, że zmiana wymaga Nowa migawka, wystąpi błąd i nie wprowadzono żadnych zmian.

  1 Określa, że dodawanie artykuł może spowodować migawki nieprawidłowa i jeśli istnieje subskrypcje, wymagałoby Nowa migawka daje uprawnienie dla istniejących migawki oznaczony jako przestarzałe i Nowa migawka mają zostać wygenerowane.

• [ @ 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 typu danych mogą być wyświetlane przez wykonywanie sp_getdefaultdatatypemapping.

  0 = kolumna niestandardowe artykuł zdefiniowano mapowania i dlatego sp_articleview nie jest wywoływana sp_addarticle.

  Gdy use_default_datatypes jest zestaw do 0, należy wykonać sp_changearticlecolumndatatype raz dla każdej mapowanie kolumn zmianę domyślnego.Po zdefiniowaniu wszystkie mapowania niestandardowe kolumna należy wykonać sp_articleview.

  Ostrzeżenie

  Ten parametr stosuje się tylko dla wydawców Oracle.Ustawienie use_default_datatypes do 0 dla 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ść	Opis
  none	Replikacja nie bez wyraźnej tożsamości zakres zarządzania.Ta opcja jest zalecana tylko dla 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 ręczne tożsamości za pomocą nie dla replikacji.
  auto	Określa automatyczne Zarządzanie zakresami tożsamości.
  NULL(default)	Domyślnie none , gdy wartość auto_identity_range nie jest true.Domyślnie manual w domyślnej topologii peer-to-peer (auto_identity_range jest ignorowany).

  Zgodności z poprzednimi wersjami, gdy wartość identityrangemanagementoption ma wartość NULL, wartość auto_identity_range jest sprawdzany.Jednakże, gdy wartość identityrangemanagementoption jest nie NULL, wówczas 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.

  Ostrzeżenie

  publishernie 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 replikowane wartość maski bitowej schema_option musi zawierać wartość 0x100.

Wartości kodów powrotnych

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

Uwagi

sp_addarticle używane w replikacja migawka lub replikacja transakcyjna.

Domyślnie replikacja nie publikuje wszystkie kolumna w źródło tabela, gdy typ danych kolumna nie jest obsługiwany przez replikację.Jeśli musisz opublikować takiej kolumna, należy wykonać sp_articlecolumn dodać kolumna.Aby uzyskać więcej informacji, zobacz Zagadnienia dotyczące wszystkich rodzajów replikacji.

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

• Sparametryzowana sprawozdania musi być podany dla wszystkich artykułów logbased.Należy uwzględnić 16 w status wartości.

• Nazwę i właściciela tabela docelowej muszą odpowiadać źródło tabela.

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

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

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

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

Aby uzyskać więcej informacji, zobacz Peer-to-Peer replikacji transakcyjnej.

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.Na przykład po opublikowaniu widok, który zależy od tabela należy również opublikować tabela.

Jeśli vertical_partition jest zestaw do true, sp_addarticle defers Tworzenie widoku, aż do sp_articleview jest nazywany (po ostatnim sp_articlecolumn dodaje się).

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

Domyślne opcje schematu

W tej tabela opisano wartości domyślnej zestaw przez replikację Jeśli schema_options nie jest określony przez użytkownika, w którym ta wartość zależy od typu replikacja (wyświetlane u góry) i artykuł (pokazane w pierwszej kolumnie).

Typ artykułu	Typ replikacji
	Transakcyjne	Migawki
tylko wartość zagregowana schematu	0x01	0x01
Schemat FUNC tylko	0x01	0x01
indeksowany widok schematu tylko	0x01	0x01
indeksowany widok logbased	0x30F3	0x3071
indeksowany widok logbase manualboth	0x30F3	0x3071
indeksowany widok logbased manualfilter	0x30F3	0x3071
indeksowany widok logbased manualview	0x30F3	0x3071
logbased	0x30F3	0x3071
logbased manualfilter	0x30F3	0x3071
logbased manualview	0x30F3	0x3071
szefowie proc	0x01	0x01
Schemat proc tylko	0x01	0x01
szefowie proc serializować	0x01	0x01
tylko schematu widoku	0x01	0x01

Ostrzeżenie

Jeśli publikacja jest włączona dla aktualizacji, w kolejce schema_option wartość 0x80 jest dodawana do wartości domyślnej, przedstawione w tabela.Domyślnie schema_option dla nie-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) i artykuł (pokazane niedziałający pierwszej kolumny).

Typ artykułu	Typ replikacji
	Transakcyjne	Migawki
logbased	Wszystkie opcje	Wszystkie opcje, ale 0x02
logbased manualfilter	Wszystkie opcje	Wszystkie opcje, ale 0x02
logbased manualview	Wszystkie opcje	Wszystkie opcje, ale 0x02
indeksowany widok logbased	Wszystkie opcje	Wszystkie opcje, ale 0x02
indeksowany widok logbased manualfilter	Wszystkie opcje	Wszystkie opcje, ale 0x02
indeksowany widok logbased manualview	Wszystkie opcje	Wszystkie opcje, ale 0x02
indeksowany widok logbase manualboth	Wszystkie opcje	Wszystkie opcje, ale 0x02
szefowie proc	0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, i 0x80000000	0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, i 0x80000000
szefowie proc serializować	0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, i 0x80000000	0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, i 0x80000000
Schemat proc tylko	0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, i 0x80000000	0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, i 0x80000000
tylko schematu widoku	0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000	0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000
Schemat FUNC tylko	0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, i 0x80000000	0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, i 0x80000000
indeksowany widok schematu tylko	0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000	0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000

Ostrzeżenie

Kolejkowana publikacji aktualizacji schema_option wartości 0x8000 i 0x80 musi być włączony.Obsługiwane schema_option wartości nie-SQL Server publikacje są: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000, 0x4000 and 0X8000.

Przykład

DECLARE @publication    AS sysname;
DECLARE @table AS sysname;
DECLARE @filterclause AS nvarchar(500);
DECLARE @filtername AS nvarchar(386);
DECLARE @schemaowner AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @table = N'Product';
SET @filterclause = N'[DiscontinuedDate] IS NULL'; 
SET @filtername = N'filter_out_discontinued';
SET @schemaowner = N'Production';

-- Add a horizontally and vertically filtered article for the Product table.
-- Manually set @schema_option to ensure that the Production schema 
-- is generated at the Subscriber (0x8000000).
EXEC sp_addarticle 
    @publication = @publication, 
    @article = @table, 
    @source_object = @table,
    @source_owner = @schemaowner, 
    @schema_option = 0x80030F3,
    @vertical_partition = N'true', 
    @type = N'logbased',
    @filter_clause = @filterclause;

-- (Optional) Manually call the stored procedure to create the 
-- horizontal filtering stored procedure. Since the type is 
-- 'logbased', this stored procedures is executed automatically.
EXEC sp_articlefilter 
    @publication = @publication, 
    @article = @table, 
    @filter_clause = @filterclause, 
    @filter_name = @filtername;

-- Add all columns to the article.
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table;

-- Remove the DaysToManufacture column from the article
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table, 
    @column = N'DaysToManufacture', 
    @operation = N'drop';

-- (Optional) Manually call the stored procedure to create the 
-- vertical filtering view. Since the type is 'logbased', 
-- this stored procedures is executed automatically.
EXEC sp_articleview 
    @publication = @publication, 
    @article = @table,
    @filter_clause = @filterclause;
GO

Uprawnienia

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

Zobacz także

Zadania

Jak Definiowanie artykuł (Programowanie replikacji Transact-SQL)

Odwołanie

sp_articlecolumn (języka Transact-SQL)

sp_articlefilter (języka Transact-SQL)

sp_articleview (języka Transact-SQL)

sp_changearticle (języka Transact-SQL)

sp_droparticle (języka Transact-SQL)

sp_helparticle (języka Transact-SQL)

sp_helparticlecolumns (języka Transact-SQL)

Replikacja przechowywane procedury języka Transact-SQL)

Koncepcje

Publikowanie danych i obiektów bazy danych