SqlBulkCopyOptions 열거형

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v7.0.1

SqlBulkCopy인스턴스에 사용할 하나 이상의 옵션을 지정하는 비트 플래그입니다.

이 열거형은 멤버 값의 비트 조합을 지원합니다.

public enum class SqlBulkCopyOptions

[System.Flags]
public enum SqlBulkCopyOptions

[<System.Flags>]
type SqlBulkCopyOptions = 

Public Enum SqlBulkCopyOptions

상속

Enum

SqlBulkCopyOptions

특성

FlagsAttribute

필드

Name	값	Description
Default	0	모든 옵션에 기본값을 사용합니다.
KeepIdentity	1	소스 ID 값을 유지합니다. 지정하지 않으면 ID 값이 대상에 의해 할당됩니다.
CheckConstraints	2	데이터를 삽입하는 동안 제약 조건을 확인합니다. 기본적으로 제약 조건은 확인되지 않습니다.
TableLock	4	대량 복사 작업 기간에 대한 대량 업데이트 잠금을 획득합니다. 지정하지 않으면 행 잠금이 사용됩니다.
KeepNulls	8	기본값에 대한 설정과 관계없이 대상 테이블에서 Null 값을 유지합니다. 지정하지 않으면 null 값이 해당하는 경우 기본값으로 바뀝 있습니다.
FireTriggers	16	지정하면 서버가 데이터베이스에 삽입되는 행에 대한 삽입 트리거를 실행하도록 합니다.
UseInternalTransaction	32	지정하면 대량 복사 작업의 각 일괄 처리가 트랜잭션 내에서 발생합니다. 이 옵션을 나타내고 생성자에 ArgumentException 개체를 제공 SqlTransaction 하면 발생합니다.
AllowEncryptedValueModifications	64	지정된 경우 AllowEncryptedValueModifications 를 사용하면 데이터 암호를 해독하지 않고도 테이블 또는 데이터베이스 간에 암호화된 데이터를 대량 복사할 수 있습니다. 일반적으로 애플리케이션은 데이터를 해독하지 않고 한 테이블에서 암호화된 열을 선택한(앱은 열 암호화 설정 키워드가 사용하지 않도록 설정된 상태에서 데이터베이스에 연결함) 다음, 이 옵션을 사용하여 여전히 암호돠된 데이터를 대량 복사합니다. AllowEncryptedValueModifications를 지정할 때는 드라이버가 데이터가 실제로 암호화되었는지, 아니면 대상 열과 동일한 암호화 유형, 알고리즘 및 키를 사용하여 올바르게 암호화되었는지 확인하지 않으므로 데이터베이스가 손상될 수 있으므로 주의해야 합니다.
CacheMetadata	128	지정된 경우 CacheMetadata 는 첫 번째 대량 복사 작업 후에 대상 테이블 메타데이터를 캐시하므로 후속 작업에서 동일한 테이블에 대한 후속 작업에서 메타데이터 검색 쿼리를 건너뛸 수 있습니다. 이렇게 하면 동일한 대상 테이블에 여러 대량 복사 작업을 수행할 때 성능이 향상될 수 있습니다. 경고: 대상 테이블 스키마가 대량 복사 작업 간에 변경되지 않는 것이 확실한 경우에만 이 옵션을 사용합니다. 테이블 스키마가 변경되면(열이 추가, 제거 또는 수정됨) 캐시된 메타데이터를 사용하면 데이터 손상, 실패한 작업 또는 예기치 않은 동작이 발생할 수 있습니다. 스키마가 변경되면 캐시를 지우기 위해 호출 ClearCachedMetadata() 합니다. 캐시는 다른 테이블로 변경될 때 DestinationTableName 자동으로 무효화됩니다. 캐시된 메타데이터는 원본-대상 열 매핑이 아닌 대상 테이블 스키마만 설명하므로 작업 간을 변경 ColumnMappings 해도 캐시 무효화가 필요하지 않습니다. 연결 컨텍스트가 변경되면 캐시가 자동으로 무효화되지 않습니다. 기본 SqlConnection 이 데이터베이스를 변경하거나(예: 통해 ChangeDatabase(String)) 장애 조치(failover)로 인해 다른 서버에 다시 연결하는 경우 호출자는 호출하여 메타데이터가 새로 고쳐지도록 해야 합니다 ClearCachedMetadata() .

예제

다음 콘솔 애플리케이션은 각 행의 ID 열에 대한 새 값을 생성하는 대신 원본 테이블의 ID 열에 있는 값을 대상 테이블의 해당 열에 복사하는 대량 로드를 수행하는 방법을 보여 줍니다.

옵션이 대량 로드의 작동 방식을 변경하는 방법을 확인하려면 dbo를 사용하여 샘플을 실행합니다 . BulkCopyDemoMatchingColumns 테이블이 비어 있습니다 . 모든 행은 원본에서 로드됩니다. 다음으로, 테이블을 비우지 않고 샘플을 다시 실행합니다. 예외가 throw되고 코드는 기본 키 위반으로 인해 행이 추가되지 않았다는 메시지를 콘솔 창에 씁니다.

Important

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

namespace SqlBulkCopy_KeepIdentity;

using System;
using System.Data;
// <Snippet1>
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;";
    }
}
// </Snippet1>

설명

인스턴스를 생성할 SqlBulkCopyOptions 때 열거형을 SqlBulkCopy 사용하여 해당 인스턴스의 메서드가 WriteToServer(DbDataReader) 동작하는 방식을 변경할 수 있습니다.