使用 MySQL C API 的應用程式會透過呼叫 mysql_bind_param() 函式來定義查詢屬性。請參閱 mysql_bind_param()。其他 MySQL 連接器也可能提供查詢屬性支援。請參閱個別連接器的文件。

mysql 用戶端具有 query_attributes 命令，可讓您定義最多 32 組屬性名稱和值。請參閱 第 6.5.1.2 節「mysql 用戶端命令」。

查詢屬性名稱會使用 character_set_client 系統變數所指示的字元集來傳輸。

若要存取已定義屬性的 SQL 陳述式中的查詢屬性，請安裝 query_attributes 元件，如使用查詢屬性的先決條件中所述。此元件會實作 mysql_query_attribute_string() 可載入函式，該函式會接受屬性名稱引數，並以字串形式傳回屬性值；如果屬性不存在，則傳回 NULL。請參閱 查詢屬性可載入函式。

下列範例使用 mysql 用戶端 query_attributes 命令來定義屬性名稱/值組，並使用 mysql_query_attribute_string() 函式依名稱存取屬性值。

此範例定義兩個名為 n1 和 n2 的屬性。第一個 SELECT 顯示如何擷取這些屬性，並示範擷取不存在的屬性 (n3) 會傳回 NULL。第二個 SELECT 顯示屬性不會跨陳述式持續存在。

mysql> query_attributes n1 v1 n2 v2;
mysql> SELECT
         mysql_query_attribute_string('n1') AS 'attr 1',
         mysql_query_attribute_string('n2') AS 'attr 2',
         mysql_query_attribute_string('n3') AS 'attr 3';
+--------+--------+--------+
| attr 1 | attr 2 | attr 3 |
+--------+--------+--------+
| v1     | v2     | NULL   |
+--------+--------+--------+

mysql> SELECT
         mysql_query_attribute_string('n1') AS 'attr 1',
         mysql_query_attribute_string('n2') AS 'attr 2';
+--------+--------+
| attr 1 | attr 2 |
+--------+--------+
| NULL   | NULL   |
+--------+--------+

如第二個 SELECT 陳述式所示，在指定陳述式之前定義的屬性僅適用於該陳述式，並且在陳述式執行後會清除。若要在多個陳述式中使用屬性值，請將其指派給變數。下列範例說明如何執行此操作，並示範屬性值可透過變數在後續陳述式中使用，但無法透過呼叫 mysql_query_attribute_string() 來使用。

mysql> query_attributes n1 v1 n2 v2;
mysql> SET
         @attr1 = mysql_query_attribute_string('n1'),
         @attr2 = mysql_query_attribute_string('n2');

mysql> SELECT
         @attr1, mysql_query_attribute_string('n1') AS 'attr 1',
         @attr2, mysql_query_attribute_string('n2') AS 'attr 2';
+--------+--------+--------+--------+
| @attr1 | attr 1 | @attr2 | attr 2 |
+--------+--------+--------+--------+
| v1     | NULL   | v2     | NULL   |
+--------+--------+--------+--------+

也可以將屬性儲存在資料表中，以便稍後使用

mysql> CREATE TABLE t1 (c1 CHAR(20), c2 CHAR(20));

mysql> query_attributes n1 v1 n2 v2;
mysql> INSERT INTO t1 (c1, c2) VALUES(
         mysql_query_attribute_string('n1'),
         mysql_query_attribute_string('n2')
       );

mysql> SELECT * FROM t1;
+------+------+
| c1   | c2   |
+------+------+
| v1   | v2   |
+------+------+

查詢屬性受限於下列限制和約束

若要存取已定義屬性的 SQL 陳述式中的查詢屬性，必須安裝 query_attributes 元件。請使用此陳述式執行此操作

INSTALL COMPONENT "file://component_query_attributes";

元件安裝是一次性的操作，無需在每次伺服器啟動時執行。INSTALL COMPONENT 會載入元件，並將其註冊在 mysql.component 系統資料表中，使其在後續伺服器啟動期間載入。

query_attributes 元件會存取查詢屬性，以實作 mysql_query_attribute_string() 函式。請參閱 第 7.5.4 節「查詢屬性元件」。

若要解除安裝 query_attributes 元件，請使用此陳述式

UNINSTALL COMPONENT "file://component_query_attributes";

UNINSTALL COMPONENT 會解除載入元件，並將其從 mysql.component 系統資料表中取消註冊，使其在後續伺服器啟動期間不會載入。

由於安裝和解除安裝 query_attributes 元件會安裝和解除安裝元件實作的 mysql_query_attribute_string() 函式，因此不需要使用 CREATE FUNCTION 或 DROP FUNCTION 來執行此操作。