Open Source RDBMS - Seamless, Scalable, Stable and Free

한국어 | Login |Register

Versions available for this page: CUBRID 8.4.1 |  CUBRID 8.4.3 |  CUBRID 9.0.0 | 

cci_set_query_timeout

설명

질의 수행의 타임아웃 시간을 설정한다.

cci_set_query_timeout으로 설정된 타임아웃 시간은 cci_prepare, cci_execute, cci_execute_array, cci_execute_batch 함수들에 영향을 미친다. 각 함수에서 타임아웃이 발생했을 때 cci_connect_with_url 연결 URL에 설정한 disconnect_on_query_timeout의 값이 yes이면 CCI_ER_QUERY_TIMEOUT 에러를 반환한다.

위 함수들은 cci_connect_with_url 함수의 인자인 연결 URL에 login_timeout이 설정되어 있는 경우에도 CCI_ER_LOGIN_TIMEOUT 에러를 반환할 수 있는데, 이는 응용 클라이언트와 브로커 응용 서버(CAS) 간 재연결 과정에서 로그인 타임아웃이 발생한 경우이다.

응용 클라이언트와 CAS 간 재연결 과정은 CAS가 재시작하거나 재스케쥴되는 경우에 발생한다. 재스케쥴이란 CAS가 트랜잭션 단위로 응용 클라이언트를 선택하여 연결을 시작하고 종료하는 과정을 의미하는데, 브로커 파라미터인 KEEP_CONNECTION이 OFF이면 항상 발생하고 AUTO이면 상황에 따라 발생한다. 보다 자세한 사항은 "시스템 설정 > 브로커 설정 > 브로커별 파라미터"의 KEEP_CONNECTION 설명을 참고한다.

구문

int cci_set_query_timeout (int req_handle, int milli_sec);

  • req_handle : (IN) 요청 핸들
  • milli_sec : (IN) 타임아웃(timeout) 시간, 단위는 msec.
리턴 값
  • 성공 : 요청 핸들 ID (int)
  • 실패 : 에러 코드
에러 코드
  • CCI_ER_REQ_HANDLE