Приложения, использующие 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 для этого.