Jak odczytać diagram składni

Dotyczy: Databricks SQL Databricks Runtime

W tej sekcji opisano różne wzorce składni używane w dokumentacji SQL.

Podstawowe składniki

• Słowo kluczowe
• Token
• Klauzula
• Argument

Słowo kluczowe

SELECT

Słowa kluczowe w języku SQL są zawsze pisane wielkimi literami w tym dokumencie, ale są niezależne od wielkości liter.

Żeton

( )
<  >
.
*
,

Język SQL zawiera nawiasy okrągłe ((, )), a także nawiasy kątowe (<, >), kropki (.), przecinki (,) i kilka innych znaków. Gdy te znaki znajdują się na diagramie składniowym, należy wprowadzić je w taki sposób, jak to jest.

Klauzula

LIMIT clause

SELECT named_expression

named_expression
  expression AS alias

Klauzula reprezentuje nazwaną podsekcję składni. Klauzula lokalna jest opisana na tym samym diagramie składniowym, który go wywołuje. Jeśli klauzula jest powszechna, łączy się ona z inną sekcją dokumentacji SQL usługi Databricks. Niektóre klauzule są znane ze swojej głównej części keyword i są przedstawiane z wielką literą, po której następuje klauzula. Inne klauzule są zawsze małymi literami i używają podkreślenia (_), jeśli jest to konieczne. Klauzule lokalne są w pełni wyjaśnione w poniższej sekcji. Wszystkie inne klauzule mają krótki opis z linkiem do strony głównej.

Argument

mapExpr

Argumenty funkcji są określane w camelCase. Język SQL usługi Databricks opisuje znaczenie argumentów w sekcji Argumenty.

Łańcuch tokenów

SELECT expr

Składniki rozdzielone białym znakiem muszą być wprowadzane w kolejności, bezwarunkowo i oddzielone tylko białym znakiem lub komentarzami. Usługa Databricks SQL obsługuje komentarze formularza /* ... */ (styl C) i -- ..., który rozciąga się na koniec wiersza.

Wybór

Określa rozwidlenie w składni.

Wybór obowiązkowy

{ INT | INTEGER }

Nawiasy klamrowe { ... } oznaczają, że należy określić dokładnie jeden z wielu elementów. Każdy wybór jest oddzielony elementem |.

Wybór opcjonalny

[ ASC | DESC ]

Nawiasy kwadratowe [ ... ] wskazują, że można wybrać co najwyżej jeden z wielu składników. Każdy wybór jest oddzielony elementem |.

Grupowanie

{ SELECT expr }

{ SELECT
 expr }

Nawiasy klamrowe { ... } określają, że należy podać wszystkie osadzone komponenty. Jeśli diagram składni obejmuje wiele wierszy, ten formularz wyjaśnia, że przedstawia tę samą składnię.

Opcja

[ NOT NULL ]

Nawiasy kwadratowe [...] określają, że ujęte składniki są opcjonalne.

Powtórzenie

col_option [...]

col_alias [, ...]

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

Notacja wielokropkowa [...] wskazuje, że można wielokrotnie powtarzać bezpośrednio poprzedzający składnik, grupowanie lub wybór. Jeśli wielokropek jest poprzedzony innym znakiem, takim jak oddzielona kropka [. ...]lub przecinek [, ...], należy oddzielić każde powtórzenie tym znakiem.