1. 程式人生 > >mysql prepare 預處理語句

mysql prepare 預處理語句

文章來自mysql參考手冊

MySQL 5.1對伺服器一方的預製語句提供支援。如果您使用合適的客戶端程式設計介面,則這種支援可以發揮在MySQL 4.1中實施的高效客戶端/伺服器二進位制協議的優勢。候選介面包括MySQL C API客戶端庫(用於C程式)、MySQL Connector/J(用於Java程式)和MySQL Connector/NET。例如,C API可以提供一套能組成預製語句API的函式呼叫。請參見25.2.4節,“C API預處理語句”。其它語言介面可以對使用了二進位制協議(通過在C客戶端庫中連結)的預製語句提供支援。有一個例子是PHP 5.0中的mysqli擴充套件

對預製語句,還有一個SQL介面可以利用。與在整個預製語句API中使用二進位制協議相比,本介面效率沒有那麼高,但是它不要求程式設計,因為在SQL層級,可以直接利用本介面:

· 當您無法利用程式設計介面時,您可以使用本介面。

· 有些程式允許您傳送SQL語句到將被執行的伺服器中,比如mysql客戶端程式。您可以從這些程式中使用本介面。

· 即使客戶端正在使用舊版本的客戶端庫,您也可以使用本介面。唯一的要求是,您能夠連線到一個支援預製語句SQL語法的伺服器上。

預製語句的SQL語法在以下情況下使用:

· 在編程式碼前,您想要測試預製語句在您的應用程式中執行得如何。或者也許一個應用程式在執行預製語句時有問題,您想要確定問題是什麼。

· 您想要建立一個測試案例,該案例描述了您使用預製語句時出現的問題,以便您編制程式錯誤報告。

· 您需要使用預製語句,但是您無法使用支援預製語句的程式設計API。

預製語句的SQL語法基於三個SQL語句:

PREPARE stmt_name FROM preparable_stmt;
EXECUTE stmt_name [USING @var_name [, @var_name] ...];
{DEALLOCATE | DROP} PREPARE stmt_name;

PREPARE語句用於預備一個語句,並賦予它名稱stmt_name,藉此在以後引用該語句。語句名稱對案例不敏感。preparable_stmt可以是一個文字字串,也可以是一個包含了語句文字的使用者變數。該文字必須展現一個單一的SQL語句,而不是多個語句。使用本語句,‘?’字元可以被用於製作引數,以指示當您執行查詢時,資料值在哪裡與查詢結合在一起。‘?’字元不應加引號,即使您想要把它們與字串值結合在一起,也不要加引號。引數製作符只能被用於資料值應該出現的地方,不用於SQL關鍵詞和識別符號等。

如果帶有此名稱的預製語句已經存在,則在新的語言被預備以前,它會被隱含地解除分配。這意味著,如果新語句包含一個錯誤並且不能被預備,則會返回一個錯誤,並且不存在帶有給定名稱語句。

預製語句的範圍是客戶端會話。在此會話內,語句被建立。其它客戶端看不到它。

在預備了一個語句後,您可使用一個EXECUTE語句(該語句引用了預製語句名稱)來執行它。如果預製語句包含任何引數製造符,則您必須提供一個列舉了使用者變數(其中包含要與引數結合的值)的USING子句。引數值只能有使用者變數提供,USING子句必須準確地指明使用者變數。使用者變數的數目與語句中的引數製造符的數量一樣多。

您可以多次執行一個給定的預製語句,在每次執行前,把不同的變數傳遞給它,或把變數設定為不同的值。

要對一個預製語句解除分配,需使用DEALLOCATE PREPARE語句。嘗試在解除分配後執行一個預製語句會導致錯誤。

如果您終止了一個客戶端會話,同時沒有對以前已預製的語句解除分配,則伺服器會自動解除分配。

以下SQL語句可以被用在預製語句中:CREATE TABLE, DELETE, DO, INSERT, REPLACE, SELECT, SET, UPDATE和多數的SHOW語句。目前不支援其它語句。

以下例子顯示了預備一個語句的兩種方法。該語句用於在給定了兩個邊的長度時,計算三角形的斜邊。

第一個例子顯示如何通過使用文字字串來建立一個預製語句,以提供語句的文字:

mysql> PREPARE stmt1 FROM 'SELECT SQRT(POW(?,2) + POW(?,2)) AS hypotenuse';
mysql> SET @a = 3;
mysql> SET @b = 4;
mysql> EXECUTE stmt1 USING @a, @b;
+------------+
| hypotenuse |
+------------+
|          5 |
+------------+
mysql> DEALLOCATE PREPARE stmt1;

第二個例子是相似的,不同的是提供了語句的文字,作為一個使用者變數:

mysql> SET @s = 'SELECT SQRT(POW(?,2) + POW(?,2)) AS hypotenuse';
mysql> PREPARE stmt2 FROM @s;
mysql> SET @a = 6;
mysql> SET @b = 8;
mysql> EXECUTE stmt2 USING @a, @b;
+------------+
| hypotenuse |
+------------+
|         10 |
+------------+
mysql> DEALLOCATE PREPARE stmt2;

對於已預備的語句,您可以使用位置保持符。以下語句將從tb1表中返回一行:

mysql> SET @a=1;

mysql> PREPARE STMT FROM "SELECT * FROM tbl LIMIT ?";

mysql> EXECUTE STMT USING @a;

以下語句將從tb1表中返回第二到第六行:

mysql> SET @skip=1; SET @numrows=5;

mysql> PREPARE STMT FROM "SELECT * FROM tbl LIMIT ?, ?";

mysql> EXECUTE STMT USING @skip, @numrows;

預製語句的SQL語法不能被用於帶巢狀的風格中。也就是說,被傳遞給PREPARE的語句本身不能是一個PREPARE, EXECUTE或DEALLOCATE PREPARE語句。

預製語句的SQL語法與使用預製語句API呼叫不同。例如,您不能使用mysql_stmt_prepare() C API函式來預備一個PREPARE, EXECUTE或DEALLOCATE PREPARE語句。

預製語句的SQL語法可以在已儲存的過程中使用,但是不能在已儲存的函式或觸發程式中使用。