C#에서 CSV 파일을 DataTable로 읽어들이는 방법

왜 CSV를 DataTable으로 변환하는 것이 중요한가요?

CSV를 DataTable으로 변환하면 개발자가 쉼표로 구분된 값을 구조화된 객체로 변환하여 추가 처리할 수 있습니다. 재고 데이터, 고객 기록 또는 트랜잭션 로그를 다루든 간에, CSV를 DataTable으로 효율적으로 변환하는 것이 중요합니다. 첫 번째 행을 열 헤더로 사용하면 DataTable 열이 데이터베이스 테이블 스키마와 정렬되도록 보장할 수 있어 Excel에서 SQL 작업에 적합합니다.

전통적인 접근법은 종종 대용량 파일, 다양한 구분 기호 또는 메모리 관리와 같은 문제를 겪습니다. IronXL은 이러한 문제를 제거하고 추가 코드 없이 다양한 구분 기호, 따옴표로 묶인 필드, 내장된 쉼표를 처리합니다. IronXL의 CSV 읽기 기능은 데이터 유효성 검사 및 파일 크기 제어와 같은 추가 기능을 제공하면서 일반적인 문제 지점을 제거합니다.

IronXL은 어떻게 설치합니까?

IronXL 사용을 시작하려면 간단한 NuGet Install-Package가 필요합니다. Visual Studio의 NuGet 패키지 관리자 콘솔을 열고 다음 명령 중 하나를 실행하세요:

Install-Package IronXL

Install-Package IronXL

또는 .NET CLI를 선호하는 경우:

dotnet add package IronXL

dotnet add package IronXL

설치하면 IronXL 네임스페이스를 프로젝트에 추가하세요:

using IronXL;
using System.Data;

using IronXL;
using System.Data;

이는 Excel 종속성 없이 모든 CSV 처리 기능에 대한 액세스를 제공합니다. 자세한 내용은 IronXL 문서와 NuGet 설치 가이드를 참조하세요.

어떻게 CSV 파일을 DataTable으로 변환하나요?

IronXL의 기본 워크플로우는 몇 줄의 코드만으로 이루어져 있습니다. C# 10+의 최상위 문장을 사용하여 CSV 파일을 읽고 DataTable으로 변환하는 방법은 다음과 같습니다:

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

LoadCSV 메서드는 자동으로 CSV 파일을 구문 분석하여 따옴표가 있는 필드와 포함된 쉼표를 처리합니다. fileFormat 파라미터는 IronXL에 CSV 데이터를 내부적으로 어떻게 해석해야 하는지를 알려주어 엑셀 호환 구조로 간주하도록 보장합니다. 로드된 후, ToDataTable(true) 메서드는 워크시트를 DataTable으로 변환하고 true 파라미터는 첫 번째 행을 열 헤더로 사용할지 표시합니다. 이는 CSV 헤더와 일치하는 이름이 있는 깨끗하고 구조화된 DataTable을 결과로 제공합니다. 더 많은 고급 조작 옵션이 필요하다면 완전한 IronXL 안내서를 탐색해 보세요.

변환 과정은 데이터 유형도 유지하며, 숫자는 숫자대로, 날짜는 정확히 파싱되며, 텍스트 필드는 서식을 유지합니다. 이 자동 유형 추론은 수작업 파싱 방법에 비해 상당한 개발 시간을 절약해 줍니다. 맞춤형 데이터 서식이 필요한 경우, 변환 전에 셀 서식을 적용할 수 있습니다.

어떻게 DataTable을 SQL Server에 가져올 수 있나요?

일단 DataTable을 생성하면, SqlBulkCopy을 사용하여 SQL Server로 효율적으로 가져올 수 있습니다. 다음 예제는 C# 최상위 수준 문을 사용합니다:

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

SqlBulkCopy 클래스는 대규모 데이터 가져오기에 강력한 성능을 제공합니다. ColumnMappings 컬렉션은 DataTable 열을 데이터베이스 열과 다른 이름으로 매핑하여 데이터 스키마의 유연성을 보장합니다. BatchSize 속성은 모든 것을 한 번에 로드하는 대신 청크로 레코드를 처리하여 메모리 사용량을 최적화합니다. IronXL의 가져오기 및 내보내기 기능에 대해 자세히 알아보세요.

데이터 무결성을 추가하기 위해, 대량 복사 작업에 대한 트랜잭션 지원을 구현하는 것을 고려하세요. 이렇게 하면 오류가 발생하면 일부 가져오기가 롤백될 수 있습니다. 또한, 가져오기 전에 데이터를 사전 검증하기 위해 IronXL의 엑셀 쓰기 기능을 사용할 수 있습니다.

여기에서 SSMS의 SELECT * FROM dbo.Inventory; 쿼리를 사용하여 CSV 데이터가 SQL Server에 가져왔는지 확인할 수 있습니다. 먼저 예제 CSV 파일에서 사용된 데이터를 살펴보십시오:

이제 쿼리의 결과를 보면, 모든 열, 헤더, 행이 데이터베이스 테이블로 성공적으로 복사된 것을 볼 수 있습니다.

다양한 CSV 구분 기호를 어떻게 처리하나요?

모든 CSV 파일이 쉼표를 사용하지는 않습니다. IronXL은 다양한 구분자를 처리하므로 국제 데이터 형식 또는 레거시 시스템에 실용적입니다. 다음 예제는 탭으로 구분된 파일 및 세미콜론으로 구분된 파일을 로드하는 방법을 보여줍니다.

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

이 코드는 IronXL WorkBook 객체로 서로 다른 구분 기호를 가진 CSV 파일을 로드하는 방법을 보여줍니다. 탭 구분 파일은 메뉴로 "\t"를 사용하여 읽히고, 세미콜론 구분 파일은 표준 CSV 형식으로 변환된 후 로딩됩니다. 각 워크북의 기본 워크시트는 DataTable으로 변환되어 ToDataTable(true)은 첫 번째 행을 열 헤더로 사용합니다. 더 복잡한 파일 형식 시나리오의 경우, 다양한 형식으로 Excel 데이터를 내보내기를 탐색할 수도 있습니다.

다양한 구분자를 처리하는 유연성은 실제로 많은 CSV 구문 분석 문제를 해결합니다. 유럽 데이터 형식을 다룰 때, IronXL의 구분자 처리는 데이터 형식 표준의 지역 차이를 수용합니다. 구조가 일관되지 않은 파일의 경우, LoadCSV로 전달하기 전에 원시 텍스트를 사전 처리합니다.

RFC 4180 표준은 IronXL이 따르는 인용 필드와 포함된 쉼표에 대한 CSV 형식 사양을 정의합니다. 이 유연성은 또한 .NET에서 CSV를 DataTable로 읽는 방법에 대한 Stack Overflow 커뮤니티 스레드에서 자세히 논의됩니다.

CSV 외에 지원되는 IronXL 기능은 무엇입니까?

IronXL은 CSV 읽기 외에도 훨씬 더 많은 것을 다룹니다. 이 라이브러리는 C#에서 Excel 및 스프레드시트 작업의 전체 스펙트럼을 처리하여 데이터 중심 애플리케이션에 대한 단일 종속성을 만듭니다.

다음 단계는 무엇인가요?

IronXL은 CSV 데이터베이스 가져오기를 간단하고 신뢰할 수 있는 프로세스로 변환합니다. 몇 줄의 코드만으로 당신은 다음을 할 수 있습니다:

LoadCSV 기능성을 사용하여 임의 파일 경로에서 CSV 파일 읽기

• 적절한 데이터 형식화로 CSV 데이터를 DataTable으로 변환합니다. 자동 파싱을 통해 열 머리글과 DataTable 열을 유지 대량 연산을 사용하여 수백만의 열을 데이터베이스 테이블로 효율적으로 가져오기

라이브러리는 CSV 파싱, 메모리 관리, 데이터 유형 변환의 복잡한 부분을 처리하여 파일 처리 세부사항 대신 비즈니스 로직에 집중할 수 있게 해줍니다. ASP.NET 애플리케이션을 빌드하거나 Blazor로 작업하거나 .NET 10 데스크톱 앱을 개발하든 IronXL은 모든 플랫폼에서 일관되고 신뢰할 수 있는 CSV 처리를 제공합니다.

시작할 준비 되셨나요? IronXL 문서는 모든 기능을 깊이 있게 다루고 있으며, 체험 라이선스를 통해 전체 라이브러리를 평가할 수 있습니다. 풍부한 코드 예제와 명확한 API 참조 덕분에, 당신은 .NET 10 응용 프로그램에서 효과적으로 CSV 파일을 처리할 수 있습니다.