SqlBulkCopyColumnOrderHint 클래스

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

테이블의 클러스터형 인덱스에 따라 인스턴스의 대상 테이블에 있는 SqlBulkCopy 열의 정렬 순서를 정의합니다.

public ref class SqlBulkCopyColumnOrderHint sealed

public sealed class SqlBulkCopyColumnOrderHint

type SqlBulkCopyColumnOrderHint = class

Public NotInheritable Class SqlBulkCopyColumnOrderHint

상속

Object

SqlBulkCopyColumnOrderHint

예제

다음 예제에서는 AdventureWorks 샘플 데이터베이스의 원본 테이블에서 동일한 데이터베이스의 대상 테이블로 데이터를 대량 복사합니다. SqlBulkCopyColumnOrderHint 개체는 ProductNumber 대상 열의 정렬 순서를 정의하는 데 사용됩니다.

중요

이 샘플은 가져올 대량 복사 샘플 설정에 설명된 대로 작업 테이블을 만들지 않은 경우 실행되지 않습니다. 이 코드는 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.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();

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

                // Setup an order hint for the ProductNumber column.
                SqlBulkCopyColumnOrderHint hintNumber =
                    new SqlBulkCopyColumnOrderHint("ProductNumber", SortOrder.Ascending);
                bulkCopy.ColumnOrderHints.Add(hintNumber);

                // 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;";
    }
}

설명

열 순서 힌트는 대상 테이블의 열 정렬 순서를 정의합니다.

가져오는 데이터가 테이블의 클러스터형 인덱스(있는 경우)에 따라 정렬되면 SqlBulkCopy의 성능이 향상됩니다. 데이터가 클러스터형 인덱스 키의 순서와 다른 순서로 정렬되거나 테이블에 클러스터형 인덱스가 없는 경우 순서 힌트는 무시됩니다.

대상 테이블의 열 수에 대한 순서 힌트를 지정할 수 있습니다. 기본적으로 대량 삽입 작업은 힌트가 제공되지 않으면 데이터의 순서가 지정되지 않은 것으로 가정합니다.

지정한 열 이름은 대상 테이블에서 올바른 열 이름이어야 합니다. 힌트를 지정할 수 있는 순서는 임의입니다. 단일 열 이름을 두 번 이상 지정할 수 없습니다.

컬렉션이 ColumnMappings 비어 있지 않으면 매핑된 유효한 대상 열에 대해서만 주문 힌트를 제공할 수 있습니다.

SortOrder 지정되지 않은 의 가 지정되지 않은 경우 가 ArgumentException throw됩니다.

생성자

SqlBulkCopyColumnOrderHint(String, SortOrder)

지정된 대상 열에 대한 새 열 순서 힌트를 만듭니다.

속성

Column	힌트가 제공되는 대상 테이블의 대상 열 이름입니다.
SortOrder	대상 테이블의 대상 열 정렬 순서입니다.