23.8.7.51 mysql_ping()
int mysql_ping(MYSQL *mysql)
설명
서버에 대한 연결이 작동하는지 여부를 확인합니다. 연결이 끊어 자동 재 연결이 활성화되어있는 경우 다시 연결 시도가 이루어집니다. 연결이 끊어 자동 재 연결이 해제되는 경우 mysql_ping()
는 오류를 반환합니다.
자동 재 연결은 기본적으로 비활성화되어 있습니다. 그것을 사용하려면 MYSQL_OPT_RECONNECT
옵션을 사용하여 mysql_options()
를 호출합니다. 자세한 내용은 섹션 23.8.7.49 "mysql_options ()" 를 참조하십시오.
mysql_ping()
은 오랫동안 유휴 상태에있는 클라이언트에서 서버가 연결을 닫고 있는지 여부를 확인하고 필요에 따라 다시 연결하는 데 사용할 수 있습니다.
mysql_ping()
가 다시 연결하는 경우, 그 명시적인 징후는 없습니다. 다시 연결이되는지 여부를 판단하려면 mysql_ping()
를 호출하기 전에 mysql_thread_id()
를 호출하여 원래의 연결 식별자를 취득하고 나서 다시 mysql_thread_id()
를 호출하여 식별자가 변경되어 여부를 확인합니다.
다시 연결이되면 연결의 일부 특성이 초기화됩니다. 이러한 특성에 대한 자세한 내용은 섹션 23.8.16 "자동 재 연결 동작 제어" 를 참조하십시오.
반환 값
서버에 대한 연결이 활성화 된 경우는 제로. 오류가 발생한 경우 0이 아닌. 0이 아닌 리턴 값은 MySQL 서버 자체가 중지 여부를 표시하지 않습니다. 네트워크 문제 등의 기타 이유로 연결이 끊어 질 가능성이 있습니다.
오류
CR_COMMANDS_OUT_OF_SYNC
명령이 잘못된 순서로 실행되었습니다.
CR_SERVER_GONE_ERROR
MySQL 서버가 존재하지 않습니다.
CR_UNKNOWN_ERROR
알 수없는 오류가 발생했습니다.