使用 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 来执行此操作。