Aracılığıyla paylaş

  • Makale

SQL Server XML toplu yükleme nesne modeli (SQLXML 4.0)

Microsoft Office 2010 SuiteSQL ServerNesne modeli XML toplu yükleme içerirSQLXMLBulkLoadnesne.Bu nesne, aşağıdaki yöntem ve özelliklerini destekler.

Yöntemleri

  • Execute
    Toplu verileri şema dosyası ve veri dosyası (veya akış) sağlanan parametre olarak kullanarak yükler.

Özellikler

  • BulkLoad
    toplu yükleme işlemi belirtir.Yalnızca şemaları oluşturmak istiyorsanız bu özellik yararlıdır (bkz: SchemaGen, SGDropTables, ve SGUseIDizleyen özellikleri) ve bir yığın yüklenemedi. değilBu, bir Boole özellik.Özellik olduğunda küme, TRUE olarak XML toplu yükleme yürütür.Bu olduğunda küme FALSE olarak XML toplu yükleme değil çalıştırmak.

    Varsayılan değer TRUE olur.

  • CheckConstraints
    (Örneğin, birincil anahtar yabancı anahtar ilişkisi sütun s arasında kısıtlamaları nedeniyle) kısıtlamaları olan olup olmadığını belirtir belirtilen sütun, veriyi XML toplu yükleme sütun s ekler denetlenmelidir.Bu, bir Boole özellik.

    özellik olduğunda küme TRUE, XML toplu yükleme denetim kısıtlamaları her değer için (bir kısıtlama ihlali hataya neden hangi yol) eklenmiş olarak.

    Not

    Bu özellik, yanlış olarak bırakmak için olmalıdırALTER TABLE Hedef tablo. izinleri Daha fazla bilgi için bkz:ALTER tablo (Transact-SQL).

    FALSE varsayılan değerdir.Bu olduğunda küme FALSE olarak bir ekleme işlemi sırasında XML toplu yükleme kısıtlamalar yoksayar.Geçerli uygulamasında sırasına birincil anahtar ve yabancı anahtar ilişkileri eşleme şemada tablolar tanımlamanız gerekir.Diğer bir deyişle, bir birincil anahtar tablosuyla önce ilgili tablo ile yabancı anahtar tanımlanmış olmalıdır; aksi durumda, XML toplu yükleme başarısız olur.

    Kimlik yayılımı yapılır, sonra bu seçeneği uygulanmaz ve denetleme kısıtlaması üzerinde kalır, unutmayın.Böyle,KeepIdentity=Falseve bir ilişki tanımlanmış üst bir kimlik alan olduğu ve değer, oluşturulan alt için verilir.

  • ConnectionCommand
    Varolan bir bağlantı nesnesini tanımlar (örneğin, ADO veya ICommandkomut nesnesi) XML toplu yükleme. edilmeyecekKullanabileceğinizConnectionCommandözelliği, bir bağlantı yerine dize ileConnectionStringözellik.The Transaction property must be set to TRUE if you use ConnectionCommand.

    , Her ikisi de kullanırsanız,ConnectionStringveConnectionCommandözellikleri, XML toplu yükleme kullanan son belirtilen özellik.

    Varsayılan değer NULL olur.

  • ConnectionString
    Veritabanı örnek ile bağlantı kurmak için gerekli bilgileri sağlayan OLE DB bağlantı dizesi tanımlar., Her ikisi de kullanırsanız,ConnectionStringveConnectionCommandözellikleri, XML toplu yükleme kullanan son belirtilen özellik.

    Varsayılan değer NULL olur.

  • ErrorLogFile
    XML toplu yükleme hata iletileri kaydeder ve dosya adını belirtir.Varsayılan değer boş bir dize, hiçbir günlük alır yer durumda.

  • FireTriggers
    Toplu yükleme işlemi sırasında hedef tablo üzerinde tanımlı Tetikleyiciler harekete, belirtir.Varsayılan değer yanlış'tır.

    , küme İçin doğru tetikleyen olacak yangın sırasında normal olarak her ekleme işlemlerinin.

    Not

    Bu özellik, yanlış olarak bırakmak için olmalıdırALTER TABLE Hedef tablo. izinleri Daha fazla bilgi için bkz:ALTER tablo (Transact-SQL).

    Kimlik yayılımı yapılır, sonra bu seçeneği uygulanmaz ve tetikleyiciler, sol unutmayın.Böyle,KeepIdentity=Falseve bir ilişki tanımlanmış üst bir kimlik alan olduğu ve değer, oluşturulan alt için verilir.

  • ForceTableLock
    Toplu yükleme süresince, verileri XML Bulk Load kopyalar tabloları kilitlenmesi olup olmadığını belirtir.Bu, bir Boole özellik.özellik olduğunda küme, TRUE olarak XML toplu yükleme toplu yükleme süresince tablo kilitli tutar.Bu olduğunda küme FALSE olarak XML toplu yükleme tablo kilit her tabloya, ekler kayıt tutar.

    FALSE varsayılan değerdir.

  • IgnoreDuplicateKeys
    Yinelenen değerleri bir anahtar eklemek için bir girişimde yapılırsa ne belirtir sütun.Bu özellik ise küme TRUE olarak ve bir anahtar sütununa yinelenen değer içeren bir kayıt eklemek için girişimdeSQL Serverdeğil ekleyin, kaydı.Ancak sonraki kaydı ekleyin; toplu yükleme işlemi değil bu nedenle, başarısız.Bu özellik FALSE olarak ayarlanýrsa, girişimi yapıldığında bir anahtar sütununa yinelenen bir değer eklemek için toplu yükleme başarısız olur.

    ,IgnoreDuplicateKeysözelliği küme, TRUE olarak eklenen tablo. her kayıt için verilen bir yürütme deyimBu performansını yavaşlatır.Özelliği yalnızca TRUE zaman ayarlanabilirTransactionözellik küme yanlış, çünkü işlem davranışı uygulanan kullanarak dosyaları.

    FALSE varsayılan değerdir.

  • KeepIdentity
    Bir kimlik türü değerleri ile nasıl belirtir sütun kaynak dosyasında.Bu, bir Boole özellik.Özellik olduğunda küme için dosya kimliği sütun veri kaynağında belirtilen değerler TRUE, XML toplu yükleme atar.Özellik olduğunda küme FALSE olarak yığın yükleme işlemi veri kaynağında belirtilen kimlik sütun değerleri yok sayar.Bu durum,SQL Serverkimlik sütun. bir değer atar

    Bir sütun, kimlik sütunu için başvuran yabancı anahtar olan toplu yükleme içerirSQL Server- üretilen değerler saklanır, uygun bir şekilde yayılan bu kimlik değerlerini yabancı anahtar sütununu. toplu yükleme

    Bu değeri özellik toplu yükleme dahil tüm sütunlar için geçerlidir.Varsayılan değer TRUE olur.

    Not

    Bu özellik TRUE, olarak bırakmak için olmalıdırALTER TABLE Hedef tablo. izinleri Aksi durumda olmalıdır küme yanlış bir değer.Daha fazla bilgi için bkz:ALTER tablo (Transact-SQL).

  • KeepNulls
    İlgili öznitelik ya da alt öğe XML belgesinde eksik bir sütun için hangi değeri belirtir.Bu, bir Boole özellik.özellik olduğunda küme için boş bir sütun için değer TRUE, XML toplu yükleme atar.Bu sütunun varsayılan değeri varsa atamaz olarak küme sunucuda.Bu değeri özellik toplu yükleme dahil tüm sütunlar için geçerlidir.

    FALSE varsayılan değerdir.

  • SchemaGen
    toplu yükleme işlemi gerçekleştirmeden önce gerekli tabloları oluşturulup oluşturulmayacağını belirtir.Bu, bir Boole özellik.Bu özellik ise küme, TRUE olarak tanımlanan eşleme şemada tablolar oluşturulur (veritabanında bulunması gerekir).Tablolardan birini veya birkaçını veritabanında zaten var,SGDropTablesözellik, bu hazır tabloları bıraktı ve yeniden olup olmadığını belirler.

    The default value for the SchemaGen property is FALSE.SchemaGen does not create PRIMARY KEY constraints on the newly created tables.SchemaGen does, however, create FOREIGN KEY constraints in the database if it can find matching sql:relationship and sql:key-fields annotations in the mapping schema and if the key field consists of a single column.

    , İf Not, kümeSchemaGenözelliğini TRUE, XML toplu yükleme aşağıdakileri yapar:

    • Gerekli tabloları öðe ve öznitelik adları oluşturur.Bu nedenle, bu önemlidir, siz kullanmayınSQL Serverözel amaçlı sözcükler öðe ve öznitelik adlarının şema.

    • Verir kullanarak belirtilen herhangi bir sütun için veri taşmasql:overflow - alanxml veri türü .

  • SGDropTables
    Varolan tablolar bırakılan yeniden ve belirtir.Bu özellik,SchemaGenözellik küme doğru.IfSGDropTablesyanlış, varolan tablolar korunur.Bu özellik TRUE olduğunda, varolan Tablo silindiğinde yeniden ve.

    FALSE varsayılan değerdir.

  • SGUseID
    Özniteliği eşleme şemada, olup olmadığını belirtir olarak tanımlananidtürü, tablo oluşturulduğunda, birincil anahtar kısıtlaması oluştururken kullanılabilir.Bu özellik,SchemaGenözellik küme doğru.IfSGUseID, doğru iseSchemaGenyardımcı olan bir öznitelik kullanandt:type="id"birincil anahtar sütun olarak belirtilen ve ekler uygun PRIMARY KEY kısıtlaması oluştururken tablo.

    FALSE varsayılan değerdir.

  • TempFilePath
    Burada işlenen toplu yükleme geçici dosyaları XML Bulk yükü oluşturur dosya yolunu belirtir.(This Property is useful only when the Transaction Property is küme to TRUE.) Size, SQL ServerXML toplu yükleme için kullanılan hesabı bulunan bu yol erişimi olması gerekir Bu özellik yoksa küme, XML toplu yükleme geçici dosyaları TEMP ortam değişkeninde belirtilen konumda depolanır.

  • Transaction
    Bulk Load bir hareket olarak yapılması gerektiğini mi durumda toplu yükleme başarısız olursa geri alma garantili olmadığı belirtir.Bu, bir Boole özellik.özellik ise küme, TRUE olarak bir işlem bağlamında Bulk Load oluşur.The TempFilePath property is useful only when Transaction is set to TRUE.

    Not

    İkili veriler yüklüyorsanız (örneğin bin.hex, bin.base64 XML veri türleri için ikili, görüntü SQL Serververi türleri),Transactionözellik FALSE. ayarlanmalıdır

    FALSE varsayılan değerdir.

  • XMLFragment
    Kaynak verileri bir XML parçası olup olmadığını belirtir.Bir XML parçası olmayan tek bir XML belgesiyle olan üst düzey (kök) öğesi.Bu, bir Boole özellik.Kaynak dosyayı bir XML parçası oluşuyorsa, bu özellik TRUE olarak küme olması gerekir.

    FALSE varsayılan değerdir.