使用 MySQL C API 的应用程序通过调用该mysql_bind_param() 函数来定义查询属性。请参阅mysql_bind_param()。其他 MySQL 连接器也可能提供查询属性支持。请参阅各个连接器的文档。

mysql客户端有一个 命令 ，query_attributes最多可以定义 32 对属性名称和值。请参阅 第 4.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() 功能。请参阅第 5.5.4 节，“查询属性组件”。

要卸载该query_attributes组件，请使用以下语句：

UNINSTALL COMPONENT "file://component_query_attributes";

UNINSTALL COMPONENT卸载组件，并从 mysql.component系统表中注销它，以使其在后续服务器启动期间不被加载。

因为安装和卸载 query_attributes组件就是安装和卸载 mysql_query_attribute_string() 组件实现的功能，所以没有必要使用CREATE FUNCTION或 DROP FUNCTION 这样做。