第 6 章 C API 預處理語句介面

6.1 C API 預處理語句介面概述

6.2 C API 預處理語句資料結構

6.2.1 C API 預處理語句類型代碼
6.2.2 C API 預處理語句類型轉換

6.3 C API 預處理語句函數參考

6.4 C API 預處理語句函數描述

6.4.1 mysql_stmt_affected_rows()
6.4.2 mysql_stmt_attr_get()
6.4.3 mysql_stmt_attr_set()
6.4.4 mysql_stmt_bind_named_param()
6.4.5 mysql_stmt_bind_param()
6.4.6 mysql_stmt_bind_result()
6.4.7 mysql_stmt_close()
6.4.8 mysql_stmt_data_seek()
6.4.9 mysql_stmt_errno()
6.4.10 mysql_stmt_error()
6.4.11 mysql_stmt_execute()
6.4.12 mysql_stmt_fetch()
6.4.13 mysql_stmt_fetch_column()
6.4.14 mysql_stmt_field_count()
6.4.15 mysql_stmt_free_result()
6.4.16 mysql_stmt_init()
6.4.17 mysql_stmt_insert_id()
6.4.18 mysql_stmt_next_result()
6.4.19 mysql_stmt_num_rows()
6.4.20 mysql_stmt_param_count()
6.4.21 mysql_stmt_param_metadata()
6.4.22 mysql_stmt_prepare()
6.4.23 mysql_stmt_reset()
6.4.24 mysql_stmt_result_metadata()
6.4.25 mysql_stmt_row_seek()
6.4.26 mysql_stmt_row_tell()
6.4.27 mysql_stmt_send_long_data()
6.4.28 mysql_stmt_sqlstate()
6.4.29 mysql_stmt_store_result()

MySQL 客戶端/伺服器協定提供了預處理語句的使用。此功能使用 MYSQL_STMT 語句處理程式資料結構，該結構由 mysql_stmt_init() 初始化函數返回。預處理執行是多次執行語句的有效方式。首先解析該語句，以便為執行做好準備。然後，使用初始化函數返回的語句處理程式，在稍後執行一次或多次。

對於執行多次的語句，預處理執行比直接執行更快，主要是因為查詢只解析一次。在直接執行的情況下，每次執行時都會解析查詢。預處理執行還可以減少網路流量，因為對於預處理語句的每次執行，只需要傳送參數的資料即可。

在某些情況下，預處理語句可能不會提供效能提升。為了獲得最佳結果，請使用預處理和非預處理語句測試您的應用程式，並選擇效能最佳的選項。

預處理語句的另一個優點是它使用二進位協定，使客戶端和伺服器之間的資料傳輸更有效率。

如需可用作預處理語句的 SQL 語句清單，請參閱預處理語句。

對預處理語句所參照的表格或檢視表的元資料變更會被偵測到，並在下次執行該語句時導致自動重新準備該語句。如需更多資訊，請參閱預處理語句和預存程式的快取。