cubrid_set_query_timeout

설명

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

cubrid_set_query_timeout으로 설정된 타임아웃 시간은 cubrid_prepare, cubrid_execute 함수에 영향을 미친다. cubrid_connect_with_url 함수의 연결 URL에 설정한 disconnect_on_query_timeout의 값을 yes로 설정한 경우에, cubrid_prepare, cubrid_execute 함수에서 타임아웃이 발생하면 CUBRID_ER_QUERY_TIMEOUT 에러를 반환한다.

cubrid_prepare, cubrid_execute 함수는 cubrid_connect_with_url 함수의 인자인 연결 URL에 login_timeout을 설정한 경우에도 에러를 반환할 수 있다. 이는 응용 클라이언트와 응용 서버(CAS) 간 재연결 과정에서 로그인 타임아웃이 발생했음을 의미한다.

응용 클라이언트와 응용 서버(CAS) 간 재연결 과정은 응용 서버가 재시작하거나 재스케줄되는 경우에 발생한다. 재스케줄이란 응용 서버가 트랜잭션 단위로 응용 클라이언트를 선택하여 연결을 시작하고 종료하는 과정을 의미한다. 브로커 파라미터인 KEEP_CONNECTION를 OFF로 설정하면 항상 재스케줄이 발생하고, AUTO로 설정하면 상황에 따라 발생할 수 있다. 자세한 내용은 "성능 튜닝 > 브로커 설정 > 브로커별 파라미터"의 KEEP_CONNECTION을 참고한다.

구문

bool cubrid_set_query_timeout(resource $conn_identifier, int $timeout);

리턴 값