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 wielkich liter w tym dokumencie, ale są bez uwzględniania wielkości liter.

Token

( )
<  >
.
*
,

Język SQL zawiera nawiasy klamrowe ((, )), a także nawiasy klamrowe (<, >), 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ą odwołania sql usługi Databricks. Niektóre klauzule są znane przez ich główne keyword i są przedstawiane ze słowem kluczowym capital, po którym następuje klauzula . Inne klauzule są zawsze małymi literami i używają podkreślenia () w_ odpowiednich przypadkach. 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 składnikó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 składniki osadzone. 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 [...] wielokropka wskazuje, że można powtórzyć bezpośrednio poprzedni składnik, grupowanie lub wybór wiele razy. Jeśli wielokropek jest poprzedzony innym znakiem, takim jak oddzielona kropka [. ...]lub przecinek [, ...], należy oddzielić każde powtórzenie tym znakiem.