Приложения, использующие MySQL C API, определяют атрибуты запроса, вызывая функцию . См. . Другие 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 для этого.