Spec-Zone.ru › MySQL 9.2

11.5 Выражения

В этом разделе перечислены правила грамматики, которым должны следовать выражения в MySQL, и предоставлена дополнительная информация о типах элементов, которые могут появляться в выражениях.

  • Синтаксис выражений

  • Примечания к элементам выражения

  • Временные интервалы

Синтаксис выражений

Следующие правила грамматики определяют синтаксис выражений в MySQL. Данная грамматика основана на грамматике, представленной в файле sql/sql_yacc.yy дистрибутивов исходного кода MySQL. Для дополнительной информации о некоторых элементах выражений см. Примечания к элементам выражения.

expr:
    expr OR expr
  | expr || expr
  | expr XOR expr
  | expr AND expr
  | expr && expr
  | NOT expr
  | ! expr
  | boolean_primary IS [NOT] {TRUE | FALSE | UNKNOWN}
  | boolean_primary

boolean_primary:
    boolean_primary IS [NOT] NULL
  | boolean_primary <=> predicate
  | boolean_primary comparison_operator predicate
  | boolean_primary comparison_operator {ALL | ANY} (subquery)
  | predicate

comparison_operator: = | >= | > | <= | < | <> | !=

predicate:
    bit_expr [NOT] IN (subquery)
  | bit_expr [NOT] IN (expr [, expr] ...)
  | bit_expr [NOT] BETWEEN bit_expr AND predicate
  | bit_expr SOUNDS LIKE bit_expr
  | bit_expr [NOT] LIKE simple_expr [ESCAPE simple_expr]
  | bit_expr [NOT] REGEXP bit_expr
  | bit_expr

bit_expr:
    bit_expr | bit_expr
  | bit_expr & bit_expr
  | bit_expr << bit_expr
  | bit_expr >> bit_expr
  | bit_expr + bit_expr
  | bit_expr - bit_expr
  | bit_expr * bit_expr
  | bit_expr / bit_expr
  | bit_expr DIV bit_expr
  | bit_expr MOD bit_expr
  | bit_expr % bit_expr
  | bit_expr ^ bit_expr
  | bit_expr + interval_expr
  | bit_expr - interval_expr
  | simple_expr

simple_expr:
    literal
  | identifier
  | function_call
  | simple_expr COLLATE collation_name
  | param_marker
  | variable
  | simple_expr || simple_expr
  | + simple_expr
  | - simple_expr
  | ~ simple_expr
  | ! simple_expr
  | BINARY simple_expr
  | (expr [, expr] ...)
  | ROW (expr, expr [, expr] ...)
  | (subquery)
  | EXISTS (subquery)
  | {identifier expr}
  | match_expr
  | case_expr
  | interval_expr

Для приоритета операторов см. Раздел 14.4.1, «Приоритет операторов». Приоритет и значение некоторых операторов зависят от режима SQL:

  • По умолчанию, || является логическим OR оператором. При включенном режиме PIPES_AS_CONCAT, || является оператором конкатенации строк, с приоритетом между ^ и унарными операторами.

  • По умолчанию, ! имеет более высокий приоритет, чем NOT. При включенном режиме HIGH_NOT_PRECEDENCE, ! и NOT имеют одинаковый приоритет.

См. Раздел 7.1.11, «Режимы SQL сервера».

Примечания к элементам выражения

Для синтаксиса литеральных значений см. Раздел 11.1, «Литеральные значения».

Для синтаксиса идентификаторов см. Раздел 11.2, «Имена объектов схемы».

Переменные могут быть пользовательскими, системными или локальными переменными или параметрами хранимой программы:

  • Пользовательские переменные: Раздел 11.4, «Пользовательские переменные»

  • Системные переменные: Раздел 7.1.9, «Использование системных переменных»

  • Локальные переменные хранимой программы: Раздел 15.6.4.1, «Локальная переменная DECLARE»

  • Параметры хранимой программы: Раздел 15.1.18, «CREATE PROCEDURE и CREATE FUNCTION»

param_marker является ?, используемой в подготовленных запросах для плейсхолдеров. См. Раздел 15.5.1, «Выполнение PREPARE».

(subquery) указывает на подзапрос, возвращающий одно значение; то есть скалярный подзапрос. См. Раздел 15.2.15.1, «Подзапрос как скалярный операнд».

{identifier expr} - это синтаксис экранирования ODBC и поддерживается для совместимости с ODBC. Значение равно expr. Фигурные скобки { и } в синтаксисе должны быть написаны буквально; они не являются метасинтаксисом, как используется в других описаниях синтаксиса.

match_expr указывает выражение MATCH. См. Раздел 14.9, «Функции полнотекстового поиска».

case_expr указывает выражение CASE. См. Раздел 14.5, «Функции управления потоком».

interval_expr представляет временной интервал. См. Временные интервалы.

END_OF_DOCUMENT_MARKER

Временные интервалы

interval_expr в выражениях представляет временной интервал. Интервалы имеют такой синтаксис:

INTERVAL expr unit

expr представляет величину. unit представляет единицу измерения для интерпретации величины; это спецификатор, такой как HOUR, DAY или WEEK. Ключевое слово INTERVAL и спецификатор unit нечувствительны к регистру.

В следующей таблице показан ожидаемый формат аргумента expr для каждого значения unit.

Таблица 11.2 Аргументы временного интервала и единиц измерения

Таблица 11.2 Аргументы временного интервала и единиц измерения
unit Значение Ожидаемый формат expr
MICROSECOND MICROSECONDS
SECOND SECONDS
MINUTE MINUTES
HOUR HOURS
DAY DAYS
WEEK WEEKS
MONTH MONTHS
QUARTER QUARTERS
YEAR YEARS
SECOND_MICROSECOND 'SECONDS.MICROSECONDS'
MINUTE_MICROSECOND 'MINUTES:SECONDS.MICROSECONDS'
MINUTE_SECOND 'MINUTES:SECONDS'
HOUR_MICROSECOND 'HOURS:MINUTES:SECONDS.MICROSECONDS'
HOUR_SECOND 'HOURS:MINUTES:SECONDS'
HOUR_MINUTE 'HOURS:MINUTES'
DAY_MICROSECOND 'DAYS HOURS:MINUTES:SECONDS.MICROSECONDS'
DAY_SECOND 'DAYS HOURS:MINUTES:SECONDS'
DAY_MINUTE 'DAYS HOURS:MINUTES'
DAY_HOUR 'DAYS HOURS'
YEAR_MONTH 'YEARS-MONTHS'

MySQL допускает любые знаки препинания в качестве разделителей в формате expr. Предложенные разделители указаны в таблице.

Временные интервалы используются для определенных функций, таких как DATE_ADD() и DATE_SUB():

mysql> SELECT DATE_ADD('2018-05-01',INTERVAL 1 DAY);
        -> '2018-05-02'
mysql> SELECT DATE_SUB('2018-05-01',INTERVAL 1 YEAR);
        -> '2017-05-01'
mysql> SELECT DATE_ADD('2020-12-31 23:59:59',
    ->                 INTERVAL 1 SECOND);
        -> '2021-01-01 00:00:00'
mysql> SELECT DATE_ADD('2018-12-31 23:59:59',
    ->                 INTERVAL 1 DAY);
        -> '2019-01-01 23:59:59'
mysql> SELECT DATE_ADD('2100-12-31 23:59:59',
    ->                 INTERVAL '1:1' MINUTE_SECOND);
        -> '2101-01-01 00:01:00'
mysql> SELECT DATE_SUB('2025-01-01 00:00:00',
    ->                 INTERVAL '1 1:1:1' DAY_SECOND);
        -> '2024-12-30 22:58:59'
mysql> SELECT DATE_ADD('1900-01-01 00:00:00',
    ->                 INTERVAL '-1 10' DAY_HOUR);
        -> '1899-12-30 14:00:00'
mysql> SELECT DATE_SUB('1998-01-02', INTERVAL 31 DAY);
        -> '1997-12-02'
mysql> SELECT DATE_ADD('1992-12-31 23:59:59.000002',
    ->            INTERVAL '1.999999' SECOND_MICROSECOND);
        -> '1993-01-01 00:00:01.000001'

Временные арифметические операции также могут выполняться в выражениях с использованием INTERVAL вместе с оператором + или -:

date + INTERVAL expr unit
date - INTERVAL expr unit

INTERVAL expr unit разрешено по обе стороны оператора +, если выражение с другой стороны — значение даты или datetime. Для оператора - INTERVAL expr unit разрешено только справа, так как вычитание значения даты или datetime из интервала не имеет смысла.

mysql> SELECT '2018-12-31 23:59:59' + INTERVAL 1 SECOND;
        -> '2019-01-01 00:00:00'
mysql> SELECT INTERVAL 1 DAY + '2018-12-31';
        -> '2019-01-01'
mysql> SELECT '2025-01-01' - INTERVAL 1 SECOND;
        -> '2024-12-31 23:59:59'

Функция EXTRACT() использует те же виды спецификаторов unit, что и DATE_ADD() или DATE_SUB(), но извлекает части из даты, а не выполняет арифметические операции с датой:

mysql> SELECT EXTRACT(YEAR FROM '2019-07-02');
        -> 2019
mysql> SELECT EXTRACT(YEAR_MONTH FROM '2019-07-02 01:02:03');
        -> 201907

Временные интервалы могут использоваться в операторах CREATE EVENT:

CREATE EVENT myevent
    ON SCHEDULE AT CURRENT_TIMESTAMP + INTERVAL 1 HOUR
    DO
      UPDATE myschema.mytable SET mycol = mycol + 1;

Если вы задаёте значение интервала, которое слишком короткое (не включает все части интервала, которые ожидаются от ключевого слова unit), MySQL предполагает, что вы опустили самые левые части значения интервала. Например, если вы указываете unit DAY_SECOND, ожидается, что значение expr будет иметь части дней, часов, минут и секунд. Если вы указываете значение, такое как '1:10', MySQL предполагает, что части дней и часов отсутствуют, и значение представляет минуты и секунды. Другими словами, '1:10' DAY_SECOND интерпретируется так, что эквивалентно '1:10' MINUTE_SECOND. Это аналогично тому, как MySQL интерпретирует значения TIME как представляющие прошедшее время, а не как время суток.

expr обрабатывается как строка, поэтому будьте внимательны, если вы задаёте нестроковое значение с INTERVAL. Например, с указанием спецификатора интервала HOUR_MINUTE, '6/4' интерпретируется как 6 часов, 4 минуты, тогда как 6/4 вычисляется как 1.5000 и интерпретируется как 1 час, 5000 минут:

mysql> SELECT '6/4', 6/4;
        -> 1.5000
mysql> SELECT DATE_ADD('2019-01-01', INTERVAL '6/4' HOUR_MINUTE);
        -> '2019-01-01 06:04:00'
mysql> SELECT DATE_ADD('2019-01-01', INTERVAL 6/4 HOUR_MINUTE);
        -> '2019-01-04 12:20:00'

Для обеспечения интерпретации значения интервала в соответствии с вашими ожиданиями может быть использована операция CAST(). Для обработки 6/4 как 1 час, 5 минут, преобразуйте его в значение DECIMAL с одной дробной цифрой:

mysql> SELECT CAST(6/4 AS DECIMAL(3,1));
        -> 1.5
mysql> SELECT DATE_ADD('1970-01-01 12:00:00',
    ->                 INTERVAL CAST(6/4 AS DECIMAL(3,1)) HOUR_MINUTE);
        -> '1970-01-01 13:05:00'

Если вы добавляете или вычитаете из значения даты что-то, содержащее часть времени, результат автоматически преобразуется в значение datetime:

mysql> SELECT DATE_ADD('2023-01-01', INTERVAL 1 DAY);
        -> '2023-01-02'
mysql> SELECT DATE_ADD('2023-01-01', INTERVAL 1 HOUR);
        -> '2023-01-01 01:00:00'

Если вы добавляете MONTH, YEAR_MONTH или YEAR, и полученная дата имеет день, больший, чем максимальный день для нового месяца, день корректируется до максимального числа дней в новом месяце:

mysql> SELECT DATE_ADD('2019-01-30', INTERVAL 1 MONTH);
        -> '2019-02-28'

Арифметические операции с датой требуют полных дат и не работают с неполными датами, такими как '2016-07-00' или неправильно сформированными датами:

mysql> SELECT DATE_ADD('2016-07-00', INTERVAL 1 DAY);
        -> NULL
mysql> SELECT '2005-03-32' + INTERVAL 1 MONTH;
        -> NULL

© 2025 Oracle
Licensed under the GPLv2 License.
https://docs.oracle.com/cd/E17952_01/mysql-9.2-en/expressions.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API