> 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/tbcli-guide/tbcli-environment-variable.md).

# tbCLI 환경변수

tbCLI에서 사용하는 환경 변수를 소개합니다.

## 주요 환경 변수

<table><thead><tr><th width="216">표기</th><th width="241">의미</th><th width="138">기본값</th><th>예시</th></tr></thead><tbody><tr><td>TB_NLS_LANG</td><td><p>TB_NLS_LANG으로 클라이언트가 사용할 문자 집합 중 하나를 지정하거나,</p><p>&#x3C;TB_NLS_LANGUAGE>_&#x3C;TB_NLS_TERRITORY>.&#x3C;CHARSET> 형태를 통해 문자 집합뿐만 아니라 언어와 지역 정보를 지정할 수 있음</p></td><td>UTF8</td><td>KOREAN_KOREA.UTF8</td></tr><tr><td>TB_DSN_FILE</td><td>데이터베이스 서버에 접속하기 위한 접속 정보가 담긴 DSN 파일 경로를 설정</td><td><p>$TB_HOME/client/con</p><p>fig/tbdsn.tbr</p></td><td><p>$TB_HOME/client/con</p><p>fig/tbdsn.tbr</p></td></tr><tr><td>TB_CONN_TIMEOUT</td><td><ul><li>데이터베이스 클라이언트가 데이터베이스 서버에 접속을 시도하는 동안 대기하는 시간을 초 단위로 설정</li><li>0은 타임아웃이 없는 것을 의미</li></ul></td><td>0</td><td>10</td></tr><tr><td>TB_READ_TIMEOUT</td><td><ul><li>서버가 쿼리 수행 등의 동작을 수행하는 동안 클라이언트가 응답을 기다리는 최대 시간을 초 단위로 설정</li><li>0은 타임아웃이 없는 것을 의미</li></ul></td><td>0</td><td>1000</td></tr><tr><td>TBCLI_LOG_LVL</td><td><ul><li>TBCLI가 로그 파일로 남기는 로그 레벨을 설정</li><li>설정하지 않으면 로그를 남기지 않음</li><li>설정 가능한 값은 다음과 같고, 뒤로 갈수록 자세한 로그를 남김. (FATAL/ERROR/WARN/INFO/DEBUG/TRACE/INTERNAL)</li></ul></td><td>없음</td><td>TRACE</td></tr><tr><td>TBCLI_LOG_DIR</td><td>TBCLI가 Log 파일을 남기는 Directory 위치를 지정</td><td>/tmp or C:\\</td><td>$TB_HOME/cli_log_dir</td></tr><tr><td>TBCLI_DBMS_NAME</td><td>데이터베이스 클라이언트가 접속할 DBMS 이름을 설정</td><td>tibero</td><td>tibero</td></tr><tr><td>TBCLI_FETCH_ROW_CHUNK_CNT</td><td>데이터베이스 클라이언트가 서버에 데이터 조회를 요청할 때 한 번에 가지고 올 row chunk의 개수를 설정</td><td>1</td><td>10</td></tr><tr><td>TBCLI_BRACKET_REWRITE</td><td>테이블 이름이나 컬럼 이름에 특수 문자를 포함하는 경우에 '[ ]'로 묶어 표시할 수 있음</td><td>N</td><td>Y</td></tr><tr><td>TBCLI_WCHAR_TYPE</td><td><ul><li>데이터베이스 클라이언트에서 사용하는 wide char 타입의 기본 설정을 지정</li><li>UCS2로 지정하면 16비트 타입으로 고정하고, 이외에는 wchar_t 타입(16비트 또는 32비트)으로 사용</li></ul></td><td>없음</td><td>UCS2</td></tr><tr><td>TBCLI_ERR_CONV</td><td>데이터베이스 에러 변환을 위해 정의해 놓은 파일의 경로를 지정</td><td>없음</td><td>$TB_HOME/err_conv</td></tr><tr><td>TBPSM_ERR_CONV</td><td>PSM에서 제공하는 pragma 중 EXCEPTION_INIT 사용 시 에러 변환을 위해 정의해 놓은 파일의 경로를 지정</td><td>없음</td><td>$TB_HOME/psm_err_conv</td></tr><tr><td>TBCLI_GET_CORE_DUMP</td><td>SIGBUS, SIGFPE, SIGSEGV 에러 발생 시 callstack을 남길지 여부를 설정</td><td>Y</td><td>Y</td></tr><tr><td>TBXA_LOG_LVL</td><td><ul><li>tbXA가 로그 파일로 남기는 로그 레벨을 설정</li><li>설정하지 않으면 로그를 남기지 않음</li><li>설정 가능한 값은 다음과 같고, 뒤로 갈수록 자세한 로그를 남김 (FATAL/ERROR/WARN/INFO/DEBUG/TRACE/INTERNAL)</li></ul></td><td>없음</td><td>TRACE</td></tr><tr><td>TBXA_LOG_DIR</td><td>tbXA가 로그 파일을 남기는 Directory 위치를 지정</td><td>/tmp or C:\\</td><td>$TB_HOME/xa_log_dir</td></tr></tbody></table>

## **NLS** 관련 환경 변수

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

<table><thead><tr><th width="268">표기</th><th width="264">의미</th><th>예시</th></tr></thead><tbody><tr><td>TB_NLS_NCHAR</td><td>클라이언트의 국가별 캐릭터 셋</td><td>UTF16</td></tr><tr><td>TB_NLS_DATE_FORMAT</td><td>날짜 데이터 문자열 출력 형식을 지정</td><td>YYYY/MM/DD</td></tr><tr><td>TB_NLS_TIME_FORMAT</td><td>시간 데이터 문자열 출력 형식을 지정</td><td>HH24:MI:SSXFF</td></tr><tr><td>TB_NLS_TIME_TZ_FORMAT</td><td>타임존 정보를 포함하는 시간 데이터 문자열 출력 형식을 지정</td><td>HH24:MI:SSXFF TZR</td></tr><tr><td>TB_NLS_TIMESTAMP_FORMAT</td><td>날짜 정보와 시간 정보를 포함하는 타임스탬프 데이터 문자열 출력 형식을 지정</td><td><p>YYYY-MM-DD</p><p>HH24:MI:SSXFF</p></td></tr><tr><td>TB_NLS_TIMESTAMP_TZ_FORMAT</td><td>날짜 정보와 시간 정보와 타임존 정보를 포함하는 타임스탬프 데이터 문자열 출력 형식을 지정</td><td><p>YYYY-MM-DD</p><p>HH24:MI:SSXFF TZR</p></td></tr><tr><td>TB_NLS_DATE_LANGUAGE</td><td><ul><li>날짜 데이터를 문자열로 표시할 때 사용되는 언어를 지정</li><li>기본적으로 NLS_LANGUAGE에 맞추어 적용됨</li></ul></td><td>KOREAN</td></tr><tr><td>TB_NLS_CALENDAR</td><td>사용할 달력 형식을 지정</td><td>GREGORIAN</td></tr><tr><td>TB_NLS_NUMERIC_CHARACTERS</td><td>소수점 기호와 천단위 숫자 데이터 구분자를 지정</td><td>.,</td></tr><tr><td>TB_NLS_CURRENCY</td><td><ul><li>통화 기호를 지정</li><li>기본적으로 NLS_TERRITORY에 맞춰 적용</li></ul></td><td>￦</td></tr><tr><td>TB_NLS_DUAL_CURRENCY</td><td>지역에 대한 보조 통화 기호를 지정</td><td>￦</td></tr><tr><td>TB_NLS_ISO_CURRENCY</td><td>CURRENCY 데이터를 ISO 4217 표준에 따라 문자열로 표시할 때 사용되는 통화를 지정</td><td>KOREA</td></tr><tr><td>TB_NLS_TERRITORY</td><td>지역 정보를 지정. 기본적으로 NLS_LANGUAGE에 맞춰 적용됨</td><td>KOREA</td></tr><tr><td>TB_NLS_LANGUAGE</td><td>사용할 언어를 지정</td><td>KOREAN</td></tr><tr><td>TB_SDTZ</td><td>타임존을 설정</td><td>Asia/Seoul</td></tr></tbody></table>

## **TCP/IP Socket Keepalive** 관련 환경 변수

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

<table><thead><tr><th width="213">표기</th><th width="284">의미</th><th>예시</th></tr></thead><tbody><tr><td>TB_SO_KEEPALIVE</td><td><p>데이터베이스 클라이언트에서 소켓 연결을 확인하기 위한 keep-alive</p><p>기능을 사용할지 여부를 설정</p></td><td>1 or 0</td></tr><tr><td>TB_TCP_KEEPIDLE</td><td>몇 초 동안 서버로부터 응답이 없을 경우 서버 상태를 체크할지 설정</td><td>7200</td></tr><tr><td>TB_TCP_KEEPCNT</td><td>몇 번 서버 상태를 체크할지 설정</td><td>9</td></tr><tr><td>TB_TCP_KEEPINTVL</td><td>몇 초 간격으로 서버 상태를 체크할지 설정</td><td>75</td></tr></tbody></table>