Share via


sp_addarticle (Transact-SQL)

makale oluşturur ve bu yayına ekler.Bu saklı yordam, yayın Veritabanı yayımcısına sırasında yürütülür.

Topic link iconTransact-SQL sözdizimi kuralları

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' ] 

Bağımsız değişkenler

  • [ @publication = ] 'publication'
    makale içeren yayın adıdır.The name must be unique in the database.publication is sysname, with no default.

  • [ @article = ] 'article'
    makale adıdır.The name must be unique within the publication.article is sysname, with no default.

  • [ @source_table = ] 'source_table'
    Bu parametre kalmıştır; kullanın source_object Bunun yerine.

    Bu parametre yalnızca ile geriye dönük uyumluluk için desteklenir SQL Server 6.5. Bu parametre, Oracle Yayımcılar için desteklenmiyor.

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

    yanlış dikey hiçbir filtre yoktur gösterir ve tüm sütunları yayımlar.

    TRUE tüm dışında bildirilen birincil anahtar sütunu null varsayılan sütunlar ve benzersiz bir anahtar sütunlarının temizler.Sütunları kullanılarak eklenir sp_articlecolumn.

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

    Değer

    Açıklama

    toplamak şema

    toplamak işlev ile yalnızca bir şema.

    işlev şema

    Yalnızca şemasıyla işlev.

    dizinli görünüm logbased

    dizinli görünüm günlük tabanlı makale.Oracle Yayımcılar için desteklenmiyor.Bu makale türü için temel tablo, ayrı olarak yayımlanacak şekilde gerek yoktur.

    dizinli görünüm logbased manualboth

    dizinli görünüm günlük tabanlı makale el ile süzgeç ve el ile bir görünüm.Bu seçenek her ikisini de belirtmeniz gerekir. sync_object ve filter Parametreler. Bu makale türü için temel tablo, ayrı olarak yayımlanacak şekilde gerek yoktur.Oracle Yayımcılar için desteklenmiyor.

    dizinli görünüm logbased manualfilter

    dizinli görünüm günlük tabanlı makale el ile süzgeç ile.Bu seçenek her ikisini de belirtmeniz gerekir. sync_object ve filter Parametreler. Bu makale türü için temel tablo, ayrı olarak yayımlanacak şekilde gerek yoktur.Oracle Yayımcılar için desteklenmiyor.

    dizinli görünüm logbased manualview

    dizinli görünüm günlük tabanlı makale el ile görünümüyle.Bu seçenek, belirttiğiniz gerektirir sync_object parametre. Bu makale türü için temel tablo, ayrı olarak yayımlanacak şekilde gerek yoktur.Oracle Yayımcılar için desteklenmiyor.

    dizinli görünüm şema

    dizinli görünüm ile yalnızca bir şema.Bu makale türü için de temel tablo yayımlanmalıdır.

    logbased (varsayılan)

    Günlük tabanlı makale.

    logbased manualboth

    Günlük tabanlı makale el ile süzgeç ve el ile görüntüle.Bu seçenek her ikisini de belirtmeniz gerekir. sync_object ve filter Parametreler. Oracle Yayımcılar için desteklenmiyor.

    logbased manualfilter

    El ile süzgeç içeren günlük tabanlı makale.Bu seçenek her ikisini de belirtmeniz gerekir. sync_object ve filter Parametreler. Oracle Yayımcılar için desteklenmiyor.

    logbased manualview

    Günlük tabanlı makale el ile görünümüyle.Bu seçenek, belirttiğiniz gerektirir sync_object parametre. Oracle Yayımcılar için desteklenmiyor.

    işlem Yönet

    saklı yordam yürütülmesini tüm abonelerine çoğaltır makale.Oracle Yayımcılar için desteklenmiyor.Seçeneğini kullanmanızı öneririz seri hale getirilebilir işlem Yönet yerineişlem Yönet.Daha fazla bilgi için "Türleri, saklı yordam yürütme makaleleri" bölümüne bakın Işlem çoğaltma, yayımlama saklı yordamı yürütme.

    yalnızca şema işlem

    Yalnızca bir şema yordamını.Oracle Yayımcılar için desteklenmiyor.

    seri hale getirilebilir işlem Yönet

    Yalnızca bir seri hale getirilebilir bir işlem bağlamında çalıştırılır, saklı yordam yürütülmesini çoğaltır.Oracle Yayımcılar için desteklenmiyor.

    yalnızca görünüm şema

    Yalnızca şemasıyla görüntüleyin.Oracle Yayımcılar için desteklenmiyor.Bu seçeneği kullanırken, temel tablo yayımlamanız gerekir.

  • [ @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.Değil null ise, filtre yordamını oluşturulamadı (saklı yordam el ile oluşturduğunuz varsayılmıştır).

  • [ @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.null ise, sp_articleview otomatik olarak çıkış dosyası oluşturmak için kullanılan görünümü oluşturmak için verilir.Bu, tüm sütunlarla ekledikten sonra ortaya çıkar: sp_articlecolumn.Değil null ise, bir görünümü oluşturulamadı (Görünüm, el ile oluşturulduğunda varsayılmıştır).

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

    Değer

    Açıklama

    YOK

    Hiçbir işlem yapılmaz.

    CALL sp_MSins_tablo (varsayılan)

    -ya da-

    CALL custom_stored_procedure_name

    Abone tarafında yürütülecek saklı bir yordamı çağırır.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.Ne zaman destination_owner , için hedef tablo adı e belirtilir. Örneğin, için ProductCategory sahibi tarafından tablosuÜretim şema abone, parametre sırasında olacağınıCALL sp_MSins_ProductionProductCategory. Eşler arası çoğaltma topolojisinde, bir makale için _table bir GUID değeri eklenir. Belirtme custom_stored_procedure Abonelerin güncelleştirmek için desteklenmiyor.

    sql or NULL

    INSERT deyim çoğaltır.INSERT deyim, makale yayımlanmış olan tüm sütunlar için değer sağlanır.Bu komut, ekler üzerinde çoğaltılır:

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

    Daha fazla bilgi için bkz: Değişiklikler için işlem makaleleri nasıl yayılma belirtme.

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

    Değer

    Açıklama

    YOK

    Hiçbir işlem yapılmaz.

    CALLsp_MSdel_table (default)

    -ya da-

    CALL custom_stored_procedure_name

    Abone tarafında yürütülecek saklı bir yordamı çağırır.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.Ne zaman destination_owner , için hedef tablo adı e belirtilir. Örneğin, için ProductCategory sahibi tarafından tablosuÜretim şema abone, parametre sırasında olacağınıCALL sp_MSdel_ProductionProductCategory. Eşler arası çoğaltma topolojisinde, bir makale için _table bir GUID değeri eklenir. Belirtme custom_stored_procedure Abonelerin güncelleştirmek için desteklenmiyor.

    XCALL sp_MSdel_tablo

    -ya da-

    XCALL custom_stored_procedure_name

    Çağrı bir saklı yordam XCALL stili parametrelerini alır.Bu çoğaltma yöntem kullanmak için schema_option saklı yordam otomatik olarak oluşturulmasını belirtin veya belirtilen saklı yordam her abone hedef veritabanında oluşturmak için makale. Bir kullanıcı tarafından oluşturulan saklı yordam belirtme, abonelerin güncelleştirmek için izin verilmez.

    sql or NULL

    DELETE deyim çoğaltır.DELETE deyim, tüm birincil anahtar sütun değerleri sağlanmıştır.Bu komut, silmeleri üzerinde çoğaltılır:

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

    Daha fazla bilgi için bkz: Değişiklikler için işlem makaleleri nasıl yayılma belirtme.

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

    Değer

    Açıklama

    YOK

    Hiçbir işlem yapılmaz.

    CALL sp_MSupd_tablo

    -ya da-

    CALL custom_stored_procedure_name

    Abone tarafında yürütülecek saklı bir yordamı çağırır.Bu çoğaltma yöntem kullanmak için schema_option saklı yordam otomatik olarak oluşturulmasını belirtin veya belirtilen saklı yordam her abone hedef veritabanında oluşturmak için makale.

    MCALL sp_MSupd_tablo

    -ya da-

    MCALL custom_stored_procedure_name

    Çağrı bir saklı yordam MCALL stili parametrelerini alır.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.Ne zaman destination_owner , için hedef tablo adı e belirtilir. Örneğin, için ProductCategory sahibi tarafından tablosuÜretim şema abone, parametre sırasında olacağınıMCALL sp_MSupd_ProductionProductCategory. Eşler arası çoğaltma topolojisinde, bir makale için _table bir GUID değeri eklenir. Bir kullanıcı tarafından oluşturulan saklı yordam belirtme, abonelerin güncelleştirmek için izin verilmez.

    SCALL sp_MSupd_tablo (varsayılan)

    -ya da-

    SCALL custom_stored_procedure_name

    SCALL stili parametrelerini alma saklı bir yordamı çağırır.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.Ne zaman destination_owner , için hedef tablo adı e belirtilir. Örneğin, için ProductCategory sahibi tarafından tablosuÜretim şema abone, parametre sırasında olacağınıSCALL sp_MSupd_ProductionProductCategory. Eşler arası çoğaltma topolojisinde, bir makale için _table bir GUID değeri eklenir. Bir kullanıcı tarafından oluşturulan saklı yordam belirtme, abonelerin güncelleştirmek için izin verilmez.

    XCALL sp_MSupd_tablo

    -ya da-

    XCALL custom_stored_procedure_name

    Çağrı bir saklı yordam XCALL stili parametrelerini alır.Bu çoğaltma yöntem kullanmak için schema_option saklı yordam otomatik olarak oluşturulmasını belirtin veya belirtilen saklı yordam her abone hedef veritabanında oluşturmak için makale. Bir kullanıcı tarafından oluşturulan saklı yordam belirtme, abonelerin güncelleştirmek için izin verilmez.

    sql or NULL

    Bir UPDATE deyim çoğaltır.UPDATE deyimini, tüm sütun değerleri ve birincil anahtar sütunu değerlerine sağlanır.Bu komut, güncelleştirmeler çoğaltılır:

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

    Not

    ÇAĞıR, MCALL SCALL ve XCALL sözdizimi için abone bulaşan veri miktarı değişir.CALL sözdizimi, eklenen ve silinen tüm sütunlar için tüm değerleri geçirir.SCALL sözdizimi, yalnızca etkilenen sütunlar için değer geçirir.Veya, önceki sütunun değeri de dahil olmak üzere değiştirilmiş olup olmadığını, XCALL sözdizimi, tüm sütunlar için değer geçirir.Daha fazla bilgi için bkz: Değişiklikler için işlem makaleleri nasıl yayılma belirtme.

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

    Değer

    Açıklama

    yok

    Bir komutu kullanmaz.

    silme

    Hedef verileri siler tablo anlık görüntü görüntü uygulamadan önce.makale yatay süzülür, yalnızca filtre yan tümcesiyle belirtilen sütunlarındaki veriler silinir.Yatay bir filtre tanımladığınızda Oracle Yayımcılar için desteklenmiyor.

    bırakma (varsayılan)

    Hedef Tablo bırakır.

    Kes

    Hedef Tablo keser.ODBC veya OLE DB aboneleri için geçerli değil.

  • [ @filter_clause=] 'filter_clause'
    Bir kısıtlama mı yatay bir süzgeç tanımlayan bir (WHERE) yan tümce.When entering the restriction clause, omit the keyword WHERE.filter_clause is ntext, with a default of NULL.Daha fazla bilgi için bkz: Süzme veri yayımlandı..

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

    Not

    Bu değer null (BOş) olduğunda, sistem otomatik-makale diğer makale özelliklerine bağlı olarak bir geçerli şema seçeneği oluşturur.The Default Schema Options tablo given in the Remarks shows the value that will be chosen based upon the combination of the makale type and the çoğaltma type.

    Değer

    Açıklama

    0x00

    Anlık Görüntü Aracısı tarafından komut dosyası kullanan kullanan dosyası kullanan devre dışı bırakır ve kullanır creation_script.

    0x01

    Nesne oluşturma komut (CREATE tablo, CREATE PROCEDURE vb.) oluşturur.Bu saklı yordam makaleler için varsayılan değerdir.

    0x02

    Tanımlanan değişiklikleri makale, depolanan yordamlar oluşturur.

    0x04

    Kimlik sütunları KIMLIK özellik'ni kullanarak komut dosyası.

    0x08

    Çoğaltma timestamp sütunlar. Aksi takdirde, küme timestamp sütun olarak çoğaltılan binary.

    0x10

    Ilgili kümelenmiş dizin oluşturur.Bu seçenek bulunmasa bile küme önceden yayımlanmış bir tabloda tanımlanır, benzersiz kısıtlamaları tarafından oluşturulan ve birincil anahtarlar için dizinlerin ilgili.

    0x20

    Abone veri türlerini temel dönüştürür kullanıcı tanımlı veri türleri (UDT).Olduğunda UDT sütun, bir CHECK veya VARSAYıLAN kısıtlama UDT sütunu birincil anahtarının parçası veya hesaplanan sütun UDT sütun başvuruyorsa, bu seçenek kullanılamaz.Oracle Yayımcılar için desteklenmiyor..

    0x40

    Ilgili kümelenmemiş dizin oluşturur.Bu seçenek bulunmasa bile küme önceden yayımlanmış bir tabloda tanımlanır, benzersiz kısıtlamaları tarafından oluşturulan ve birincil anahtarlar için dizinlerin ilgili.

    0x80

    Birincil anahtar kısıtlamaları çoğaltır.Kısıtlama olarak ilgili herhangi bir dizin de çoğaltılır, bile seçenekleri 0x10 and 0x40 etkinleştirilmez.

    0x100

    Bir tablo makale üzerinde kullanıcı Tetikleyicileri tanımlanmışsa çoğaltır.Oracle Yayımcılar için desteklenmiyor..

    0x200

    Yabancı anahtar kısıtlamalarını çoğaltır.Başvurulan tablo yayınn tüm yabancı anahtar kısıtlamaları yayımlanmış bir parçası olmayan tablo değil çoğaltılır.Oracle Yayımcılar için desteklenmiyor..

    0x400

    Çoğaltır kısıtlamalarını denetleyin.Oracle Yayımcılar için desteklenmiyor..

    0x800

    Varsayılan olarak çoğaltılır.Oracle Yayımcılar için desteklenmiyor..

    0x1000

    sütun düzeyinde harmanlama çoğaltır.

    NoteNote:
    Bu seçenek, Oracle büyük/küçük durum duyarlı karşılaştırma etkinleştirmek Yayımcılar için ayarlanmalıdır.

    0x2000

    Genişletilmiş Özellikler yayımlanmış kaynak nesne ilişkili çoğaltır.Oracle Yayımcılar için desteklenmiyor..

    0x4000

    UNIQUE kısıtlamaları çoğaltır.Kısıtlama olarak ilgili herhangi bir dizin de çoğaltılır, bile seçenekleri 0x10 and 0x40 etkinleştirilmez.

    0x8000

    Bu seçenek için geçerli değildir. SQL Server 2005 Yayımcılar.

    0x10000

    Böylece, eşitleme sırasında kısıtlamalar zorlandığı CHECK kısıtlamaları NOT FOR çoğaltma çoğaltılır.

    0x20000

    Böylece, eşitleme sırasında kısıtlamalar zorlandığı yabancı anahtar kısıtlamaları NOT FOR çoğaltma çoğaltılır.

    0x40000

    bölümlenmiş tablo veya dizin ile ilişkili dosya gruplarını çoğaltır.

    0x80000

    bölümlenmiş tablo için bölümleme düzeni çoğaltır.

    0x100000

    bölümlenmiş dizin için bölümleme düzeni çoğaltır.

    0x200000

    Çoğaltır istatistik tablosu.

    0x400000

    Varsayılan bağlantılar

    0x800000

    Kural bağlar

    0x1000000

    Tam metin dizini

    0x2000000

    XML şema koleksiyonları bağlı xml sütunları çoğaltılmaz.

    0x4000000

    Üzerinde dizin çoğaltır. xml sütunlar.

    0x8000000

    Zaten mevcut olan şemalar abonelik oluşturun.

    0x10000000

    Dönüştürür xml sütunları ntext Abone üzerinde.

    0x20000000

    Büyük nesne veri türleri ((ingilizce) dönüştürür.nvarchar(max), varchar(max), ve varbinary(max))'de kullanılmaya başlandı. SQL Server 2005 üzerinde desteklenen veri türleri SQL Server 2000. Bu türleri ile nasıl eşleştirildikleri hakkında daha fazla bilgi için "Eşleme yeni veri türleri için önceki sürümler" bölümüne bakın... Bir çoğaltma topolojisi SQL Server birden çok sürümünü kullanma.

    0x40000000

    Izinleri çoğaltırlar.

    0x80000000

    yayın bir parçası olmayan herhangi bir nesne bağımlılıkları bırakma girişimi.

    0x100000000

    Üzerinde belirtilirse FILESTREAM özniteliği çoğaltmak için bu seçeneği kullanın. varbinary(max) sütunlar. Tablolara çoğaltıyorsanız, bu seçeneği belirtin SQL Server 2005 Abonelerin. FILESTREAM sütunları olan tablo çoğaltılıyor SQL Server 2000 Abonelerin desteklenmiyor, bu şema seçeneği ayarlanma şekli olsun.

    Ilgili seçeneği Bkz: 0x800000000.

    0x200000000

    Tarih ve saat veri türü () dönüştürür.date, time, datetimeoffset, ve datetime2)'de kullanılmaya başlandı. SQL Server 2008 önceki sürümlerinde desteklenen veri türleri SQL Server. Bu türleri ile nasıl eşleştirildikleri hakkında daha fazla bilgi için "Eşleme yeni veri türleri için önceki sürümler" bölümüne bakın... Bir çoğaltma topolojisi SQL Server birden çok sürümünü kullanma.

    0x400000000

    Veri ve dizinler için sıkıştırma seçeneğini çoğaltır.Daha fazla bilgi için bkz: Sıkıştırılmış tablolar ve dizinler oluşturma.

    0x800000000

    küme dosya grubu abone adresindeki FILESTREAM veri saklamak için bu seçeneği.Bu seçenek, küme, FILESTREAM veriler üzerinde varsayılan dosya grubu depolanır.Çoğaltma dosya gruplarını oluşturun; bu seçeneği ayarlarsanız, rapor anlık görüntü görüntü görüntüsünü abone adresindeki uygulamadan önce bu nedenle, dosya grubu oluşturmanız gerekir.Rapor anlık görüntü görüntü görüntüsünü uygulamadan önce nesneleri oluşturma hakkında daha fazla bilgi için bkz: Önce ve sonra rapor anlık görüntüsünü uygulanan komut dosyalarını çalıştırma.

    Ilgili seçeneği Bkz: 0x100000000.

    0x1000000000

    8000 Bayttan daha büyük olan ortak dil çalışma zamanı (CLR) kullanıcı tanımlı türler (UDTs) dönüştürür. varbinary(max) Böylece, sütunu Tür UDT çalışan aboneleri için çoğaltılabilir. SQL Server 2005.

    0x2000000000

    Dönüştürür hierarchyid veri türü için varbinary(max) Böylece sütun türü hierarchyid çalışmakta olan aboneleri için çoğaltılabilir SQL Server 2005. Daha fazla bilgi için kullanma hakkında hierarchyid Yinelenen tablolar, sütunlar Bkz: hierarchyid (Transact-SQL).

    0x4000000000

    Süzülmüş bir tablo dizinleri çoğaltır.Süzülmüş dizinler hakkında daha fazla bilgi için bkz: Süzülmüş dizin tasarım yönergeleri.

    0x8000000000

    Dönüştürür geography ve geometry veri türleri varbinary(max) Böylece, sütunların bu türleri çalışan aboneleri için çoğaltılabilir. SQL Server 2005.

    0x10000000000

    Sütun türü dizinlerde çoğaltır. geography ve geometry.

    0x20000000000

    Sütunların SPARSE özniteliği çoğaltılır.Bu öznitelik hakkında daha fazla bilgi için bkz: Seyrek sütunları kullanma.

    null

    Çoğaltma otomatik olarak ayarlar schema_option Varsayılan değer olarak, hangi değeri, diğer makale özelliklerine bağlıdır. "Varsayılan şema Seçenekleri" Tablo Açıklamalar bölümündeki makale türü ve çoğaltma türünü temel alan varsayılan şema seçeneklerini gösterir.

    Varsayılan olmayan-SQL Server yayınları olur. 0x050D3.

    Tüm schema_option Her çoğaltma türünü ve makale türü için geçerli değerlerdir. The Valid Schema Options tablo in the Remarks section shows the valid schema options that can be chosen based upon the combination of the makale type and the çoğaltma type.

  • [ @destination_owner =] 'destination_owner'
    Is the name of the owner of the destination object.destination_owner is sysname, with a default of NULL.Ne zaman destination_owner belirtilmemişse, aşağıdaki kuralları alarak otomatik olarak belirtilen sahibi:

    Koşul

    Hedef nesne sahibi

    Yayın yerel moddaki toplu kopyalama yalnızca destekleyen ilk anlık görüntü görüntü görüntü oluşturmak için kullanır. SQL Server Abonelerin.

    Varsayılan değeri source_owner.

    Olmayan bir yayımlanmış-SQL Server Yayımcı.

    Varsayılan olarak, hedef veritabanının sahibi.

    Yayın olmayan destekleyen anlık görüntü görüntü görüntüsünü, ilk oluşturmak için karakter modu toplu kopyayı kullanır-SQL Server Abonelerin.

    Atanmamış.

    Olmayan desteklemek için-SQL Server Abonelerin, destination_owner NULL olmalıdır.

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

    Değer

    Açıklama

    1

    Makale etkindir.

    8

    Sütun adı, INSERT deyimlerinde içerir.

    16 (varsayılan)

    Kullanan ifadeler parametreli.

    24

    INSERT deyimlerinde sütun adını içerir ve parametreli ifadeleri kullanır.

    64

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

    Örneğin, parametreleştirilmiş ifadeleri kullanarak etkin bir makale bu sütunda 17 değeri yoktur.Değeri 0 makale etkin değildir ve hiçbir ek özellikler tanımlanır anlamına gelir.

  • [ @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.Anlık görüntü veya işlem çoğaltma yayımlanabilir nesne türleri hakkında daha fazla bilgi için bkz: Yayımlama veri ve veritabanı nesneleri.

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

    Değer

    Açıklama

    true

    Otomatik kimlik aralık işlenmesini sağlar

    false

    Otomatik kimlik aralık işleme devre dışı bırakır.

    NULL(default)

    Kimlik aralık işleme küme identityrangemanagementoption.

    Not

    auto_identity_range onaylanmaz ve yalnızca geriye dönük uyumluluk için sağlanır.Kullanmanız gereken identityrangemanagementoption kimlik aralık yönetimi seçeneklerini belirtmek için. Daha fazla bilgi için bkz: Kimlik sütunları çoğaltılıyor.

  • [ @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.Oracle Yayımcılar için desteklenmiyor..

  • [ @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.Ne zaman kullanılır auto_identity_range is küme to TRUE.Oracle Yayımcılar için desteklenmiyor..

  • [ @threshold = ] threshold
    Distribution Agent'ne zaman yeni bir kimlik aralık atar denetleyen yüzde değeridir.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.Ne zaman kullanılır identityrangemanagementoption olan küme için otomatik or auto_identity_range olan küme için TRUE.Oracle Yayımcılar için desteklenmiyor..

  • [ @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 , makale ekleme geçersiz olduğu anlık görüntü neden olmaz, belirtir.saklı yordam değişiklik yeni bir anlık görüntü gerektirdiğini algılar, bir hata oluşuyor ve değişiklik yapılmaz.

    1 makale geçersiz olduğu anlık görüntü neden olabilir ve abonelikler varsa, yeni bir anlık görüntü gerektiren ekleme izni için geçersiz olarak işaretlenmesi için varolan anlık görüntüsünü ve oluşturulacak yeni bir anlık görüntü verir belirtir.

  • [ @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 eşlemeleri kullanılan varsayılan makale sütun =.Varsayılan veri türü eşlemeler yürüterek görüntülenebilir. sp_getdefaultdatatypemapping.

    0 özel makale sütun eşlemeleri tanımlanır ve bu nedenle =sp_articleview adlandırılansp_addarticle.

    Ne zaman use_default_datatypes ayarlamak 0 yürütmelisiniz.sp_changearticlecolumndatatype eşleştirilmesine varsayılan değiştirilmesini kez her sütun.Tüm özel sütun eşlemeleri tanımladıktan sonra gereken yürütmek sp_articleview.

    Not

    Bu parametre yalnızca, Oracle Yayımcılar için kullanılmalıdır.Ayarı use_default_datatypes için 0 for a SQL Server Yayımcı, bir hata üretir.

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

    Değer

    Açıklama

    none

    Çoğaltma, hiçbir açık kimlik aralık yönetimini yapar.Bu seçenek yalnızca geriye doğru SQL Server'ın önceki sürümleriyle uyumluluk önerilir.Eş çoğaltmaya izin verilmiyor.

    manual

    El ile kimlik aralık işlemeyi etkinleştirmek IÇIN NOT çoğaltma kullanarak kimlik sütun olarak işaretler.

    auto

    Otomatik yönetim kimlik aralıklarını belirtir.

    NULL(default)

    Varsayılan olarak none zaman değeri auto_identity_range değil true. Varsayılan olarak manual bir eşler arası topolojide (varsayılanauto_identity_range göz ardı edilir).

    Geriye dönük uyumluluk için zaman değeri identityrangemanagementoption null, değeri auto_identity_range denetlenir. Ancak, zaman değeri identityrangemanagementoption NULL, sonra da değeri değil auto_identity_range göz ardı edilir.

    Daha fazla bilgi için bkz: Kimlik sütunları çoğaltılıyor.

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

    Not

    publisher bir makale eklerken kullanılmamalıdır bir SQL Server Yayımcı.

  • [ @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.Sırada çoğaltılması, , Tetikleyiciler için bit maskesi değeri schema_option değer içermelidir 0x100.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (hata)

Remarks

sp_addarticle anlık görüntü çoğaltması çoğaltması veya işlem çoğaltma için kullanılır.

Varsayılan olarak, kaynağı içindeki sütun çoğaltma yayımlamaz tablo çoğaltma tarafından ne zaman sütun veri türü desteklenmiyor.Bir sütunu yayımlamak istiyorsanız, yürütmek gerekir sp_articlecolumn sütun eklemek için.Daha fazla bilgi için bkz: Çoğaltma tüm türleri ile ilgili konuları.

makale eşler arası işlem çoğaltma destekleyen bir yayına eklerken, aşağıdaki kısıtlamalar geçerlidir:

  • Parametreli deyimleri tüm logbased makaleler için belirtilmiş olmalı.Eklemeniz gerekir 16 in the status değer.

  • Ad ve sahibine hedef tablonun kaynak tablo eşleşmesi gerekir.

  • makale, yatay veya dikey olarak filtre uygulanamıyor.

  • Otomatik kimlik aralık yönetimi desteklenmiyor.El ile ilgili bir değer belirtmeniz gerekir identityrangemanagementoption.

  • Varsa bir timestamp sütun bulunmaktadır tablo, içinde 0x08 içermelidir schema_option sütun olarak yinelemek için timestamp.

  • Değeri sql için belirtilemez.ins_cmd, upd_cmd, ve del_cmd.

Daha fazla bilgi için bkz: Eşler işlemsel kopyalama.

Nesneleri yayımladığınızda, bunların tanımları abonelerine kopyalanır.Bir veya daha çok diğer nesnelerin bağlı bir veritabanı nesnesini yayımlıyorsanız, tüm başvurulan nesnelerin yayımlamanız gerekir.Örneğin, bir tabloda bağımlı bir görünüm yayımlarsanız, tablo de yayımlamanız gerekir.

If vertical_partition olan küme için TRUE, sp_addarticle kadar görünümü oluşturulmasını defers...sp_articleview (son sonra yeniden adlandırılırsp_articlecolumn eklenir).

yayın abonelikler ve da yayımlanmış güncelleştirme veriyorsa tablo sahip olmadığı bir uniqueidentifier sütun sp_addarticle adds a uniqueidentifier sütun için tablo otomatik olarak.

Varsayılan şema seçenekleri

Bu tablo, çoğaltma tarafından ayarlanan varsayılan değerini açıklar. schema_options Bu değer, çoğaltma türü (üst boyunca görüntülenen) ve makale türü yere bağlıdır kullanıcı tarafından belirtilen (gösterilen kapalı ilk sütun).

Makale türü

Çoğaltma türü

 

 

Işlem

Anlık görüntü

toplamak şema

0x01

0x01

işlev şema

0x01

0x01

dizinli görünüm şema

0x01

0x01

dizinli görünüm logbased

0x30F3

0x3071

dizinli görünüm logbase manualboth

0x30F3

0x3071

dizinli görünüm logbased manualfilter

0x30F3

0x3071

dizinli görünüm logbased manualview

0x30F3

0x3071

logbased

0x30F3

0x3071

logbased manualfilter

0x30F3

0x3071

logbased manualview

0x30F3

0x3071

işlem Yönet

0x01

0x01

yalnızca şema işlem

0x01

0x01

seri hale getirilebilir işlem Yönet

0x01

0x01

yalnızca görünüm şema

0x01

0x01

Not

yayın güncelleştirme, sıraya için etkinse, bir schema_option değeri 0x80 gösterilen varsayılan değer olarak eklenen tablo.Varsayılan değer schema_option olmayan bir için-SQL Server yayın 0x050D3.

Geçerli şema seçenekleri

Bu tabloda, izin verilen değerleri açıklanmaktadır. schema_option çoğaltma türü (üst boyunca görüntülenen) ve makale türü (ilk sütun boyunca gösterilen) göre.

Makale türü

Çoğaltma türü

 

 

Işlem

Anlık görüntü

logbased

Tüm Seçenekler

Tüm seçenekler ancak 0x02

logbased manualfilter

Tüm Seçenekler

Tüm seçenekler ancak 0x02

logbased manualview

Tüm Seçenekler

Tüm seçenekler ancak 0x02

dizinli görünüm logbased

Tüm Seçenekler

Tüm seçenekler ancak 0x02

dizinli görünüm logbased manualfilter

Tüm Seçenekler

Tüm seçenekler ancak 0x02

dizinli görünüm logbased manualview

Tüm Seçenekler

Tüm seçenekler ancak 0x02

dizinli görünüm logbase manualboth

Tüm Seçenekler

Tüm seçenekler ancak 0x02

işlem Yönet

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

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

seri hale getirilebilir işlem Yönet

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

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

yalnızca şema işlem

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

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

yalnızca görünüm şema

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

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

işlev şema

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

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

dizinli görünüm şema

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

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

Not

Kuyruğa Alınmış Güncelleştirme yayınlar için schema_option değerleri 0x8000 and 0x80 etkinleştirilmiş olması gerekir.Desteklenen schema_option için değer olmayan-SQL Server yayınları şunlardır: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000, 0x4000 and 0X8000.

İzinler

Yalnızca üyeleri sysadmin sabit sunucu rolü veya db_owner sabit veritabanı rolü çalıştırabilirsinizsp_addarticle.