Поделиться через


SqlBulkCopyOptions Перечисление

Определение

Побитовый флаг, который определяет один или несколько параметров для использования с экземпляром SqlBulkCopy.

Это перечисление поддерживает побитовую комбинацию значений его членов.

public enum class SqlBulkCopyOptions
[System.Flags]
public enum SqlBulkCopyOptions
[<System.Flags>]
type SqlBulkCopyOptions = 
Public Enum SqlBulkCopyOptions
Наследование
SqlBulkCopyOptions
Атрибуты

Поля

AllowEncryptedValueModifications 64

Если этот параметр указан, AllowEncryptedValueModifications позволяет выполнять массовое копирование зашифрованных данных между таблицами или базами данных без расшифровки данных. Как правило, приложение выбирает данные из зашифрованных столбцов в одной таблице, не расшифровывая их (для подключения к базе данных используется ключевое слово Column Encryption Setting со значением Disabled), а затем с помощью этого параметра выполняет массовую вставку данных, которые по-прежнему зашифрованы. Дополнительные сведения см. в разделе Постоянное шифрование.

Будьте внимательны при указании AllowEncryptedValueModifications, так как это может привести к повреждению базы данных, так как драйвер не проверка, действительно ли данные зашифрованы или правильно зашифрованы с использованием того же типа шифрования, алгоритма и ключа, что и целевой столбец.

CheckConstraints 2

Проверка ограничений при вставке данных. По умолчанию ограничения не проверяются.

Default 0

Для всех параметров используйте значения по умолчанию.

FireTriggers 16

Если этот параметр указан, сервер выполняет триггеры вставки для строк, вставляемых в базу данных.

KeepIdentity 1

Сохранять идентификационные значения источника. Если не указаны, значения идентификаторов назначаются целевым объектом.

KeepNulls 8

Сохранять значения null в целевой таблице независимо от значений параметров по умолчанию. Если не указано, значения NULL заменяются значениями по умолчанию там, где это применимо.

TableLock 4

Применить блокировку массового обновления на время операции массового копирования. Если не указано, используются блокировки строк.

UseInternalTransaction 32

Если этот параметр указан, каждый пакет операции массового копирования будет выполняться в рамках транзакции. Если указать этот параметр, а также предоставить объект SqlTransaction в конструктор, возникнет ArgumentException.

Примеры

В следующем консольном приложении показано, как выполнить массовую загрузку, которая копирует значение из столбца идентификаторов исходной таблицы в соответствующий столбец целевой таблицы вместо создания нового значения для столбца идентификаторов каждой строки.

Чтобы узнать, как параметр изменяет способ работы массовой загрузки, запустите пример с помощью dbo. Таблица BulkCopyDemoMatchingColumns пуста. Все строки загружают из источника. Затем снова запустите пример, не очищая таблицу. Возникает исключение, и код записывает в окно консоли сообщение о том, что строки не были добавлены из-за нарушений первичного ключа.

Важно!

Этот пример не будет выполняться, если вы не создали рабочие таблицы, как описано в разделе Пример установки массового копирования. Этот код предназначен только для демонстрации синтаксиса использования SqlBulkCopy. Если исходная и целевая таблицы находятся в одном экземпляре SQL Server, проще и быстрее использовать инструкцию Transact-SQL INSERT … SELECT для копирования данных.

using System.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;";
    }
}
Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Dim connectionString As String = GetConnectionString()

        ' Open a connection to the AdventureWorks database.
        Using sourceConnection As SqlConnection = _
           New SqlConnection(connectionString)
            sourceConnection.Open()

            ' Perform an initial count on the destination table.
            Dim commandRowCount As New SqlCommand( _
            "SELECT COUNT(*) FROM dbo.BulkCopyDemoMatchingColumns;", _
                sourceConnection)
            Dim countStart As Long = _
               System.Convert.ToInt32(commandRowCount.ExecuteScalar())
            Console.WriteLine("Starting row count = {0}", countStart)

            ' Get data from the source table as a SqlDataReader.
            Dim commandSourceData As SqlCommand = New SqlCommand( _
               "SELECT ProductID, Name, ProductNumber " & _
               "FROM Production.Product;", sourceConnection)
            Dim reader As SqlDataReader = 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 bulkCopy As SqlBulkCopy = _
              New SqlBulkCopy(connectionString, SqlBulkCopyOptions.KeepIdentity)
                bulkCopy.DestinationTableName = "dbo.BulkCopyDemoMatchingColumns"

                Try
                    ' Write from the source to the destination.
                    bulkCopy.WriteToServer(reader)

                Catch ex As Exception
                    Console.WriteLine(ex.Message)

                    Finally
                        ' Close the SqlDataReader. The SqlBulkCopy
                        ' object is automatically closed at the end
                        ' of the Using block.
                        reader.Close()
                End Try
            End Using

            ' Perform a final count on the destination table
            ' to see how many rows were added.
            Dim countEnd As Long = _
                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()
        End Using
    End Sub

    Private Function GetConnectionString() As String
        ' 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;"
    End Function
End Module

Комментарии

Перечисление SqlBulkCopyOptions можно использовать при создании экземпляра SqlBulkCopy , чтобы изменить WriteToServer поведение методов для этого экземпляра.

Применяется к

См. также раздел