SQLGate for Oracle V10에서 Oracle Client 32비트와 64비트 혼용 사용 안내

왜 혼용 문제가 발생할까?

• Oracle 클라이언트(OCI)는 애플리케이션과 동일한 아키텍처(32/64비트)여야만 로딩이 가능합니다.

• 따라서:

  • SQLGate V9 이하 (32비트) → 32비트 Oracle Client 필요

  • SQLGate V10 이상 (64비트) → 64비트 Oracle Client 필요

따라서 한 PC에 32비트와 64비트 클라이언트를 모두 설치한 경우,
환경 변수 및 DLL 경로 충돌로 인해 정상 연결되지 않거나 오류가 발생할 수 있습니다.

⚠ 왜 혼용 문제가 발생할까요?

• SQLGate V10 이상은 64비트 OCI를 로딩해야 합니다.

• 기존에 32비트 Oracle Client가 설치되어 있고, 환경 변수(ORACLE_HOME, PATH)가 설정된 경우:

  • oci.dll 충돌 또는 인식 불가 문제 발생

• 동일 PC에서 32비트와 64비트 클라이언트를 함께 사용할 경우, 충돌 방지를 위해 환경변수 관리가 매우 중요합니다.

⚠ ORACLE_HOME과 PATH 설정 주의사항

• ORACLE_HOME이 32비트 클라이언트를 가리키고 있다면 SQLGate V10에서는 무시됩니다.

• SQLGate V10이 “Oracle 홈”으로 인식하는 기준은 다음과 같습니다:

  1. ORACLE_HOME 또는 PATH에 등록된 경로에 64비트 oci.dll이 존재할 것

  2. 해당 경로가 실제 로딩 가능한 DLL 경로일 것

📌 TNS_ADMIN은 아키텍처와 무관하게 공유 가능

• TNS_ADMIN은 tnsnames.ora, sqlnet.ora 등을 읽는 설정 경로입니다.

• 32비트, 64비트 구분 없이 공통 경로로 설정하여 사용 가능합니다.

• SQLGate V10은 "Oracle 홈"을 인식한 이후, 환경 변수의 TNS_ADMIN 경로에서 tnsnames.ora 파일을 분석합니다.

Oracle Instanct Client 64비트 다운로드 및 설치

1. Oracle Instant Client 64비트 다운로드

   • Oracle 공식 사이트에서 Windows용 64비트 Instant Client를 다운로드합니다.
   • 버전은 Database 버전과 호환되는지 확인 후 선택하세요. (예: 11g, 19c 등)

2. 다운로드할 파일 선택

   • 최소한 필요한 파일:
     • instantclient-basic-windows.x64-XX.X.X.X.X.zip
   • 추가적으로 SQL*Plus가 필요하면:
     • instantclient-sqlplus-windows.x64-XX.X.X.X.X.zip

3. 압축 해제 및 경로 설정

   • 압축을 원하는 위치에 풉니다. (예: C:\oracle\instantclient_19_64)

Oracle Instanct Client 64비트를 설치한 이후에 별도의 tnsnames.ora를 구성하지 않아도 됩니다. 오직 설치 폴더가 PATH 에 등록되어 있고 TNS_ADMIN 환경변수만 이미 있으면 동작 가능합니다.