Tento článek byl přeložený strojově. Pokud chcete zobrazit článek v angličtině, zaškrtněte políčko Angličtina. Anglickou verzi článku můžete také zobrazit v místním okně přesunutím ukazatele myši nad text.
Překlad
Angličtina

sp_addarticle (Transact-SQL)

Článek vytvoří a přidá jej do publikace.Tento uložený postup proveden u Vydavatel na publikační databáze.

Topic link icon Pravidla syntaxe jazyka 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' ] 

[ @publication = ] 'publication'

Je název publikace, která obsahuje v článek.The name must be unique in the database. publication is sysname, with no default.

[ @article = ] 'article'

Je název tohoto článek.The name must be unique within the publication. article is sysname, with no default.

[ @source_table = ] 'source_table'

Tento parametr se; použijte source_object místo.

Tento parametr je podporována pouze pro zpětnou kompatibilitu s SQL Server 6.5. Tento parametr není podporována pro Oracle vydavatel.

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

hodnota FALSE označuje svislá filtrování a publikuje všechny sloupce.

True vymaže všechny sloupce s výjimkou prohlášených primární klíč, s možnou hodnotou Null sloupce s žádnou výchozí hodnotu a klíčové sloupce jedinečné.Sloupce jsou přidány pomocí sp_articlecolumn.

[ @type = ] 'type'

Is the type of article. type is sysname, and can be one of the following values.

Hodnota

Popis

pouze agregace schématu

agregace funkce s pouze schématu.

pouze FUNC schématu.

Pracovat pouze schématu.

indexované zobrazení logbased

Článek indexované zobrazení založené na protokolu.Není podporováno pro Oracle vydavatel.Pro tento typ článek základní tabulka nemusí být zveřejněny odděleně.

indexované zobrazení logbased manualboth

indexované zobrazení založené na protokolu článek s ručního filtru a ruční zobrazení.Tato možnost vyžaduje zadání obě sync_object and filter Parametry. Pro tento typ článek základní tabulka nemusí být zveřejněny odděleně.Není podporováno pro Oracle vydavatel.

indexované zobrazení logbased manualfilter

indexované zobrazení založené na protokolu článek s ručního filtru.Tato možnost vyžaduje zadání obě sync_object and filter Parametry. Pro tento typ článek základní tabulka nemusí být zveřejněny odděleně.Není podporováno pro Oracle vydavatel.

indexované zobrazení logbased manualview

indexované zobrazení založené na protokolu článek s ruční zobrazení.Tato možnost vyžaduje zadání sync_object Parametr. Pro tento typ článek základní tabulka nemusí být zveřejněny odděleně.Není podporováno pro Oracle vydavatel.

pouze schéma indexované zobrazení

Indexované zobrazení se pouze schématu.Pro tento typ článek musí být také zveřejněny základní tabulka.

logbased (Výchozí)

Článek založené na protokolu.

logbased manualboth

Založené na protokolu článek s ručního filtru a ruční zobrazení.Tato možnost vyžaduje zadání obě sync_object and filter Parametry. Není podporováno pro Oracle vydavatel.

logbased manualfilter

Založené na protokolu článek s ručního filtru.Tato možnost vyžaduje zadání obě sync_object and filter Parametry. Není podporováno pro Oracle vydavatel.

logbased manualview

Založené na protokolu článek s ruční zobrazení.Tato možnost vyžaduje zadání sync_object Parametr. Není podporováno pro Oracle vydavatel.

proc exec

Replikuje provádění uložená procedura pro všechny předplatitele v článek.Není podporováno pro Oracle vydavatel.Doporučujeme použít možnost serializovat proc exec namísto proc exec.Další informace naleznete v části "Typy z uložená procedura spuštění článcích" v Publikování spuštění uložená procedura v transakční replikace.

pouze proc schématu.

Postup s pouze schématu.Není podporováno pro Oracle vydavatel.

serializovat proc exec

Replikuje provádění uložená procedura, pouze v případě, že je spuštěn v rámci serializovatelný transakce.Není podporováno pro Oracle vydavatel.

zobrazení schématu pouze

Zobrazení s pouze schématu.Není podporováno pro Oracle vydavatel.Používáte-li tuto možnost, musíte publikovat také základní tabulka.

[ @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.Pokud není NULL, není vytvořen postup filtru (předpokládá, že uložená procedura je ručně vytvořen).

[ @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.Hodnota NULL znamená, sp_articleview Chcete-li automaticky vytvořit zobrazení použít ke generování výstupní soubor se nazývá. K této situaci dochází po přidání všech sloupců s sp_articlecolumn.Pokud není NULL, není vytvořena zobrazení (předpokládá, že zobrazení je ručně vytvořen).

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

Hodnota

Popis

NONE

Žádná akce.

CALL sp_MSins_ tabulka (Výchozí)

– nebo –

CALL custom_stored_procedure_name

Volání uložená procedura mají být provedeny u odběratel.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.Při vytváření destination_owner není zadán, je před cíl název tabulka. Například pro ProductCategory tabulka ve vlastnictvíVýroba schématu u odběratel parametru by CALL sp_MSins_ProductionProductCategory. Pro článek v replikační topologie peer-to-peer, _table hodnota GUID je připojena. Určení custom_stored_procedure není podporována pro aktualizaci účastníkům.

SQL or NULL

Replikuje výraz INSERT.Hodnoty jsou uvedeny všechny sloupce, které jsou publikovány v článek výraz INSERT.Tento příkaz je replikována na vloží:

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

Další informace naleznete v tématu Určení, jak jsou šířeny změny pro transakční článků.

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

Hodnota

Popis

NONE

Žádná akce.

CALL sp_MSdel_ table (default)

– nebo –

CALL custom_stored_procedure_name

Volání uložená procedura mají být provedeny u odběratel.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.Při vytváření destination_owner není zadán, je před cíl název tabulka. Například pro ProductCategory tabulka ve vlastnictvíVýroba schématu u odběratel parametru by CALL sp_MSdel_ProductionProductCategory. Pro článek v replikační topologie peer-to-peer, _table hodnota GUID je připojena. Určení custom_stored_procedure není podporována pro aktualizaci účastníkům.

XCALL sp_MSdel_ tabulka

– nebo –

XCALL custom_stored_procedure_name

Volání uložená procedura, přičemž parametry stylu XCALL.Chcete-li použít tuto metoda replikace, schema_option určit automatické vytvoření uložená procedura nebo vytvořit zadaný uložená procedura v cíl databáze každého odběratel v článek. Určení uživatelem vytvořené uložená procedura pro aktualizaci účastníkům není povoleno.

SQL or NULL

Replikuje výraz DELETE.výraz DELETE je k dispozici všechny hodnoty sloupec primární klíč.Tento příkaz je replikována na odstraní:

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

Další informace naleznete v tématu Určení, jak jsou šířeny změny pro transakční článků.

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

Hodnota

Popis

NONE

Žádná akce.

CALL sp_MSupd_ tabulka

– nebo –

CALL custom_stored_procedure_name

Volání uložená procedura mají být provedeny u odběratel.Chcete-li použít tuto metoda replikace, schema_option určit automatické vytvoření uložená procedura nebo vytvořit zadaný uložená procedura v cíl databáze každého odběratel v článek.

MCALL sp_MSupd_ tabulka

– nebo –

MCALL custom_stored_procedure_name

Volání uložená procedura, přičemž parametry stylu MCALL.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.Při vytváření destination_owner není zadán, je před cíl název tabulka. Například pro ProductCategory tabulka ve vlastnictvíVýroba schématu u odběratel parametru by MCALL sp_MSupd_ProductionProductCategory. Pro článek v replikační topologie peer-to-peer, _table hodnota GUID je připojena. Určení uživatelem vytvořené uložená procedura pro aktualizaci účastníkům není povoleno.

SCALL sp_MSupd_ tabulka (Výchozí)

– nebo –

SCALL custom_stored_procedure_name

Volání uložená procedura, přičemž parametry stylu SCALL.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.Při vytváření destination_owner není zadán, je před cíl název tabulka. Například pro ProductCategory tabulka ve vlastnictvíVýroba schématu u odběratel parametru by SCALL sp_MSupd_ProductionProductCategory. Pro článek v replikační topologie peer-to-peer, _table hodnota GUID je připojena. Určení uživatelem vytvořené uložená procedura pro aktualizaci účastníkům není povoleno.

XCALL sp_MSupd_ tabulka

– nebo –

XCALL custom_stored_procedure_name

Volání uložená procedura, přičemž parametry stylu XCALL.Chcete-li použít tuto metoda replikace, schema_option určit automatické vytvoření uložená procedura nebo vytvořit zadaný uložená procedura v cíl databáze každého odběratel v článek. Určení uživatelem vytvořené uložená procedura pro aktualizaci účastníkům není povoleno.

SQL or NULL

Replikuje výraz UPDATE.výraz UPDATE je poskytován na všechny hodnoty sloupců a hodnoty pro sloupec primární klíč.Tento příkaz je replikována na aktualizace:

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

Syntaxe volat, MCALL, SCALL a XCALL lišit množství dat přeneseny do odběratel.Syntaxe volat předá všechny hodnoty pro všechny vložené a odstraněné sloupce.Syntaxi SCALL předává hodnoty pouze pro sloupce obsahující tuto chybu.Syntaxi XCALL předává hodnoty pro všechny sloupec, zda změnili nebo nikoli, včetně předchozí hodnoty sloupec.Další informace naleznete v tématu Určení, jak jsou šířeny změny pro transakční článků.

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

Hodnota

Popis

NONE

Příkaz nepoužívá.

Delete

Odstraní data z cíl tabulku před použitím snímek.Při následujícím vodorovně filtrováno, bude odstraněna pouze data ve sloupcích určený klauzule filtru.Není podporováno Oracle vydavatel při definování vodorovné filtru.

přetažení (Výchozí)

Kapky cíl tabulka.

zkrácení

Zkrátí cílové tabulka.Není platný pro ODBC nebo OLE databáze předplatitele.

[ @filter_clause=] 'filter_clause'

Omezení je klauzule (WHERE), definující vodorovné filtru.When entering the restriction clause, omit the keyword WHERE. filter_clause is ntext, with a default of NULL.Další informace naleznete v tématu Filtrování publikovaná data.

[ @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:

NoteNote:

Pokud je tato hodnota NULL, systém automaticky generuje možnost pro článek v závislosti na jiné vlastnosti článku a platné schéma.Složka Výchozí možnosti schématu tabulka uvedenou v poznámky zobrazí hodnotu, bude vybrán na základě kombinace typu článek a typ replikace.

Hodnota

Popis

0x00

Zakáže skriptovací agentem snímek a používá creation_script.

0x01

Generuje skript objektu vytváření (CREATE tabulka, CREATE PROCEDURE atd.).Tato hodnota je výchozí pro články uložená procedura.

0x02

Generuje uložené procedury, které šíření změn v článek-li definována.

0x04

Sloupce identity jsou scripted pomocí vlastnosti IDENTITY.

0x08

Replikovat timestamp sloupce. Není-li sada, timestamp sloupce jsou replikovány jako binary.

0x10

Generuje odpovídající clusterovaný index.I když tato volba není sada, indexy související s primárních klíčů a jedinečných omezení jsou generovány, jestliže jsou již definovány v publikované tabulce.

0x20

Převede uživatelem definované datové typy (uživatelsky definovaný typ) základní typy dat u odběratel.Tuto možnost nelze použít, pokud existuje omezení CHECK nebo DEFAULT na koloně uživatelsky definovaný typ Pokud uživatelsky definovaný typ sloupec je součástí primární klíč nebo pokud uživatelsky definovaný typ sloupec odkazuje na vypočítaný sloupec. Není podporována pro Oracle vydavatel.

0x40

Generuje odpovídající nonclustered indexy.I když tato volba není sada, indexy související s primárních klíčů a jedinečných omezení jsou generovány, jestliže jsou již definovány v publikované tabulce.

0x80

Replikuje omezení primární klíč.Také jsou replikovány žádné indexy, týkající se omezení, i v případě, že možnosti 0x10 and 0x40 nejsou povoleny.

0x100

Replikuje aktivační události uživatele na určitý článek tabulka, pokud je definována. Není podporována pro Oracle vydavatel.

0x200

Replikuje omezení cizí klíč.Pokud odkazovanou tabulka není součástí publikace, všechna omezení cizí klíč v publikované tabulce nejsou replikovány. Není podporována pro Oracle vydavatel.

0x400

Zóna je replikována kontrolních omezení. Není podporována pro Oracle vydavatel.

0x800

Replikuje výchozí hodnoty. Není podporována pro Oracle vydavatel.

0x1000

Replikuje kolace na úroveň sloupců.

NoteNote:
Tato možnost je třeba stanovit pro Oracle vydavatel Povolit porovnávání rozlišována velká a malá písmena.

0x2000

Rozšířené vlastnosti přidružené k objektu zdroj publikovaný článek replikaci. Není podporována pro Oracle vydavatel.

0x4000

Replikuje omezení UNIQUE.Také jsou replikovány žádné indexy, týkající se omezení, i v případě, že možnosti 0x10 and 0x40 nejsou povoleny.

0x8000

Tato možnost není platná pro SQL Server 2005 Vydavatelů.

0x10000

Replikuje omezení CHECK jako NOT FOR replikace tak, že během synchronizace není vynucena omezení.

0x20000

Replikuje cizí klíč omezení jako NOT FOR replikace tak, že během synchronizace není vynucena omezení.

0x40000

Replikuje filegroups přidružené dělená tabulka nebo indexu.

0x80000

Replikuje schéma oddílů pro dělená tabulka.

0x100000

Replikuje schéma oddílů indexu oddílů.

0x200000

Replikaci tabulka statistiky.

0x400000

Výchozí vazby

0x800000

Pravidlo vazby

0x1000000

Fulltextový index

0x2000000

Kolekce schémat XML je vázán na xml sloupce nejsou replikovány.

0x4000000

Replikuje na indexy xml sloupce.

0x8000000

Vytvořit všechny schémata, není již k dispozici na odběratel.

0x10000000

Převede xml sloupce ntext na odběratel.

0x20000000

Převede large object (typy datnvarchar(max), varchar(max)and varbinary(max)) zavedena v SQL Server 2005 na datové typy, které jsou podporovány na SQL Server 2000. Informace o mapovány tyto typy naleznete v části "Mapování nové datové typy pro staršími verzemi" Použití více verzí serveru SQL Server v replikační topologie.

0x40000000

Replikovat oprávnění.

0x80000000

Pokus o přímé závislosti na všechny objekty, které nejsou součástí publikace.

0x100000000

Tuto možnost použijte, chcete-li replikovat atribut FILESTREAM, pokud je zadán na varbinary(max) sloupce. Nezadávejte tuto možnost, pokud replikujete tabulek SQL Server 2005 Odběratelé. Replikace tabulek, které jsou FILESTREAM sloupce SQL Server 2000 Není podporována odběratelům, ohledu na to, jak je tato volba schématu sada.

Zobrazit související možnost 0x800000000.

0x200000000

Převede datum a čas (typy) datdate, time, datetimeoffsetand datetime2) zavedena v SQL Server 2008 na datové typy, které jsou podporovány v dřívějších verzích SQL Server. Informace o mapovány tyto typy naleznete v části "Mapování nové datové typy pro staršími verzemi" Použití více verzí serveru SQL Server v replikační topologie.

0x400000000

Replikuje možnost komprese dat a indexů.Další informace naleznete v tématu Vytvoření komprimované tabulky a indexy.

0x800000000

sada Tuto možnost, chcete-li ukládat data FILESTREAM na vlastní skupina souborů u odběratel.Není-li tato možnost sada, FILESTREAM data jsou uložena ve výchozí skupina souborů.Replikace nevytváří filegroups; proto, pokud jste sada tuto možnost, musíte vytvořit skupina souborů před použitím snímek u odběratel.Další informace o vytváření objektů před použitím snímek naleznete v tématu Provádění skriptů před a po je použit snímek.

Zobrazit související možnost 0x100000000.

0x1000000000

Převede společný jazyk runtime (CLR) uživatelem definované typy (UDTs) větší než 8 000 bajtů, které varbinary(max) tak, aby sloupce typu uživatelsky definovaný typ mohou být replikovány pro předplatitele se systémem SQL Server 2005.

0x2000000000

Převede hierarchyid Typ dat varbinary(max) tak, aby sloupce typu hierarchyid mohou být replikovány pro předplatitele se systémem SQL Server 2005. Další informace o použití hierarchyid Zobrazit sloupce v replikovaných tabulkách hierarchyid (Transact-SQL).

0x4000000000

Replikuje každé filtrované indexy tabulka.Další informace o filtrované indexy v tématu Filtrované pokyny návrh rejstříku.

0x8000000000

Převede geography and geometry datové typy varbinary(max) tak, že mohou být replikovány z těchto typů sloupců pro předplatitele se systémem SQL Server 2005.

0x10000000000

Replikuje indexy na sloupce typu geography and geometry.

0x20000000000

Replikuje atribut SPARSE pro sloupce.Další informace o tomto atribut naleznete v tématu Pomocí řídké sloupce.

HODNOTA NULL

Replikace automaticky nastaví. schema_option výchozí hodnotu, jejíž hodnota závisí na jiné vlastnosti článek. Tabulka (výchozí schéma Options) v části poznámky zobrazuje výchozí možnosti schéma založené na článek typ a typ replikace.

Výchozí nastavení pro ne-SQL Server publikace je 0x050D3.

Ne všechny schema_option hodnoty jsou platné pro každý typ replikace a typ článek. Složka Platné možnosti schématu tabulce v části poznámky jsou uvedeny platné schéma možnosti, které mohou být vybrána na základě kombinace typu článek a typ replikace.

[ @destination_owner =] 'destination_owner'

Is the name of the owner of the destination object. destination_owner is sysname, with a default of NULL.Při vytváření destination_owner není zadán, vlastník je určena automaticky na základě následujících pravidel:

Podmínka

Vlastník objektu cíl

Publikace používá ke generování počáteční snímek, který podporuje pouze hromadná kopíe nativním režimu SQL Server Odběratelé.

Výchozí hodnota source_owner.

Publikované z než-SQL Server Vydavatel.

Výchozí nastavení je vlastníkem cílové databáze.

Publikace používá hromadná kopíe pracující ve znakovém režimu ke generování počáteční snímek, která podporuje bez-SQL Server Odběratelé.

Není přiřazeno.

Pro podporu bez-SQL Server Zákazníci, destination_owner musí mít hodnotu 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.

Hodnota

Popis

1

Článek je aktivní.

8

Zahrnuje název sloupec v příkazech INSERT.

16 (Výchozí)

Používá parametry příkazů.

24

Obsahuje název sloupec v příkazech INSERT a využívá parametrizované příkazy.

64

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

Aktivní článek pomocí parametrizované výkazů by mít například hodnotu 17 v tomto sloupec.Hodnota 0 znamená, že v článek není aktivní a jsou definovány žádné další vlastnosti.

[ @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.Další informace o typech objektů, které mohou být publikovány pomocí snímek nebo transakční replikace naleznete v tématu Publikování dat a databázových objektů.

[ @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:

Hodnota

Popis

true

Umožňuje automatické identity rozsah zpracování

false

Zakáže automatické identity rozsah zpracování

NULL(default)

Je zpracování rozsah identity sada podle identityrangemanagementoption.

NoteNote:

auto_identity_range se již nepoužívá a jsou poskytovány z důvodu zpětné kompatibility pouze.Měli byste použít identityrangemanagementoption pro určení možnosti správy rozsah identity. Další informace naleznete v tématu Replikace identity sloupce.

[ @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. Není podporována pro Oracle vydavatel.

[ @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.Kdy použít auto_identity_range is sada to True. Není podporována pro Oracle vydavatel.

[ @threshold = ] threshold

Je-li procentuální hodnotu, která řídí, pokud Agent distribuce přiřadí nový rozsah identity.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.Kdy použít identityrangemanagementoption je nastavena na hodnotu Automatické or auto_identity_range je nastavena na hodnotu True. Není podporována pro Oracle vydavatel.

[ @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 Určuje, že článek přidání nezpůsobí snímek je neplatná.uložená procedura zjistí, že tato změna vyžaduje nový snímek, dojde k chybě a nebudou provedeny žádné změny.

1 Určuje, že přidání článek může způsobit, že snímek je neplatná a pokud existují odběry by vyžadujících nový snímek uděluje povolení existující snímek označit jako zastaralý a nový snímek, které budou generovány.

[ @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 = sloupec článek výchozí mapování jsou používány.Výchozí mapování pro typ dat lze zobrazit spuštěním sp_getdefaultdatatypemapping.

0 = vlastní článek sloupec mapování jsou definovány a proto sp_articleview není volá sp_addarticle.

Při vytváření use_default_datatypes je sada k 0musí provést sp_changearticlecolumndatatype jednou pro každý sloupec mapování měněn z výchozí hodnoty.Poté, co byly definovány všechny vlastní sloupec mapování, musí provést sp_articleview.

NoteNote:

Tento parametr je třeba používat pouze pro Oracle vydavatel.Nastavení use_default_datatypes Komu 0 for a SQL Server Vydavatel vygeneruje chybu.

[ @identityrangemanagementoption = ] identityrangemanagementoption

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

Hodnota

Popis

none

Replikace však žádné explicitní identity rozsah správy.Tato možnost je doporučena pouze pro zpětná kompatibilita se staršími verzemi serveru SQL Server.Není povoleno pro partner replikace.

manual

Označuje sloupec identity pomocí NOT FOR replikace povolit ruční identity rozsahu zpracování.

auto

Určuje Automatická správa identity rozsahy.

NULL(default)

Ve výchozím nastavení none Pokud hodnota auto_identity_range není true. Ve výchozím nastavení manual v topologii peer-to-peer (výchozí nastaveníauto_identity_range ignorován).

Z důvodu zpětné kompatibility když hodnota identityrangemanagementoption je NULL, hodnota auto_identity_range je zaškrtnuto. Nicméně, když hodnota identityrangemanagementoption není NULL a potom hodnotu auto_identity_range je ignorována.

Další informace naleznete v tématu Replikace identity sloupce.

[ @publisher = ] 'publisher'

Specifies a non-SQL Server Publisher. publisher is sysname, with a default of NULL.

NoteNote:

publisher není vhodné používat při přidávání článek SQL Server Vydavatel.

[ @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.Aktivační události mají být replikovány, aby hodnota maskování bitů schema_option musí obsahovat hodnotu 0x100.

0 (úspěch) nebo 1 (chyba)

sp_addarticle je používán snímková replikace nebo transakční replikace.

Podle výchozího nastavení replikace nepublikuje všech sloupců v zdroj tabulky když typ dat sloupec není podporována replikace.Potřebujete-li publikovat takový sloupec, bude nutné provést sp_articlecolumn přidat sloupec.Další informace naleznete v tématu Důležité informace pro všechny typy replikace.

Článek přidáte do publikace, který podporuje transakční replikace typu peer-to-peer, platí následující omezení:

  • Pro všechny články logbased musí být určen parametrizovanou příkazy.Je nutné zahrnout 16 in the status Value.

  • Název a vlastníka cílové tabulka musí odpovídat zdrojové tabulka.

  • V článek nelze filtrovat, vodorovně nebo svisle.

  • Rozsah správy automatické identity není podporován.Je nutné zadat hodnotu pro příručky identityrangemanagementoption.

  • Jestliže timestamp sloupec tabulka existuje, je nutné zahrnout 0x08 v schema_option k replikaci sloupec jako timestamp.

  • Hodnota SQL nelze zadat pro ins_cmd, upd_cmdand del_cmd.

Další informace naleznete v tématu Transakční replikace typu peer-to-peer.

Publikujete-li objekty, jejich definice jsou zkopírovány do předplatitele.Pokud publikujete databázový objekt, který závisí na jeden nebo více objektů, musíte publikovat všechny odkazované objekty.Například pokud publikujete zobrazení, které závisí na tabulka, musíte publikovat tabulka také.

Pokud vertical_partition je nastavena na hodnotu True, sp_addarticle odkládat údaje o vytváření zobrazení až do sp_articleview nazývá se (po poslední sp_articlecolumn přidán).

Je-li v publikace umožňuje aktualizaci odběry a v publikované tabulce nemá uniqueidentifier sloupce, sp_addarticle adds a uniqueidentifier sloupec do tabulka automaticky.

Výchozí možnosti schématu

Tato tabulka popisuje výchozí hodnota sada replikace, pokud schema_options není zadán uživatelem, pokud tato hodnota závisí na typu replikace (zobrazené v horní části) a typ článek (mimo provoz v prvním sloupec je zobrazen).

Typ článek

Typ replikace

 

 

Transakční

Snímek

pouze agregace schématu

0x01

0x01

pouze FUNC schématu.

0x01

0x01

pouze schéma indexované zobrazení

0x01

0x01

indexované zobrazení logbased

0x30F3

0x3071

indexované zobrazení logbase manualboth

0x30F3

0x3071

indexované zobrazení logbased manualfilter

0x30F3

0x3071

indexované zobrazení logbased manualview

0x30F3

0x3071

logbased

0x30F3

0x3071

logbased manualfilter

0x30F3

0x3071

logbased manualview

0x30F3

0x3071

proc exec

0x01

0x01

pouze proc schématu.

0x01

0x01

serializovat proc exec

0x01

0x01

zobrazení schématu pouze

0x01

0x01

NoteNote:

Je-li publikace povolena pro ve frontě, aktualizace, schema_option hodnota 0x80 je přidán do výchozí hodnotu uvedenou tabulka.Ve výchozím nastavení schema_option pro než-SQL Server publikace je 0x050D3.

Platné možnosti schématu

Tato tabulka popisuje přípustných hodnot schema_option na základě typu replikace (zobrazeného v horní části) a typ článek (mimo provoz v prvním sloupec je zobrazen).

Typ článek

Typ replikace

 

 

Transakční

Snímek

logbased

Všechny možnosti

Všechny možnosti, ale 0x02

logbased manualfilter

Všechny možnosti

Všechny možnosti, ale 0x02

logbased manualview

Všechny možnosti

Všechny možnosti, ale 0x02

indexované zobrazení logbased

Všechny možnosti

Všechny možnosti, ale 0x02

indexované zobrazení logbased manualfilter

Všechny možnosti

Všechny možnosti, ale 0x02

indexované zobrazení logbased manualview

Všechny možnosti

Všechny možnosti, ale 0x02

indexované zobrazení logbase manualboth

Všechny možnosti

Všechny možnosti, ale 0x02

proc exec

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

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

serializovat proc exec

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

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

pouze proc schématu.

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

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

zobrazení schématu pouze

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

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

pouze FUNC schématu.

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

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

pouze schéma indexované zobrazení

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

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

NoteNote:

Pro aktualizaci publikace ve frontě schema_option hodnoty 0x8000 and 0x80 musí být povoleno.Podporovaných schema_option hodnoty bez-SQL Server publikace jsou: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000, 0x4000 and 0X8000.

Pouze členové sysadmin pevná pevná role serveru nebo db_owner pevné databázová role lze provést sp_addarticle.

Zobrazit: