文件首頁
MySQL 8.4 C API 開發人員指南
下載本手冊
PDF (US Ltr) - 1.4Mb
PDF (A4) - 1.4Mb


5.4.56 mysql_ping()

int
mysql_ping(MYSQL *mysql)

說明

檢查與伺服器的連線是否正常運作。如果連線已中斷且啟用自動重新連線,則會嘗試重新連線。如果連線已中斷且停用自動重新連線,mysql_ping() 會傳回錯誤。

預設會停用自動重新連線。若要啟用它,請使用 MYSQL_OPT_RECONNECT 選項(已棄用)呼叫 mysql_options()。如需詳細資訊,請參閱第 5.4.54 節,「mysql_options()」

閒置很長時間的客戶端可以使用 mysql_ping() 來檢查伺服器是否已關閉連線,並在必要時重新連線。

如果 mysql_ping() 確實導致重新連線,則不會有明確的指示。若要判斷是否發生重新連線,請在呼叫 mysql_ping() 之前呼叫 mysql_thread_id() 以取得原始連線識別碼,然後再次呼叫 mysql_thread_id() 以查看識別碼是否已變更。

如果發生重新連線,連線的一些特性將會被重設。有關這些特性的詳細資訊,請參閱第 3.6.8 節,「自動重新連線控制」

傳回值

如果與伺服器的連線處於活動狀態,則為零。如果發生錯誤,則為非零。非零傳回值不表示 MySQL 伺服器本身已關閉;連線可能因為其他原因(例如網路問題)而中斷。

錯誤