> For the complete documentation index, see [llms.txt](https://docs.tibero.com/tibero-manuals/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tibero.com/tibero-manuals/7.2.6.manuals/tdp-net-guide/introduction-to-tdp.net.md).

# Tibero TDP.NET 소개

Tibero에서 제공하는 Tibero Data Provider for .NET (TDP.NET)를 소개합니다.

## Tibero TDP.NET

Tibero Data Provider for .NET (TDP.NET)은 Tibero가 제공하는 .NET Data Provider입니다. 사용자의 .NET 애플리케이션과 Tibero 간 SQL 인터페이스 역할을 합니다. TDP.NET은 ADO.NET의 핵심 클래스를 구현하고 별도의 API도 제공합니다.

TDP.NET은 다음과 같은 특징이 있습니다.

* TDP.NET은 ADO.NET의 핵심 개체를 상속하여 구현합니다.
* 소스 코드 전체가 C# 언어로 작성된 Managed Driver입니다.
* 사용자는 C#, Visual Basic .NET과 같은 .NET 언어로 TDP.NET 프로그램을 작성할 수 있습니다.
* 두 가지 배포 형태로 제공됩니다. Framework 드라이버는 .NET Framework 2.0을, Core 드라이버는 .NET 5.0을 기반으로 합니다.
* Any CPU 모드로 빌드되어 Windows 32-bit와 64-bit에서 모두 실행할 수 있습니다.

### 드라이버 배포 형태

TDP.NET은 대상 .NET 런타임에 따라 두 가지 드라이버로 제공됩니다.

<table><thead><tr><th width="142">구분</th><th>Framework 드라이버</th><th>Core 드라이버</th></tr></thead><tbody><tr><td>기반 런타임</td><td>.NET Framework 2.0</td><td>.NET 5.0</td></tr><tr><td>배포 형태</td><td>Tibero.DataAccess.dll</td><td>NuGet 패키지 Tibero.DataAccess</td></tr><tr><td>유지보수 정책</td><td>결함 수정만 제공</td><td>신규 기능 개발 및 결함 수정</td></tr><tr><td>어셈블리·네임스페이스</td><td>Tibero.DataAccess.dll / Tibero.DataAccess.Client, Tibero.DataAccess.Types</td><td>동일</td></tr></tbody></table>

### 동작 구조

Tibero Data Provider for .NET (TDP.NET)은 Tibero 데이터베이스를 사용하기 위한 .NET Data Provider의 구현체입니다. .NET Data Provider는 데이터를 조작하기 위한 ADO.NET의 구성 요소로서 다음 4가지 핵심 개체로 구성되어 있습니다.

<table><thead><tr><th width="159">개체</th><th>설명</th></tr></thead><tbody><tr><td>Connection</td><td><ul><li>데이터 소스(data source)에 연결</li><li>TDP.NET의 구현체는 TiberoConnection 클래스</li></ul></td></tr><tr><td>Command</td><td><ul><li>데이터 소스에 대해 명령을 실행</li><li>TDP.NET의 구현체는 TiberoCommand 클래스</li></ul></td></tr><tr><td>DataReader</td><td><ul><li>데이터 소스에서 데이터를 조회</li><li>TDP.NET의 구현체는 TiberoDataReader 클래스</li></ul></td></tr><tr><td>DataAdapter</td><td><ul><li>데이터 소스에서 조회해 온 내용을 DataSet에 채우거나, 업데이트된 내용을 데이터 소스에 적용</li><li>TDP.NET의 구현체는 TiberoDataAdapter 클래스</li></ul></td></tr></tbody></table>

TDP.NET은 System.Data.Common 네임스페이스(namespace)로 정의된 ADO.NET 클래스를 상속합니다. 또한 Tibero의 특정 기능과 타입을 제공하는 클래스를 포함합니다.

TDP.NET은 소스 코드 전체가 C# 언어로 작성된 Managed Driver입니다. Tibero 데이터베이스 서버를 설치하지 않아도 .NET 애플리케이션을 개발할 수 있는 API를 제공합니다.

### TDP.NET 어셈블리

Tibero.DataAccess.dll 어셈블리는 두 개의 네임스페이스를 제공합니다.

**Tibero.DataAccess.Client**

ADO.NET의 구현체와 TDP.NET에서 추가로 제공하는 클래스들을 포함합니다.<br>

**Tibero.DataAccess.Types**

Tibero에서 제공하는 타입을 지원하기 위한 TDP.NET 타입 클래스들을 포함합니다.

### ODBC, OLEDB와 차이점

.NET 환경에서 Tibero 데이터베이스에 접속하는 방법은 ODBC, OLEDB, TDP.NET의 세 가지입니다. ODBC 또는 OLEDB는 ODBC 드라이버(또는 MSDASQL 등)와 같은 별도 계층을 거쳐 Tibero 데이터베이스에 접속합니다. 반면 TDP.NET은 .NET 언어로 작성한 문장을 Tibero 데이터베이스 고유의 프로토콜로 변환합니다. 따라서 별도 계층이 필요하지 않습니다.

또한 TDP.NET은 LOB, Ref Cursor와 같은 Tibero 고유의 타입과 기능을 지원합니다. 따라서 .NET 환경에서 Tibero 데이터베이스에 효율적으로 접근할 수 있습니다.

### 시스템 요구 사항

TDP.NET의 시스템 요구 사항은 다음과 같습니다.

#### **운영체제**

TDP.NET은 Windows 운영체제 32-bit, 64-bit에서 사용 가능합니다. TDP.NET 어셈블리는 Any CPU 모드로 빌드되었기 때문에 32-bit, 64-bit 환경에서 모두 실행 가능합니다.

#### **Microsoft .NET 런타임**

**Framework 드라이버**

.NET 프레임워크 2.0 이상의 버전을 지원합니다. 사용자의 .NET 프레임워크 환경이 4.0 이상일 경우 .NET 프레임워크 3.5 버전이 설치되어 있어야 합니다.

**Core 드라이버**

.NET 5.0을 대상으로 제공됩니다. .NET 5.0 이상 애플리케이션(.NET 6 이후 버전 포함)에서 참조할 수 있습니다.

### 다운로드 및 설정

TDP.NET 드라이버는 Tibero 홈페이지에서 내려받아 프로젝트에 참조합니다. 로그 설정은 이어서 설명합니다.

#### **다운로드**

Tibero 홈페이지(<https://www.tibero.com/ko/downloads/Tibero>)의 Tibero Client 메뉴에서 사용할 드라이버에 맞는 항목을 내려받습니다.

<table><thead><tr><th width="144.2222900390625">다운로드 항목</th><th width="180.4444580078125">드라이버</th><th>배포 형태</th></tr></thead><tbody><tr><td>TDP.NET</td><td>Framework 드라이버</td><td>Tibero.DataAccess.dll</td></tr><tr><td>TDP.NET Core</td><td>Core 드라이버</td><td>NuGet 패키지 Tibero.DataAccess.&#x3C;버전>.nupkg</td></tr></tbody></table>

#### **로그 설정**

Windows 환경변수로 다음 두 가지를 설정하여 로그 파일을 남길 수 있습니다.

<table><thead><tr><th width="200.111083984375">환경변수</th><th>설명</th></tr></thead><tbody><tr><td>TDPNET_LOG_PATH</td><td>로그 파일이 생성되는 경로를 지정</td></tr><tr><td>TDPNET_LOG_LVL</td><td><p>로그 레벨을 지정. 다음 값 중 하나를 사용하며 대소문자를 구분하지 않음.</p><ul><li>TRACE: 드라이버의 메서드 호출 전체를 기록</li><li>FATAL: 오류 로그만 기록</li><li>TARGETCONN <mark style="color:cyan;background-color:cyan;">Core</mark> : 접속 처리 과정만 기록</li><li>TARGETPOOL <mark style="color:cyan;background-color:cyan;">Core</mark> : 커넥션 풀 처리 과정만 기록</li></ul></td></tr></tbody></table>
