Język

Operacje pojedynczego kopiowania zbiorczego

Najprostszym podejściem do wykonywania operacji kopiowania zbiorczego programu SQL Server jest wykonanie pojedynczej operacji względem bazy danych. Domyślnie operacja kopiowania zbiorczego jest wykonywana jako operacja izolowana: operacja kopiowania odbywa się bez użycia transakcji, bez możliwości jej wycofania.

Uwaga

Aby wycofać transakcję dla całej kopii zbiorczej lub jej części po wystąpieniu błędu, określ SqlBulkCopyOptions.UseInternalTransaction dla transakcji wsadowych lub wykonaj kopię w ramach istniejącej transakcji. SqlBulkCopy działa również z System.Transactions, jeśli połączenie jest niejawnie lub jawnie dołączone do transakcji.

Aby uzyskać więcej informacji, zobacz Operacje transakcji i kopiowania zbiorczego.

Ogólne kroki wykonywania operacji kopiowania zbiorczego są następujące:

  1. Połącz się z serwerem źródłowym i uzyskaj dane do skopiowania. Dane mogą również pochodzić z innych źródeł, jeśli można je pobrać z IDataReader obiektu lub DataTable .

  2. Połącz się z serwerem docelowym (chyba że chcesz, aby SqlBulkCopy nawiązał połączenie za Ciebie).

  3. SqlBulkCopy Utwórz obiekt i ustaw niezbędne właściwości.

  4. DestinationTableName Ustaw właściwość , aby wskazać tabelę docelową dla operacji wstawiania zbiorczego.

  5. Wywołaj jedną z metod WriteToServer.

  6. Opcjonalnie zaktualizuj właściwości i wywołaj WriteToServer je ponownie w razie potrzeby.

  7. Wywołaj Close lub opakuj operacje kopiowania zbiorczego za pomocą instrukcji Using.

Uwaga

Użyj pasujących typów danych źródłowych i docelowych kolumn. Jeśli typy nie są zgodne, SqlBulkCopy próbuje przekonwertować każdą wartość źródłową na docelowy typ danych przy użyciu reguł dla elementu Value. Konwersje mogą mieć wpływ na wydajność i powodować nieoczekiwane błędy. Na przykład konwersja z Double na Decimal może zakończyć się niepowodzeniem dla niektórych wartości.

Przykład

Poniższa aplikacja konsolowa pokazuje, jak załadować dane za pomocą klasy SqlBulkCopy. W przykładzie użyto elementu SqlDataReader , aby skopiować dane z Production.Product bazy danych SQL Server AdventureWorks do podobnej tabeli w tej samej bazie danych.

Ważne

Przed uruchomieniem tego przykładu utwórz tabele robocze opisane w sekcji Konfiguracja przykładu kopiowania zbiorczego. W przykładzie pokazano składnię SqlBulkCopy . Jeśli tabele źródłowe i docelowe znajdują się w tym samym wystąpieniu SQL Server, użyj instrukcji Transact-SQL (T-SQL) INSERT ... SELECT w celu szybszego kopiowania.

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

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

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

        // Open the destination connection. In the real world you would
        // not use SqlBulkCopy to move data from one table to the other
        // in the same database. This is for demonstration purposes only.
        using (SqlConnection destinationConnection =
                   new(connectionString))
        {
            destinationConnection.Open();

            // Set up the bulk copy object.
            // Note that the column positions in the source
            // data reader match the column positions in
            // the destination table so there is no need to
            // map columns.
            using (SqlBulkCopy bulkCopy =
                       new(destinationConnection))
            {
                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 = Convert.ToInt32(
                commandRowCount.ExecuteScalar());
            Console.WriteLine($"Ending row count = {countEnd}");
            Console.WriteLine($"{countEnd - countStart} rows were added.");
            Console.WriteLine("Press Enter to finish.");
            Console.ReadLine();
        }
    }
}
Imports Microsoft.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 New SqlCommand( _
               "SELECT ProductID, Name, ProductNumber " & _
               "FROM Production.Product;", sourceConnection)
            Dim reader As SqlDataReader = commandSourceData.ExecuteReader

            ' Open the destination connection. In the real world you would
            ' not use SqlBulkCopy to move data from one table to the other
            ' in the same database. This is for demonstration purposes only.
            Using destinationConnection As SqlConnection = _
                New SqlConnection(connectionString)
                destinationConnection.Open()

                ' Set up the bulk copy object.
                ' The column positions in the source data reader
                ' match the column positions in the destination table,
                ' so there is no need to map columns.
                Using bulkCopy As SqlBulkCopy = _
                  New SqlBulkCopy(destinationConnection)
                    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 Using
    End Sub

    Private Function GetConnectionString() As String
        Throw New NotImplementedException()
    End Function
End Module

Wykonywanie operacji kopiowania zbiorczego przy użyciu języka Transact-SQL i klasy poleceń

Poniższy przykład ilustruje sposób użycia ExecuteNonQuery metody do wykonania instrukcji BULK INSERT .

Uwaga

Ścieżka pliku dla źródła danych jest względna względem serwera. Proces serwera musi mieć dostęp do tej ścieżki, aby operacja kopiowania zbiorczego powiodła się.

Using connection As SqlConnection = New SqlConnection(connectionString)
Dim queryString As String = _
    "BULK INSERT Northwind.dbo.[Order Details] FROM " & _
    "'f:\mydata\data.tbl' WITH (FORMATFILE='f:\mydata\data.fmt' )"
connection.Open()
Dim command As New SqlCommand(queryString, connection)

command.ExecuteNonQuery()
End Using
using (SqlConnection connection = new SqlConnection(connectionString))
{
string queryString =  "BULK INSERT Northwind.dbo.[Order Details] " +
    @"FROM 'f:\mydata\data.tbl' " +
    @"WITH ( FORMATFILE='f:\mydata\data.fmt' )";
connection.Open();
SqlCommand command = new SqlCommand(queryString, connection);

command.ExecuteNonQuery();
}

Zobacz też