Лексическая структура

Рассмотрим следующий пример:

SELECT * FROM table

Этот запрос содержит четыре токена: SELECT, *, FROM и table. Три первых, а именно SELECT, * и FROM, являются ключевыми словами, то есть словами, имеющими фиксированное значение в SQL. Токен table является идентификатором, то есть он идентифицирует (по имени) сущность внутри SQL, такую как таблица (в данном случае), столбец и т. д.

Как видно, ключевые слова и идентификаторы имеют одинаковую лексическую структуру, и поэтому невозможно определить, является ли токен одним из них или другим, не зная языка SQL; полный список ключевых слов доступен в приложении резервированных слов. Обратите внимание, что ключевые слова нечувствительны к регистру, что означает, что предыдущий пример можно записать как:

select * fRoM table;

Идентификаторы, однако, не являются нечувствительными к регистру — так как Elasticsearch чувствителен к регистру, Elasticsearch SQL использует полученное значение без изменений.

Для лучшего различения между ними в документации ключевые слова SQL пишутся с заглавных букв — это соглашение, которое, по нашему мнению, повышает читаемость, и мы рекомендуем его использовать другим.

Идентификаторы могут быть двух типов: с кавычками и без кавычек:

SELECT ip_address FROM "hosts-*"

В этом запросе два идентификатора, ip_address и hosts-* (шаблон индекса). Поскольку ip_address не конфликтует ни с одним ключевым словом, его можно использовать без изменений, hosts-*, с другой стороны, нельзя, так как он конфликтует с - (операцией вычитания) и *, поэтому он заключен в двойные кавычки.

Другой пример:

SELECT "from" FROM "<logstash-{now/d}>"

Первый идентификатор должен быть заключен в кавычки, так как в противном случае он конфликтует с ключевым словом FROM (которое нечувствительно к регистру и поэтому может быть записано как from), а второй идентификатор с использованием Elasticsearch поддержки даты и времени в именах индексов и псевдонимов индексов в противном случае мог бы сбить с толку парсер.

Поэтому, в целом, особенно при работе с пользовательским вводом, крайне рекомендуется использовать кавычки для идентификаторов. Это незначительно увеличивает запросы, но в то же время повышает ясность и устраняет неоднозначность.

Elasticsearch SQL поддерживает два типа неявно типизированных литералов: строки и числа.

Строковый литерал — это произвольное количество символов, заключённых в одинарные кавычки ': 'Giant Robot'. Чтобы включить одинарную кавычку в строку, экранируйте её с помощью другой одинарной кавычки: 'Captain EO''s Voyage'.

Числовые литералы принимаются как в десятичном, так и в научном формате с маркером показателя степени (e или E), начиная либо с цифры, либо с десятичной точки .:

1969    -- integer notation
3.14    -- decimal notation
.1234   -- decimal notation starting with decimal point
4E5     -- scientific notation (with exponent marker)
1.2e-3  -- scientific notation with decimal point

Числовые литералы, содержащие десятичную точку, всегда интерпретируются как имеющие тип double. Те, что без неё, считаются integer, если они помещаются, в противном случае их тип равен long (или BIGINT в типах ANSI SQL).

При работе с литералами произвольного типа объект создаётся путём приведения, как правило, строкового представления к нужному типу. Это можно сделать с помощью специального оператора приведения типов и функций:

123::LONG                                   -- cast 123 to a LONG
CAST('1969-05-13T12:34:56' AS TIMESTAMP)    -- cast the given string to datetime
CONVERT('10.0.0.1', IP)                     -- cast '10.0.0.1' to an IP

Обратите внимание, что Elasticsearch SQL предоставляет функции, которые из коробки возвращают популярные литералы (например, E()) или предоставляют специализированный парсинг для определённых строк.

Стоит отметить, что в SQL одинарные кавычки ' и двойные кавычки " имеют разное значение и не могут использоваться взаимозаменяемо. Одинарные кавычки используются для объявления строкового литерала строкового литерала, а двойные кавычки — для идентификаторов.

Например:

SELECT "first_name" 
  FROM "musicians"  
 WHERE "last_name"  
     = 'Carroll'    

Несколько символов, которые не являются буквенно-цифровыми, имеют специальное значение, отличное от значения оператора. Для полноты эти символы перечислены ниже:

Большинство операторов в Elasticsearch SQL имеют одинаковый приоритет и являются левоассоциативными. Поскольку это делается во время парсинга, для принудительного изменения приоритета необходимо использовать скобки.

В следующей таблице указаны поддерживаемые операторы и их приоритет (от самого высокого к самому низкому);

Elasticsearch SQL позволяет использовать комментарии, которые представляют собой последовательность символов, игнорируемых анализаторами.

Поддерживаются два стиля:

-- single line comment
/* multi
   line
   comment
   that supports /* nested comments */
   */