Jak odczytać diagram składni
Dotyczy:
wyboru SQL usługi Databricks Databricks Runtime
W tej sekcji opisano różne wzorce składni używane w dokumentacji języka SQL.
Składniki podstawowe
Słowa kluczowego
SELECT
Słowa kluczowe w języku SQL są zawsze wielkich liter w tym dokumencie, ale nie są uwzględniane wielkości liter.
Tokenu
( )
< >
.
*
,
Język SQL zawiera okrągłe nawiasy klamrowe ((, )), nawiasy klamrowe (<, >), kropki (.), przecinki (,) i kilka innych znaków. Jeśli te znaki są obecne na diagramie składniowym, należy je wprowadzić 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 ją 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 główne keyword i są przedstawiane za pomocą słowa kluczowego capital, po którym następuje klauzula . Inne klauzule są zawsze małymi literami i używają podkreślenia () tam_, gdzie 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 rozdzielane 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.
Obowiązkowy wybór
{ INT | INTEGER }
Nawiasy klamrowe { ... } oznaczają, że należy określić dokładnie jeden z wielu składników.
Każdy wybór jest oddzielony znakami |.
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 znakami |.
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órzenia
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.