Как читать схему синтаксиса

Область применения: Databricks SQL Databricks Runtime

В этом разделе описываются различные шаблоны синтаксиса, используемые в справочнике по SQL.

Базовые компоненты

• Ключевое слово
• токен.
• Положение
• Argument

Ключевое слово

SELECT

В этом документе ключевые слова в SQL всегда пишутся прописными буквами, но они не чувствительны к регистру.

Токен

( )
<  >
.
*
,

Язык SQL включает круглые скобки ((, )), а также угловые скобки (<, >), точки (.), запятые (,) и некоторые другие символы. Если эти символы представлены в синтаксической диаграмме, их необходимо вводить как есть.

Предложение

LIMIT clause

SELECT named_expression

named_expression
  expression AS alias

Предложение представляет именованный подраздел синтаксиса. Локальное предложение описывается в той же синтаксической диаграмме, в которой оно вызывается. Если условие является распространенным, оно ведет к ссылке на другой раздел справочника по Databricks SQL. Некоторые предложения известны по своему основному ключевому слову (keyword) и изображаются с помощью ключевого слова, написанного прописными буквами, за которым следует предложение. Другие предложения всегда имеют нижний регистр и при необходимости используют подчеркивание (_). Полное описание локальных предложений приведено в следующем разделе. Все остальные предложения содержат краткое описание и ссылку на их главную страницу.

Аргумент

mapExpr

Аргументы функций указываются в "верблюжьем" стиле. Значение аргументов в Databricks SQL описывается в разделе "Аргументы".

Цепочка токенов

SELECT expr

Компоненты, разделенные пробелами, всегда следует вводить в определенном порядке и разделять только пробелами или комментариями. Databricks SQL поддерживает комментарии в формате /* ... */ (стиль C) и -- ..., который распространяется до конца строки.

Выбор

Указывает ответвление в синтаксисе.

Обязательный вариант

{ INT | INTEGER }

Фигурные скобки { ... } означают, что необходимо указать именно один из нескольких компонентов. Каждый вариант отделяется символом |.

Необязательный вариант

[ ASC | DESC ]

Квадратные скобки [ ... ] означают, что можно выбрать максимум один из нескольких компонентов. Каждый вариант отделяется символом |.

Группировка

{ SELECT expr }

{ SELECT
 expr }

Фигурные скобки { ... } указывают, что необходимо предоставить все внедренные компоненты. Если синтаксическая диаграмма охватывает несколько строк, эта форма указывает на то, что в ней показан один и тот же синтаксис.

Вариант

[ NOT NULL ]

Квадратные скобки [...] указывают, что заключенные в них компоненты являются необязательными.

Повторение

col_option [...]

col_alias [, ...]

{ expr [ AS ] col_alias } [, ...]

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