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
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.