SqlBulkCopyColumnMapping 클래스

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

SqlBulkCopy 인스턴스의 데이터 소스에 있는 열과 해당 인스턴스의 대상 테이블에 있는 열 사이의 매핑을 정의합니다.

public ref class SqlBulkCopyColumnMapping sealed

public sealed class SqlBulkCopyColumnMapping

type SqlBulkCopyColumnMapping = class

Public NotInheritable Class SqlBulkCopyColumnMapping

상속

Object

SqlBulkCopyColumnMapping

예제

다음 예제에서는 AdventureWorks 샘플 데이터베이스의 원본 테이블에서 동일한 데이터베이스의 대상 테이블로 데이터를 대량 복사합니다. 대상의 열 수가 원본의 열 수와 일치하고 각 대상 열이 해당 원본 열과 동일한 서수 위치에 있지만 열 이름은 일치하지 않습니다. SqlBulkCopyColumnMapping 개체는 대량 복사에 대한 열 맵을 만드는 데 사용됩니다.

중요

이 샘플은 가져올 대량 복사 샘플 설정에 설명된 대로 작업 테이블을 만들지 않은 경우 실행되지 않습니다. 이 코드는 SqlBulkCopy를 사용하는 구문을 보여 주는 용도로 제공됩니다. 원본 테이블과 대상 테이블이 동일한 SQL Server 인스턴스에 있는 경우 Transact-SQL INSERT … SELECT 문을 사용하여 데이터를 복사하는 것이 더 쉽고 빠릅니다.

using System;
using System.Data;
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.BulkCopyDemoDifferentColumns;",
                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();

            // Set up the bulk copy object.
            using (SqlBulkCopy bulkCopy =
                       new SqlBulkCopy(connectionString))
            {
                bulkCopy.DestinationTableName =
                    "dbo.BulkCopyDemoDifferentColumns";

                // Set up the column mappings by name.
                SqlBulkCopyColumnMapping mapID =
                    new SqlBulkCopyColumnMapping("ProductID", "ProdID");
                bulkCopy.ColumnMappings.Add(mapID);

                SqlBulkCopyColumnMapping mapName =
                    new SqlBulkCopyColumnMapping("Name", "ProdName");
                bulkCopy.ColumnMappings.Add(mapName);

                SqlBulkCopyColumnMapping mapNumber =
                    new SqlBulkCopyColumnMapping("ProductNumber", "ProdNum");
                bulkCopy.ColumnMappings.Add(mapNumber);

                // Write from the source to the destination.
                try
                {
                    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;";
    }
}

설명

열 매핑은 데이터 원본과 대상 테이블 간의 매핑을 정의합니다.

매핑이 정의되지 않은 경우( 즉, 컬렉션이 ColumnMappings 비어 있음) 열은 서수 위치에 따라 암시적으로 매핑됩니다. 이렇게 하려면 원본 및 대상 스키마가 일치해야 합니다. 그렇지 않으면 이 InvalidOperationException throw됩니다.

컬렉션이 ColumnMappings 비어 있지 않으면 데이터 원본에 있는 모든 열을 지정해야 하는 것은 아닙니다. 컬렉션에서 매핑되지 않은 항목은 무시됩니다.

원본 및 대상 열은 이름이나 서수로 나타낼 수 있습니다. 동일한 매핑 컬렉션에서 이름별 및 서수 열 참조를 혼합할 수도 있습니다.

생성자

SqlBulkCopyColumnMapping()	새 SqlBulkCopyColumnMapping 개체를 초기화하는 매개 변수가 없는 생성자입니다.
SqlBulkCopyColumnMapping(Int32, Int32)	소스 및 대상 열을 참조하는 열 서수를 사용하여 새 열 매핑을 만듭니다.
SqlBulkCopyColumnMapping(Int32, String)	대상 열에 대한 열 이름과 소스 열을 참조하는 열 서수를 사용하여 새 열 매핑을 만듭니다.
SqlBulkCopyColumnMapping(String, Int32)	대상 열에 대한 열 서수와 소스 열을 참조하는 열 이름을 사용하여 새 열 매핑을 만듭니다.
SqlBulkCopyColumnMapping(String, String)	소스 및 대상 열을 참조하는 열 이름을 사용하여 새 열 매핑을 만듭니다.

속성

DestinationColumn	대상 데이터베이스 테이블에서 매핑되는 열의 이름입니다.
DestinationOrdinal	대상 테이블 내에 있는 대상 열의 서수 값입니다.
SourceColumn	데이터 소스에서 매핑되는 열의 이름입니다.
SourceOrdinal	데이터 소스 내에 있는 소스 열의 위치입니다.