Переменные, определённые пользователем, создаются локально в сеансе и существуют только в контексте этого сеанса; см. раздел 11.4, «Переменные, определённые пользователем».

Переменная, определённая пользователем, записывается как @var_name и ей присваивается значение выражения следующим образом:

SET @var_name = expr;

Примеры:

SET @name = 43;
SET @total_tax = (SELECT SUM(tax) FROM taxable_transactions);

Как показано в этих операторах, expr может варьироваться от простого (литеральное значение) до более сложного (значение, возвращаемое скалярным подзапросом).

Таблица user_variables_by_thread схемы Performance содержит информацию о переменных, определённых пользователем. См. раздел 29.12.10, «Таблицы переменных, определённых пользователем, Performance Schema».

SET применяется к параметрам и локальным переменным в контексте хранимого объекта, в котором они определены. Следующая процедура использует параметр процедуры increment и локальную переменную counter:

CREATE PROCEDURE p(increment INT)
BEGIN
  DECLARE counter INT DEFAULT 0;
  WHILE counter < 10 DO
    -- ... do work ...
    SET counter = counter + increment;
  END WHILE;
END;

Сервер MySQL поддерживает системные переменные, которые конфигурируют его работу. Системная переменная может иметь глобальное значение, влияющее на работу сервера в целом, сессионное значение, влияющее на текущую сессию, или оба значения. Многие системные переменные динамические и могут быть изменены во время выполнения с помощью оператора SET для воздействия на работу текущего экземпляра сервера. SET также может использоваться для сохранения некоторых системных переменных в файл mysqld-auto.cnf в каталоге данных, чтобы повлиять на работу сервера при последующих запусках.

Если оператор SET выдан для чувствительной системной переменной, запрос переписывается, чтобы заменить значение на “<redacted>” перед его записью в общий журнал и журнал аудита. Это происходит даже в том случае, если на экземпляре сервера не доступно защищенное хранение через компонент ключа.

Если вы изменяете сессионную системную переменную, значение сохраняется в вашей сессии до тех пор, пока вы не измените переменную на другое значение или сессия не закончится. Изменение не влияет на другие сессии.

Если вы изменяете глобальную системную переменную, значение запоминается и используется для инициализации сессионного значения для новых сессий до тех пор, пока вы не измените переменную на другое значение или сервер не завершит работу. Изменение видно для любого клиента, который обращается к глобальному значению. Однако изменение влияет на соответствующее сессионное значение только для клиентов, подключающихся после изменения. Изменение глобальной переменной не влияет на сессионное значение для любых текущих сессий клиентов (даже для сессии, в которой произошло изменение глобального значения).

Чтобы сделать настройку глобальной системной переменной постоянной, чтобы она применялась при перезапуске сервера, вы можете сохранить ее в файл mysqld-auto.cnf в каталоге данных. Также возможно внести постоянные изменения в конфигурацию, вручную изменив файл my.cnf, но это более сложно, и ошибка в вручную введенной настройке может не быть обнаружена до тех пор, пока не произойдет какое-нибудь другое действие. SET операторы, которые сохраняют системные переменные, более удобны и избегают возможности неправильных настроек, так как настройки со синтаксическими ошибками не выполняются и не изменяют конфигурацию сервера. Для получения дополнительной информации о сохранении системных переменных и файле mysqld-auto.cnf, см. Раздел 7.1.9.3, «Сохраненные системные переменные».

В следующем обсуждении описываются варианты синтаксиса для установки и сохранения системных переменных:

Чтобы установить значение глобальной системной переменной до значения по умолчанию MySQL или сессионной системной переменной до текущего соответствующего глобального значения, установите переменную в значение DEFAULT. Например, следующие два оператора идентичны по установке сессионного значения max_join_size до текущего глобального значения:

SET @@SESSION.max_join_size = DEFAULT;
SET @@SESSION.max_join_size = @@GLOBAL.max_join_size;

Использование SET для сохранения глобальной системной переменной в значение DEFAULT или до её значения по умолчанию присваивает переменной значение по умолчанию и добавляет настройку переменной в файл mysqld-auto.cnf. Чтобы удалить переменную из файла, используйте оператор RESET PERSIST.

Некоторые системные переменные не могут быть сохранены или ограничены при сохранении. См. Раздел 7.1.9.4, «Несохраняемые и ограниченные системные переменные».

Системная переменная, реализованная плагином, может быть сохранена, если плагин установлен, когда выполняется оператор SET. Назначение сохраненной переменной плагина вступает в силу для последующих перезапусков сервера, если плагин все еще установлен. Если плагин больше не установлен, переменная плагина больше не существует, когда сервер считывает файл mysqld-auto.cnf. В этом случае сервер записывает предупреждение в журнал ошибок и продолжает работу:

currently unknown variable 'var_name'
was read from the persisted config file

Чтобы отобразить имена и значения системных переменных:

Если присвоение значения переменной в операторе SET завершается ошибкой, весь оператор считается ошибочным, и никакие переменные не изменяются, а также не изменяется файл mysqld-auto.cnf.

Оператор SET генерирует ошибку в описанных выше обстоятельствах. Большинство примеров демонстрируют операторы SET с использованием ключевого синтаксиса (например, GLOBAL или SESSION), но принципы также справедливы для операторов с соответствующими модификаторами (например, @@GLOBAL. или @@SESSION.).

Оператор SET может содержать несколько присваиваний, разделенных запятыми. Этот оператор присваивает значения пользовательской переменной и системной переменной:

SET @x = 1, SESSION sql_mode = '';

Если вы задаёте несколько системных переменных в одном операторе, используется последний ключевой параметр GLOBAL, PERSIST, PERSIST_ONLY или SESSION в операторе для последующих присваиваний без указания ключа.

Примеры присвоения значений нескольким переменным:

SET GLOBAL sort_buffer_size = 1000000, SESSION sort_buffer_size = 1000000;
SET @@GLOBAL.sort_buffer_size = 1000000, @@LOCAL.sort_buffer_size = 1000000;
SET GLOBAL max_connections = 1000, sort_buffer_size = 1000000;

Модификаторы @@GLOBAL., @@PERSIST., @@PERSIST_ONLY., @@SESSION. и @@ применяются только к непосредственно следующей системной переменной, а не к остальным системным переменным. Этот оператор задаёт глобальное значение sort_buffer_size равным 50000 и сессионное значение равным 1000000:

SET @@GLOBAL.sort_buffer_size = 50000, sort_buffer_size = 1000000;

Чтобы обратиться к значению системной переменной в выражениях, используйте один из @@-модификаторов (кроме @@PERSIST. и @@PERSIST_ONLY., которые запрещены в выражениях). Например, вы можете получить значения системных переменных в операторе SELECT следующим образом:

SELECT @@GLOBAL.sql_mode, @@SESSION.sql_mode, @@sql_mode;