Appendix D. 클라이언트 환경변수

클라이언트에서 설정할 수 있는 환경변수에 대한 설명입니다.

주요 환경변수

표기	설명	기본값	예시
TB_NLS_LANG	TB_NLS_LANG으로 클라이언트가 사용할 수 문자 집합들 중 하나를 지정하거나, <TB_NLS_LANGUAGE>_<TB_NLS_TERRITORY>.<CHARSET> 형태를 통해 문자 집합뿐만 아니라 언어와 지역정보를 지정할 수 있 자세한 내용은 "Tibero DB 설치 안내서" 의 "Appendix C. Tibero DB 지원 문자 집합"을 참고	UTF8	K O R E A N _ K O R E A . UTF8
TB_DSN_FILE	데이터베이스 서버에 접속하기 위한 접속 정보가 담긴 DSN 파일 경로를 설정 서버없이 클라이언트만 설치되어 TB_HOME 환경변수를 통해서 DSN 파일의 위치를 참조할 수 없을 때 사용 TB_HOME이 함께 설정된 경우, TB_DSN_FILE이 우선 적용	$TB_HOME/conf/tbdsn.tbr	$TB_HOME/client/conf/tbdsn.tbr
TB_CONN_TIMEOUT	데이터베이스 클라이언트가 데이터베이스 서버에 접속을 시도하는 동안 대기하는 시간을 초 단위로 설정 0 은 타임아웃이 없는 것을 의미	0	10
TB_READ_TIMEOUT	서버가 쿼리 수행 등의 동작을 수행하는 동안 클라이언트가 응답을 기다리는 최대 시간을 초 단위로 설정 0 은 타임아웃이 없는 것을 의미	0	1000
TBCLI_LOG_LVL	TBCLI가 로그파일로 남기는 로그 레벨을 설정 설정하지 않으면 로그를 남기지 않음 설정 가능한 값은 다음과 같고, 뒤로 갈수록 자세한 로그를 남김 (FATAL / ERROR / WARN / INFO / DEBUG / TRACE / INTERNAL) – FATAL: 심각한 오류로 인해 응용 프로 그램의 중단이 필요한 경우 사용 – ERROR: 응용 프로그램 작업이 계속 수행됨 – WARN: 오류는 아니지만, 문제가 될 소 지가 있음 – INFO: 응용 프로그램의 진행 상황을 추적할 수 있는 정보, 일반적으로 coarse- grained 정보 (예: API 호출) – DEBUG: 응용 프로그램을 디버깅하는 데 도움이 되는 fine grained 로깅 (예: 로깅 매개 변수, 계산하는 동안의 임시 값 등) – TRACE: 매우 자세한 정보, DEBUG보 다 자세한 로깅 정보를 제공 (예: 정형화되지 않은 이진 데이터 덤프, 메 모리 덤프 등 과 같이 덤핑 확장 로그) – INTERNAL: 가장 자세한 정보를 로깅. 이 수준은 내부 디버깅을 위해서만 사용됨. (예: lock 정보)	없음	TRACE
TBCLI_LOG_DIR	TBCLI가 Log 파일을 남기는 Directory 위치를 지정	/tmp or C:\	$TB_HOME/cli_log_dir
TBCLI_DBMS_NAME	데이터베이스 클라이언트가 접속할 DBMS 이름을 설정	tibero	tibero
TBCLI_FETCH_ROW_CHUNK_CNT	데이터베이스 클라이언트가 서버에게 데이터 조회 요청할 때 한번에 가지고 올 row chunk의 개수를 설정	1	10
TBCLI_BRACKET_REWRITE	테이블 이름이나 컬럼 이름에 특수문자를 포함하는 경우 ‘[]’로 묶어 표시할 수 있음	N	Y
TBCLI_WCHAR_TYPE	데이터베이스 클라이언트에서 사용하는 wide char 타입의 기본 설정을 지정 UCS2로 지정하면 16bit 타입으로 고정하고, 이외에는 wchar_t 타입(16bit 또는 32bit)을 사용	없음	UCS2
TBCLI_ERR_CONV	데이터베이스 에러 변환을 위해 정의해 놓은 파일의 경로를 지정	없음	$TB_HOME/err_conv
TBPSM_ERR_CONV	PSM에서 제공하는 pragma 중 EXCEPTION_INIT 사용시 에러 변환을 위해 정의해놓은 파일의 경로를 지정	없음	$TB_HOME/psm_err_conv
TBCLI_GET_CORE_DUMP	SIGBUS, SIGFPE, SIGSEGV 에러 발생 시 callstack 남기는 여부를 설정	Y	Y
TBXA_LOG_LVL	tbXA가 로그파일로 남기는 로그 레벨을 설정합니다. 설정하지 않으면 로그를 남기지 않음 설정 가능한 값은 다음과 같고, 뒤로 갈수록 자세한 로그를 남김(FATAL/ERROR/WARN/INFO/DEBUG/TRACE/INTERNAL)	없음	TRACE
TBXA_LOG_DIR	tbXA가 로그파일을 남기는 Directory 위치를 지정 로그파일이 생성되는 위치는 다음과 같음 • WINDOWS: C:\tbxa_날짜시간.log • UNIX: /tmp/tbxa_날짜시간.log	/tmp or C:\	$TB_HOME/tbxa_log_dir

NLS 관련 환경변수

NLS 관련 환경변수의 기본값은 TB_NLS_TERRITORY 의 설정에 따라 달라집니다.

표기	설명	예시
TB_NLS_NCHAR	클라이언트의 국가별 캐릭터 셋 자세한 내용은 "Tibero 설치 안내서의 Appendix C. Tibero 지원 문자 집합"을 참고	UTF16
TB_NLS_DATE_FORMAT	날짜 데이터 문자열 출력 형식을 지정 다음은 유효한 DATE 형식 마스크 – YYYY/MM/DD(기본값) – MM/DD/YYYY – DD RM YYYY – RR/MM/DD	YYYY/MM/DD
TB_NLS_TIME_FORMAT	시간 데이터 문자열 출력 형식을 지정	HH24:MI:SSXFF
TB_NLS_TIME_TZ_FORMAT	타임존 정보를 포함하는 시간 데이터 문자열 출력 형식을 지정	HH24:MI:SSXFF TZR
TB_NLS_TIMESTAMP_FORMAT	날짜 정보와 시간 정보를 포함하는 타임 스탬프 데이터 문자열 출력 형식을 지정 다음은 유효한 TIMESTAMP 형식 마스크 – YYYY-MM-DD HH:MI:SS.FF – YYYY/MM/DD HH24:MI:SS – RR/MM/DD HH24:MI:SSXFF(기본값)	YYYY-MM-DD HH24:MI:SSXFF
TB_NLS_TIMESTAMP_TZ_FORMAT	날짜 정보와 시간 정보와 타임존 정보를 포함하는 타임 스탬프 데이터 문자열 출력 형식을 지정	YYYY-MM-DD HH24:MI:SSXFF TZR
TB_NLS_DATE_LANGUAGE	날짜 데이터를 문자열로 표시할 때 사용되는 언어를 지정 기본적으로 NLS_LANGUAGE에 맞추어 적용됨	KOREAN
TB_NLS_CALENDAR	사용할 달력 형식을 지정	GREGORIAN
TB_NLS_NUMERIC_CHARACTERS	소수점 기호와 천단위 숫자 데이터 구분자를 지정	.,
TB_NLS_CURRENCY	통화 기호를 지정 기본적으로 NLS_TERRITORY에 맞춰 적용됨	₩
TB_NLS_DUAL_CURRENCY	지역에 대한 보조 통화 기호를 지정	₩
TB_NLS_ISO_CURRENCY	CURRENCY 데이터를 ISO 4217 표준에 따라 문자 열로 표시할 때 사용되는 통화를 지정	KOREA
TB_NLS_TERRITORY	지역 정보를 지정 기본적으로 NLS_LANGUAGE에 맞춰 적용됨	KOREA
TB_NLS_LANGUAGE	사용할 언어를 지정	KOREAN
TB_SDTZ	타임존을 설정	Asia/Seoul

TCP/IP Socket Keepalive 관련 환경변수

Socket Keepalive 관련 설정의 기본값은 운영체제의 SO_KEEPALIVE 관련 설정에 따라 달라집니다.

표기	설명	예시
TB_SO_KEEPALIVE	데이터베이스 클라이언트에서 소켓 연결을 확인을 하기 위한 keep-alive 기능을 사 용할지 여부를 설정	1 or 0
TB_TCP_KEEPIDLE	몇 초동안 서버로부터 응답이 없을 경우 서버 상태 를 체크 할지 설정	7200
TB_TCP_KEEPCNT	몇 번 서버 상태를 체크 할지 설정	9
TB_TCP_KEEPINTVL	몇 초 간격으로 서버 상태를 체크 할지 설정	75