SqlBulkCopyOptions Výčet

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v7.0.1

Bitový příznak, který určuje jednu nebo více možností, které se mají použít s instancí SqlBulkCopy.

Tento výčet podporuje bitové kombinace hodnot jeho členů.

public enum class SqlBulkCopyOptions

[System.Flags]
public enum SqlBulkCopyOptions

[<System.Flags>]
type SqlBulkCopyOptions = 

Public Enum SqlBulkCopyOptions

Dědičnost

Enum

SqlBulkCopyOptions

Atributy

FlagsAttribute

Pole

Name	Hodnota	Description
Default	0	Pro všechny možnosti použijte výchozí hodnoty.
KeepIdentity	1	Zachování hodnot zdrojové identity Pokud není zadáno, hodnoty identity jsou přiřazeny cílem.
CheckConstraints	2	Zkontrolujte omezení při vkládání dat. Ve výchozím nastavení nejsou omezení zaškrtnutá.
TableLock	4	Získejte zámek hromadné aktualizace po dobu trvání operace hromadného kopírování. Pokud není zadáno, použijí se zámky řádků.
KeepNulls	8	Zachovat hodnoty null v cílové tabulce bez ohledu na nastavení výchozích hodnot. Pokud nezadáte, hodnoty null se nahradí výchozími hodnotami, pokud je to možné.
FireTriggers	16	Po zadání může server aktivovat triggery vložení pro řádky vložené do databáze.
UseInternalTransaction	32	Při zadání bude každá dávka operace hromadného kopírování probíhat v rámci transakce. Pokud tuto možnost označíte a také zadáte SqlTransaction objekt konstruktoru, dojde k chybě ArgumentException .
AllowEncryptedValueModifications	64	Pokud je zadáno, AllowEncryptedValueModifications umožňuje hromadné kopírování šifrovaných dat mezi tabulkami nebo databázemi bez dešifrování dat. Aplikace obvykle vybere data ze zašifrovaných sloupců z jedné tabulky bez dešifrování dat (aplikace se připojí k databázi pomocí klíčového slova nastavení šifrování sloupce nastaveného na zakázáno) a pak by tuto možnost použila k hromadnému vložení dat, která jsou stále šifrovaná. Při zadávání AllowEncryptedValueModifications buďte opatrní, protože to může vést k poškození databáze, protože ovladač nekontroluje, jestli jsou data skutečně šifrovaná, nebo pokud jsou správně zašifrovaná pomocí stejného typu šifrování, algoritmu a klíče jako cílový sloupec.
CacheMetadata	128	Po zadání cacheMetadata ukládá do mezipaměti metadata cílové tabulky po první operaci hromadného kopírování, což umožňuje následným operacím do stejné tabulky přeskočit dotaz zjišťování metadat. To může zvýšit výkon při provádění více operací hromadného kopírování do stejné cílové tabulky. Upozornění: Tuto možnost použijte pouze v případě, že jste si jisti, že schéma cílové tabulky se mezi operacemi hromadného kopírování nezmění. Pokud se schéma tabulky změní (přidané, odebrané nebo upravené), může použití metadat uložených v mezipaměti způsobit poškození dat, neúspěšné operace nebo neočekávané chování. Voláním ClearCachedMetadata() vymažete mezipaměť, pokud se schéma změní. Mezipaměť se automaticky zneplatní, když DestinationTableName se změní na jinou tabulku. Změna ColumnMappings mezi operacemi nevyžaduje zneplatnění mezipaměti, protože metadata uložená v mezipaměti popisují pouze schéma cílové tabulky, nikoli mapování sloupců zdrojového do cíle. Mezipaměť se při změně kontextu připojení automaticky zneplatní. Pokud podkladová SqlConnection databáze změn (například prostřednictvím ChangeDatabase(String)) nebo se kvůli převzetí služeb při selhání znovu připojí k jinému serveru, volající by měli volat ClearCachedMetadata() , aby se metadata aktualizovala.

Příklady

Následující konzolová aplikace ukazuje, jak provést hromadné načtení, které zkopíruje hodnotu ve sloupci identity zdrojové tabulky do odpovídajícího sloupce v cílové tabulce místo generování nové hodnoty pro sloupec identity každého řádku.

Pokud chcete zjistit, jak tato možnost mění způsob, jakým hromadné načítání funguje, spusťte ukázku s dbo. Tabulka BulkCopyDemoMatchingColumns je prázdná. Všechny řádky se načítají ze zdroje. Potom znovu spusťte ukázku bez vyprázdnění tabulky. Vyvolá se výjimka a kód zapíše do okna konzoly zprávu s oznámením, že řádky nebyly přidány kvůli porušení primárního klíče.

Důležité

Tento příklad se nespustí, pokud jste nevytvořili pracovní tabulky, jak je popsáno v Příklad nastavení hromadného kopírování. Tento kód je k dispozici k předvedení syntaxe pouze pro použití sqlBulkCopy . Pokud jsou zdrojové a cílové tabulky ve stejné instanci SQL Serveru, je jednodušší a rychlejší použít příkaz Transact-SQL INSERT … SELECT ke zkopírování dat.

namespace SqlBulkCopy_KeepIdentity;

using System;
using System.Data;
// <Snippet1>
using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        string connectionString = GetConnectionString();
        // Open a sourceConnection to the AdventureWorks database.
        using (SqlConnection sourceConnection =
                   new SqlConnection(connectionString))
        {
            sourceConnection.Open();

            // Perform an initial count on the destination table.
            SqlCommand commandRowCount = new SqlCommand(
                "SELECT COUNT(*) FROM " +
                "dbo.BulkCopyDemoMatchingColumns;",
                sourceConnection);
            long countStart = System.Convert.ToInt32(
                commandRowCount.ExecuteScalar());
            Console.WriteLine("Starting row count = {0}", countStart);

            // Get data from the source table as a SqlDataReader.
            SqlCommand commandSourceData = new SqlCommand(
                "SELECT ProductID, Name, " +
                "ProductNumber " +
                "FROM Production.Product;", sourceConnection);
            SqlDataReader reader =
                commandSourceData.ExecuteReader();

            // Create the SqlBulkCopy object using a connection string 
            // and the KeepIdentity option. 
            // In the real world you would not use SqlBulkCopy to move
            // data from one table to the other in the same database.
            using (SqlBulkCopy bulkCopy =
                new SqlBulkCopy(connectionString, SqlBulkCopyOptions.KeepIdentity))
            {
                bulkCopy.DestinationTableName =
                    "dbo.BulkCopyDemoMatchingColumns";

                try
                {
                    // Write from the source to the destination.
                    bulkCopy.WriteToServer(reader);
                }
                catch (Exception ex)
                {
                    Console.WriteLine(ex.Message);
                }
                finally
                {
                    // Close the SqlDataReader. The SqlBulkCopy
                    // object is automatically closed at the end
                    // of the using block.
                    reader.Close();
                }
            }

            // Perform a final count on the destination 
            // table to see how many rows were added.
            long countEnd = System.Convert.ToInt32(
                commandRowCount.ExecuteScalar());
            Console.WriteLine("Ending row count = {0}", countEnd);
            Console.WriteLine("{0} rows were added.", countEnd - countStart);
            Console.WriteLine("Press Enter to finish.");
            Console.ReadLine();
        }
    }

    private static string GetConnectionString()
    // To avoid storing the sourceConnection string in your code, 
    // you can retrieve it from a configuration file. 
    {
        return "Data Source=(local); " +
            " Integrated Security=true;" +
            "Initial Catalog=AdventureWorks;";
    }
}
// </Snippet1>

Poznámky

Výčet SqlBulkCopyOptions můžete použít při vytváření SqlBulkCopy instance ke změně způsobu WriteToServer(DbDataReader) chování metod pro danou instanci.