SqlBulkCopy 생성자

참조

정의

네임스페이스:: Microsoft.Data.SqlClient

어셈블리:: Microsoft.Data.SqlClient.dll

패키지:: Microsoft.Data.SqlClient v1.0.19269.1

패키지:: Microsoft.Data.SqlClient v1.1.4

패키지:: Microsoft.Data.SqlClient v2.0.1

패키지:: Microsoft.Data.SqlClient v2.1.4

패키지:: Microsoft.Data.SqlClient v3.0.1

패키지:: Microsoft.Data.SqlClient v3.1.0

패키지:: Microsoft.Data.SqlClient v4.0.1

패키지:: Microsoft.Data.SqlClient v4.1.0

패키지:: Microsoft.Data.SqlClient v5.0.0

패키지:: Microsoft.Data.SqlClient v5.1.0

패키지:: Microsoft.Data.SqlClient v5.2.0

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

SqlBulkCopy(SqlConnection)	의 지정된 열린 인스턴스를 사용하여 클래스의 SqlBulkCopy 새 인스턴스를 초기화합니다 SqlConnection .
SqlBulkCopy(String)	제공된 에 따라 의 SqlConnection 새 인스턴스를 초기화하고 엽니다.`connectionString` . 생성자는 SqlConnection을 사용하여 SqlBulkCopy 클래스의 새 인스턴스를 초기화합니다.
SqlBulkCopy(String, SqlBulkCopyOptions)	제공된 에 따라 의 SqlConnection 새 인스턴스를 초기화하고 엽니다.`connectionString` . 이 생성자는 SqlConnection을 사용하여 SqlBulkCopy 클래스의 새 인스턴스를 초기화합니다. 인스턴스는 SqlConnection 에 제공된 옵션에 따라 동작합니다.`copyOptions` 매개 변수와 함께 사용할 여러 매개 변수 값 세트의 시퀀스입니다.
SqlBulkCopy(SqlConnection, SqlBulkCopyOptions, SqlTransaction)	의 제공된 기존 열린 인스턴스를 SqlBulkCopy 사용하여 클래스의 새 인스턴스를 초기화합니다 SqlConnection . 인스턴스는 SqlBulkCopy 에 제공된 옵션에 따라 동작합니다.`copyOptions` 매개 변수와 함께 사용할 여러 매개 변수 값 세트의 시퀀스입니다. 제공된 SqlTransaction이 null이 아니면 복사 작업이 해당 트랜잭션 내에서 수행됩니다.

SqlBulkCopy(SqlConnection)

의 지정된 열린 인스턴스를 사용하여 클래스의 SqlBulkCopy 새 인스턴스를 초기화합니다 SqlConnection .

public:
 SqlBulkCopy(Microsoft::Data::SqlClient::SqlConnection ^ connection);

public SqlBulkCopy (Microsoft.Data.SqlClient.SqlConnection connection);

new Microsoft.Data.SqlClient.SqlBulkCopy : Microsoft.Data.SqlClient.SqlConnection -> Microsoft.Data.SqlClient.SqlBulkCopy

Public Sub New (connection As SqlConnection)

매개 변수

connection: SqlConnection

대량 복사 작업을 수행하는 데 사용할 이미 열려 있는 SqlConnection 인스턴스입니다. 연결 문자열이 사용하지 않는 경우Integrated Security = true 를 사용하여 SqlCredential 연결 문자열에서 사용자 ID 및 암호를 텍스트로 지정하는 것보다 사용자 ID 및 암호를 더 안전하게 전달할 수 있습니다.

예제

다음 콘솔 애플리케이션 데이터 대량 로드는 이미 열려 있는 연결을 사용 하는 방법에 설명 합니다. 이 예제에서는 SqlDataReader를 사용하여 SQL Server AdventureWorks 데이터베이스에 있는 Production.Product 테이블의 데이터를 같은 데이터베이스의 비슷한 테이블로 복사합니다. 이 예제는 예시용입니다. 사용 하지 않을 SqlBulkCopy 프로덕션 애플리케이션에서 동일한 데이터베이스에서 다른 한 테이블에서 데이터를 이동 하 합니다. 원본 데이터는 SQL Server 배치할 필요가 없습니다. 에 읽 IDataReader 거나 로 로드할 수 있는 모든 데이터 원본을 DataTable사용할 수 있습니다.

중요

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

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();

            // 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 SqlConnection(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 SqlBulkCopy(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 = 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 연결이 이미 열려 있으므로 인스턴스가 닫힌 후에도 SqlBulkCopy 연결이 열린 상태로 유지됩니다. 인수가 connection null이면 이 ArgumentNullException throw됩니다.

적용 대상

SqlBulkCopy(String)

제공된 에 따라 의 SqlConnection 새 인스턴스를 초기화하고 엽니다.connectionString . 생성자는 SqlConnection을 사용하여 SqlBulkCopy 클래스의 새 인스턴스를 초기화합니다.

public:
 SqlBulkCopy(System::String ^ connectionString);

public SqlBulkCopy (string connectionString);

new Microsoft.Data.SqlClient.SqlBulkCopy : string -> Microsoft.Data.SqlClient.SqlBulkCopy

Public Sub New (connectionString As String)

매개 변수

connectionString: String

SqlBulkCopy 인스턴스에서 사용하기 위해 열리는 연결을 정의하는 문자열입니다. 연결 문자열이 사용하지 않는 경우Integrated Security = true, 또는 를 SqlBulkCopy(SqlConnection, SqlBulkCopyOptions, SqlTransaction)SqlCredential 사용하여 SqlBulkCopy(SqlConnection) 연결 문자열에서 사용자 ID 및 암호를 텍스트로 지정하는 것보다 사용자 ID 및 암호를 더 안전하게 전달할 수 있습니다.

예외

ArgumentException

가 빈 문자열이면 connectionString 이 ArgumentException throw됩니다.

예제

다음 콘솔 애플리케이션에는 문자열로 지정 된 연결을 사용 하 여 데이터 대량 로드 하는 방법을 보여 줍니다. 인스턴스가 닫히면 연결이 SqlBulkCopy 자동으로 닫힙니다. 이 예제에서 원본 데이터는 먼저 SQL Server 테이블에서 인스턴스로 SqlDataReader 읽습니다. 원본 데이터는 SQL Server 위치할 필요가 없습니다. 에 읽 IDataReader 거나 로 로드할 수 있는 모든 데이터 원본을 DataTable사용할 수 있습니다.

중요

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 a connection string. 
            // 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))
            {
                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;";
    }
}

설명

대량 복사 작업이 끝나면 연결이 자동으로 닫힙니다. 가 null이면 connectionString 이 ArgumentNullException throw됩니다. 가 빈 문자열이면 connectionString 이 ArgumentException throw됩니다.

적용 대상

SqlBulkCopy(String, SqlBulkCopyOptions)

제공된 에 따라 의 SqlConnection 새 인스턴스를 초기화하고 엽니다.connectionString . 이 생성자는 SqlConnection을 사용하여 SqlBulkCopy 클래스의 새 인스턴스를 초기화합니다. 인스턴스는 SqlConnection 에 제공된 옵션에 따라 동작합니다.copyOptions 매개 변수와 함께 사용할 여러 매개 변수 값 세트의 시퀀스입니다.

public:
 SqlBulkCopy(System::String ^ connectionString, Microsoft::Data::SqlClient::SqlBulkCopyOptions copyOptions);

public SqlBulkCopy (string connectionString, Microsoft.Data.SqlClient.SqlBulkCopyOptions copyOptions);

new Microsoft.Data.SqlClient.SqlBulkCopy : string * Microsoft.Data.SqlClient.SqlBulkCopyOptions -> Microsoft.Data.SqlClient.SqlBulkCopy

Public Sub New (connectionString As String, copyOptions As SqlBulkCopyOptions)

매개 변수

connectionString: String

copyOptions: SqlBulkCopyOptions

대상 테이블에 복사되는 데이터 소스 행을 결정하는 SqlBulkCopyOptions 열거형의 값 조합입니다.

예제

다음 콘솔 애플리케이션에는 문자열로 지정 된 연결을 사용 하 여 대량 로드를 수행 하는 방법을 보여 줍니다. 대상 테이블을 로드할 때 원본 테이블의 ID 열에 있는 값을 사용하도록 옵션이 설정됩니다. 이 예제에서 원본 데이터는 먼저 SQL Server 테이블에서 인스턴스로 SqlDataReader 읽습니다. 원본 테이블과 대상 테이블에는 각각 ID 열이 포함됩니다. 기본적으로 ID 열에 대한 새 값은 추가된 각 행의 대상 테이블에 생성됩니다. 이 예제에서는 대량 로드 프로세스가 원본 테이블의 ID 값을 대신 사용하도록 강제하는 연결이 열릴 때 옵션이 설정됩니다. 옵션이 대량 로드의 작동 방식을 변경하는 방법을 확인하려면 dbo를 사용하여 샘플을 실행합니다 . BulkCopyDemoMatchingColumns 테이블이 비어 있습니다 . 모든 행은 원본에서 로드됩니다. 그런 다음 테이블을 비우지 않고 샘플을 다시 실행합니다. 예외가 throw되고 코드는 기본 키 제약 조건 위반으로 인해 행이 추가되지 않았음을 알리는 메시지를 콘솔에 씁니다.

중요

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

설명

항목의 모든 대량 복사 옵션 SqlBulkCopyOptions 에 대한 자세한 정보를 얻을 수 있습니다.

적용 대상

SqlBulkCopy(SqlConnection, SqlBulkCopyOptions, SqlTransaction)

의 제공된 기존 열린 인스턴스를 SqlBulkCopy 사용하여 클래스의 새 인스턴스를 초기화합니다 SqlConnection . 인스턴스는 SqlBulkCopy 에 제공된 옵션에 따라 동작합니다.copyOptions 매개 변수와 함께 사용할 여러 매개 변수 값 세트의 시퀀스입니다. 제공된 SqlTransaction이 null이 아니면 복사 작업이 해당 트랜잭션 내에서 수행됩니다.

public:
 SqlBulkCopy(Microsoft::Data::SqlClient::SqlConnection ^ connection, Microsoft::Data::SqlClient::SqlBulkCopyOptions copyOptions, Microsoft::Data::SqlClient::SqlTransaction ^ externalTransaction);

public SqlBulkCopy (Microsoft.Data.SqlClient.SqlConnection connection, Microsoft.Data.SqlClient.SqlBulkCopyOptions copyOptions, Microsoft.Data.SqlClient.SqlTransaction externalTransaction);

new Microsoft.Data.SqlClient.SqlBulkCopy : Microsoft.Data.SqlClient.SqlConnection * Microsoft.Data.SqlClient.SqlBulkCopyOptions * Microsoft.Data.SqlClient.SqlTransaction -> Microsoft.Data.SqlClient.SqlBulkCopy

Public Sub New (connection As SqlConnection, copyOptions As SqlBulkCopyOptions, externalTransaction As SqlTransaction)

매개 변수

connection: SqlConnection

copyOptions: SqlBulkCopyOptions

대상 테이블에 복사되는 데이터 소스 행을 결정하는 SqlBulkCopyOptions 열거형의 값 조합입니다.

externalTransaction: SqlTransaction

대량 복사 작업이 발생할 기존 SqlTransaction 인스턴스입니다.

설명

옵션이 포함 UseInternalTransaction 되고 인수가 externalTransaction null이 아니면 InvalidArgumentException 이 throw됩니다.

트랜잭션에서 를 사용하는 SqlBulkCopy 방법을 보여 주는 예제는 트랜잭션 및 대량 복사 작업을 참조하세요.

추가 정보

적용 대상

다음을 통해 공유

SqlBulkCopy 생성자

정의

오버로드

SqlBulkCopy(SqlConnection)

매개 변수

예제

설명

적용 대상

SqlBulkCopy(String)

매개 변수

예외

예제

설명

적용 대상

SqlBulkCopy(String, SqlBulkCopyOptions)

매개 변수

예제

설명

적용 대상

SqlBulkCopy(SqlConnection, SqlBulkCopyOptions, SqlTransaction)

매개 변수

설명

추가 정보

적용 대상

추가 리소스