OCI.HELP.ko.md

Windows에서 Oracle Instant Client 사용 및 환경 변수 설정 가이드

English OCI HELP

1. Oracle Instant Client란?

Oracle Instant Client는 Oracle 데이터베이스에 접속할 때 필요한 최소한의 라이브러리 모음입니다. 별도의 복잡한 설치 과정 없이 특정 디렉터리에 압축 해제 후 환경 변수를 설정하면 사용할 수 있습니다.

2. 필수 DLL 파일 목록

Windows에서 Oracle Instant Client를 사용할 때 실행 시 필요한 주요 DLL은 다음과 같습니다:

• oci.dll : Oracle Call Interface의 핵심 DLL
• oraociei19.dll : Oracle Client 실행 환경 인터프리터 (Instant Client 패키지에 포함)
• oraons.dll : Oracle Notification Service (클러스터 환경 등에서 사용될 수 있음)
• orannzsbb19.dll : Oracle Advanced Security용 DLL (SSL/TLS 사용 시 필요)
• oraociicus19.dll : 영어 로케일 전용 경량 DLL (특정 상황에서 필요)
• libclntsh.dll : 일부 클라이언트 프로그램에서 참조

추가로 Visual C++ 런타임 DLL (msvcr120.dll, msvcp120.dll 등) 도 필요할 수 있으므로 설치된 환경에 맞게 준비해야 합니다.

3. DLL 링크 및 실행 시 주의사항

• 컴파일(빌드) 시 : oci.lib 파일만 링크하면 충분합니다.
• 실행 시 : oci.dll과 함께 위에서 언급한 DLL 파일들이 모두 같은 디렉터리 또는 PATH 경로 내에 존재해야 정상 동작합니다.

4. Windows 환경 변수 설정 방법

(1) PATH 환경 변수 추가

1. Windows 시작 메뉴에서 환경 변수 검색 → 시스템 환경 변수 편집 클릭
2. 환경 변수(N)... 버튼 클릭
3. 시스템 변수 또는 사용자 변수 중 Path 선택 → 편집(E) 클릭
4. 새로 만들기 버튼 클릭 후 Instant Client 경로 입력 (예: C:\oracle\instantclient_19_23)
5. 확인 → 확인 → 적용

(2) (선택) TNS_ADMIN 환경 변수 추가

TNSNames.ora 파일 경로를 지정해야 하는 경우:

• 변수 이름: TNS_ADMIN
• 변수 값: C:\oracle\network\admin

(3) (선택) NLS_LANG 환경 변수 추가

문자셋 설정을 위해 추가 가능:

• 변수 이름: NLS_LANG
• 변수 값: KOREAN_KOREA.KO16MSWIN949

5. 환경 변수 설정 확인 방법

명령 프롬프트에서 아래 명령어를 입력:

where oci.dll

정상적으로 설정됐다면 PATH에 추가한 경로에서 oci.dll 파일이 출력됩니다.

6. 마무리

이 과정을 통해 Windows에서 Oracle Instant Client를 안정적으로 사용할 수 있습니다. 필요 시 Dependency Walker 등의 도구로 DLL 의존성을 점검하는 것도 좋은 방법입니다.