第 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 語句清單，請參閱預處理語句。

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