다음을 통해 공유


DataAdapter를 사용하여 일괄 작업 수행

적용 대상: .NET Framework .NET .NET Standard

ADO.NET 다운로드

ADO.NET의 배치 지원을 사용하면 DataAdapter를 통해 INSERT, UPDATE 및 DELETE 작업을 한 번에 하나씩 보내지 않고 DataSet 또는 DataTable에서 서버로 그룹화할 수 있습니다. 서버로의 라운드트립 횟수가 줄어들면 일반적으로 성능이 크게 개선됩니다. 일괄 업데이트는 SQL Server(Microsoft.Data.SqlClient)용 Microsoft SqlClient 데이터 공급자에 대해 지원됩니다.

이전 버전의 ADO.NET에서는 데이터베이스를 DataSet의 변경 내용으로 업데이트하는 경우 UpdateDataAdapter 메서드에서 데이터베이스에 대해 한 번에 한 행씩 업데이트를 수행했습니다. 또한 지정한 DataTable의 행에서 반복될 때 수정되었는지 여부를 확인하기 위해 각 DataRow를 검사했습니다. 행이 수정된 경우에는 해당 행의 UpdateCommand 속성 값에 따라 적절한 InsertCommand, DeleteCommand 또는 RowState를 호출했습니다. 그리고 행을 업데이트할 때마다 데이터베이스에 대한 네트워크 라운드트립이 수반되었습니다.

SQL Server용 Microsoft SqlClient 데이터 공급자에서 SqlDataAdapterUpdateBatchSize 속성을 공개합니다. UpdateBatchSize를 양의 정수 값으로 설정하면 데이터베이스에 대한 업데이트가 지정된 크기의 배치로 전송됩니다. 예를 들어 UpdateBatchSize를 10으로 설정하면 10개의 개별적인 문을 그룹화하여 하나의 배치로 제출합니다. UpdateBatchSize를 0으로 설정하면 SqlDataAdapter가 서버에서 처리할 수 있는 최대 배치 크기를 사용합니다. 1로 설정할 경우에는 행이 한 번에 하나씩 전송되므로 배치 업데이트를 사용할 수 없습니다.

참고 항목

매우 큰 일괄 처리를 실행하면 성능이 저하될 수 있습니다. 따라서 애플리케이션을 구현하기 전에 최적의 배치 크기 설정을 테스트해야 합니다.

UpdateBatchSize 속성 사용

배치 업데이트를 사용할 수 있을 때는 DataAdapter UpdatedRowSource, UpdateCommandInsertCommandDeleteCommand 속성 값을 None 또는 OutputParameters로 설정해야 합니다. 배치 업데이트를 수행하는 경우 명령의 UpdatedRowSource 속성 값 FirstReturnedRecord 또는 Both는 유효하지 않습니다.

다음 프로시저에서는 UpdateBatchSize 속성을 사용하는 방법을 보여 줍니다. 이 프로시저에서는 Production.ProductCategory 테이블의 ProductCategoryIDName 필드를 표시하는 열이 포함된 DataSet 개체와 배치 크기를 나타내는 정수(배치의 행 개수) 등 두 가지 인수를 사용합니다. 이 코드에서는 SqlDataAdapter, UpdateCommandInsertCommand 속성을 설정하여 새 DeleteCommand 개체를 만듭니다. 또한 DataSet 개체에 수정된 행이 있다고 가정합니다. 그리고 UpdateBatchSize 속성을 설정한 다음 업데이트를 실행합니다.

public static void BatchUpdate(DataTable dataTable, Int32 batchSize)
{
    // Assumes GetConnectionString() returns a valid connection string.
    string connectionString = GetConnectionString();

    // Connect to the AdventureWorks database.
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        // Create a SqlDataAdapter.  
        SqlDataAdapter adapter = new SqlDataAdapter();

        // Set the UPDATE command and parameters.  
        adapter.UpdateCommand = new SqlCommand(
            "UPDATE Production.ProductCategory SET "
            + "Name=@Name WHERE ProductCategoryID=@ProdCatID;",
            connection);
        adapter.UpdateCommand.Parameters.Add("@Name",
        SqlDbType.NVarChar, 50, "Name");
        adapter.UpdateCommand.Parameters.Add("@ProdCatID",
        SqlDbType.Int, 4, "ProductCategoryID");
        adapter.UpdateCommand.UpdatedRowSource = UpdateRowSource.None;

        // Set the INSERT command and parameter.  
        adapter.InsertCommand = new SqlCommand(
            "INSERT INTO Production.ProductCategory (Name) VALUES (@Name);",
            connection);
        adapter.InsertCommand.Parameters.Add("@Name",
        SqlDbType.NVarChar, 50, "Name");
        adapter.InsertCommand.UpdatedRowSource = UpdateRowSource.None;

        // Set the DELETE command and parameter.  
        adapter.DeleteCommand = new SqlCommand(
            "DELETE FROM Production.ProductCategory "
            + "WHERE ProductCategoryID=@ProdCatID;", connection);
        adapter.DeleteCommand.Parameters.Add("@ProdCatID",
        SqlDbType.Int, 4, "ProductCategoryID");
        adapter.DeleteCommand.UpdatedRowSource = UpdateRowSource.None;

        // Set the batch size.  
        adapter.UpdateBatchSize = batchSize;

        // Execute the update.  
        adapter.Update(dataTable);
    }
}

DataAdapter에는 업데이트 관련 이벤트인 RowUpdatingRowUpdated가 있습니다. 자세한 내용은 DataAdapter 이벤트 처리를 참조하세요.

배치 업데이트에 따른 이벤트 동작 변경

일괄 처리가 활성화되면 한 번의 데이터베이스 동작으로 여러 개의 행이 업데이트됩니다. 따라서 RowUpdated 이벤트는 배치마다 한 번씩만 발생하지만 RowUpdating 이벤트는 행이 처리될 때마다 발생합니다. 일괄 처리가 비활성화되면 일대일 인터리빙으로 두 개의 이벤트가 발생합니다. 이 경우 RowUpdating 이벤트 하나와 RowUpdated 이벤트 하나가 한 행에 대해 발생한 후 모든 행이 처리될 때까지 RowUpdatingRowUpdated 이벤트가 다음 행에 대해 하나씩 발생합니다.

업데이트된 행에 액세스

일괄 처리가 비활성화되면 Row 클래스의 RowUpdatedEventArgs 속성을 사용하여 업데이트되는 행에 액세스할 수 있습니다.

일괄 처리가 활성화되면 여러 행에 대해 하나의 RowUpdated 이벤트가 생성됩니다. 따라서 각 행에 대한 Row 속성 값은 null입니다. RowUpdating 이벤트는 계속해서 각 행에 대해 생성됩니다. CopyToRows 클래스의 RowUpdatedEventArgs 메서드를 사용하면 행에 대한 참조를 배열에 복사하여 처리된 행에 액세스할 수 있습니다. 처리 중인 행이 없으면 CopyToRows에서 ArgumentNullException이 throw됩니다. RowCount 메서드를 호출하기 전에 CopyToRows 속성을 사용하여 처리된 행 수를 반환합니다.

데이터 오류 처리

배치를 실행하면 각각의 개별 문을 실행하는 것과 동일한 효과가 나타납니다. 문은 배치에 추가된 순서대로 실행됩니다. 오류는 배치 모드가 비활성화되어 있는 상태와 동일하게 처리됩니다. 행은 각각 개별적으로 처리됩니다. 데이터베이스에서 성공적으로 처리된 행만 DataRow 내의 해당 DataTable에서 업데이트됩니다.

참고 항목

SQL Server 전용 Microsoft SqlClient 데이터 공급자 와 백 엔드 데이터베이스 서버는 일괄 처리 실행이 지원되는 SQL 구문을 결정합니다. 실행을 위해 지원되지 않는 문을 전송하면 예외가 throw될 수 있습니다.

참고 항목