주 콘텐츠로 건너뛰기

검색

Welcome to Tibero GTS!

ODBC / OLEDB 로그 수집 방법

문서유형ㅣ기술정보

분야ㅣ마이그레이션

적용제품버전ㅣ7FS02PS

문서번호ㅣTMITI028

 

개요

CLI를 통해 데이터베이스에 접속하는 Client의 접속 및 작업 기록을 남기기 위해 CLI 로그를 설정합니다.

해당 로그는 tbESQL, tbsql, ODBC 등 CLI 기반 프로그램에서의 문제 발생 시 원인 분석 및 장애 조치에 활용할 수 있습니다.

OLE DB를 통해 데이터베이스에 접속하는 응용 프로그램의 접속 및 SQL 수행 정보를 기록하기 위해 OLE DB 로그를 설정합니다. 해당 로그는 ADO(VB 등) 환경에서의 연결 오류, SQL 실행 실패 등의 문제 발생 시 원인 분석 및 조치에 활용할 수 있습니다.

 

 

방법

1. 환경 변수

ODBC(tbCLI) 환경 변수

tbCLI 로그 설정 시, 환경 변수를 지정해야 하며 주요 환경 변수는 다음과 같습니다.

환경 변수의미기본 값예시
TBCLI_LOG_LVL
  • TBCLI 가 로그파일로 남기는 로그 레벨을 설정합니다. 설정하지 않으면 로그를 남기지 않습니다.
  • 설정 가능한 값은 다음과 같고, 뒤로 갈수록 자세한 로그를 남깁니다. (FATAL/ERROR/WARN/INFO/DEBUG/TRACE/INTERNAL)
없음TRACE
TBCLI_LOG_DIR
  • TBCLI 가 Log 파일을 남기는 Directory 위치를 지정합니다.
  • 로그 파일명 형식은 tbcli_년월일시분초_PID.log 입니다.
  • UNIX or Linux : /tmp
  • window : C:\\
$TB_HOME/tbcli_log
TB_NLS_LANG클라이언트의 캐릭터 셋을 설정하는 부분으로 기본은 MSWIN949(한글)로 설정되어 있습니다. 
보통은 DB 캐릭터 셋과 일치 시키거나 부분 집합으로 설정하며 설정할 수 있는 값은 DB 캐릭터 셋과 동일합니다.		MSWIN949MSWIN949

 

TBCLI_LOG_LVL 파라미터의 로그 레벨 종류는 다음과 같습니다.

레벨설명
FATAL심각한 오류 발생 시 사용 (프로그램 중단 필요)
ERROR오류 발생, 작업은 계속 진행
WARN오류는 아니지만 주의가 필요한 경우 사용
INFO일반적인 동작 및 상태 정보를 기록
DEBUG주요 진행 상황 기록(예:API 호출)
TRACE매우 세밀한 디버깅 정보 기록(예:메모리 덤프 등)
INTERNAL최상위 상세 로깅(내부 디버깅용, lock 정보 등)

 

OLEDB 환경 변수

현재 Tibero 에서는 OLE DB을 지원하지 않고 ADO 환경(VB)에서는 MSDASQL을, ADO.NET(C#, VB NET) 환경에서는 TDP.NET을 사용하도록 하고 있습니다.

MSDASQL 사용 시, 위에 작성한 Tibero ODBC 환경 변수를 적용하여 tbCLI 로그로 확인 가능합니다. 

TDP.NET 사용 시, 환경 변수를 지정해야 하며 Window 환경 변수는 다음과 같습니다.

환경 변수설명
TDPNET_LOG_PATH로그 파일이 생성되는 경로를 지정
TDPNET_LOG_LVL
  • 로그 레벨을 지정
  • 현재 TDP.NET은 레벨로 TRACE 한 가지만 지원

 

 

2. 설정 방법

ODBC(tbCLI) 로그 설정 방법

tbCLI 로그 환경 변수 설정은 tbdsn.tbr 파일 또는 환경 변수로 지정할 수 있으며, 둘 다 설정된 경우 tbdsn.tbr 설정이 우선 적용됩니다.

tbdsn.tbr 설정 방법

tibero7=(
    (INSTANCE=(HOST=localhost)
              (PORT=8629)
              (DB_NAME=tibero7)
    )
)

TBCLI_LOG_LVL=TRACE
TBCLI_LOG_DIR=/home/tibero/cli_log

 

환경 변수 설정 방법

- Unix 또는 Linux 환경

$ export TBCLI_LOG_LVL=TRACE
$ export TBCLI_LOG_DIR=/home/tibero/cli_log

 

- Window 환경
[시스템 속성] 에서 환경 변수를 설정합니다.

 

OLE DB 로그 설정 방법

MSDASQL 사용 시 설정 방법

MSDASQL 사용 시, Window 환경 tbCLI 로그 환경 변수 설정과 동일하게 진행하면 됩니다.

 

TDP.NET 사용 시 설정 방법

TDP.NET 로그 환경 변수 설정은 Window 환경 [시스템 속성] 에서 환경 변수를 설정합니다.

 

 

관련 대상