Udostępnij za pośrednictwem

Jak używać dokumentacji SQL

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

W tym przewodniku opisano sposób odczytywania i nawigowania po dokumentacji języka SQL, w tym etykiet dostępności platformy i notacji składni.

Etykiety "Dotyczy"

Dokumentacja języka SQL obejmuje usługi Databricks SQL, Databricks Runtime i Wykaz aparatu Unity. Każdy artykuł zawiera etykietę "Dotyczy" w górnej części, która pokazuje, które produkty i wersje obsługują tę funkcję.

Odczytywanie etykiety

Etykieta Meaning
zaznacz pole wyboru oznaczone jako tak Sprawdzanie danych SQL usługi Databricks oznaczone jako tak Databricks Runtime Wszystkie wersje środowiska Databricks SQL i Databricks Runtime
zaznacz pole wyboru oznaczone jako tak Databricks SQL Tylko usługa Databricks SQL (nieobsługiwana w środowisku Databricks Runtime)
zaznacz pole wyboru oznaczone jako tak Sprawdzanie sql usługi Databricks oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze Wszystkie wersje usług Databricks SQL i Databricks Runtime 11.3 LTS i nowszych
zaznacz pole wyboru oznaczone jako tak Sprawdzanie bazy danych SQL w usłudze Databricks oznaczone jako tak Databricks Runtime 11.3 LTS i powyżej zaznacz pole wyboru oznaczone jako tak Tylko wykaz aparatu Unity Tylko wykaz aparatu Unity, wszystkie wersje usługi Databricks SQL i Databricks Runtime 11.3 LTS i nowsze

Etykiety na poziomie parametru

Niektóre artykuły zawierają etykietę "Dotyczy" u góry i dodatkowe etykiety dla określonych parametrów w artykule. Etykieta na poziomie parametru zastępuje etykietę na poziomie artykułu tylko dla tego parametru.

Przykład 1. Parametr wymaga minimalnej wersji środowiska Databricks Runtime

Etykieta artykułu: zaznacz pole wyboru yes Databricks SQL check oznaczone jako tak Databricks Runtime

Etykieta parametru: zaznacz pole wyboru yes Databricks SQL check oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

Oznacza to, że większość artykułu dotyczy wszystkich wersji środowiska Databricks SQL i Databricks Runtime, ale ten konkretny parametr wymaga środowiska Databricks Runtime 11.3 LTS lub nowszego.

Przykład 2: Parametr nie jest dostępny dla obciążeń usługi SQL Warehouse

Etykieta artykułu: zaznacz pole wyboru yes Databricks SQL check oznaczone jako tak Databricks Runtime

Etykieta parametru: zaznacz pole wyboru tak Dla środowiska Databricks Runtime 11.3 LTS lub nowszego

Oznacza to, że większość strony dotyczy wszystkich wersji obu produktów, ale ten konkretny parametr jest obsługiwany tylko w środowisku Databricks Runtime 11.3 LTS i nowszym (nieobsługiwane w usłudze Databricks SQL).

Diagramy składniowe

Instrukcje SQL są udokumentowane przy użyciu diagramów składni, które pokazują sposób konstruowania prawidłowych poleceń.

Podstawowe elementy

Diagramy składniowe używają tych podstawowych składników do reprezentowania instrukcji SQL. Po każdym składniku następuje przykład.

Keyword

Słowa kluczowe są wyświetlane wielkimi literami, ale nie są uwzględniane wielkości liter.

SELECT

Żeton

Znaki literału, które należy wprowadzić dokładnie tak, jak pokazano: (, , )<, >, ., , , *,

Klauzula

Klauzule są nazwane sekcjami składni. Wielkie litery klauzule (na przykład LIMIT clause) łączą się z ich dokumentacją. Małe litery klauzule z podkreśleniami (na przykład named_expression) są definiowane lokalnie.

LIMIT clause
named_expression

Argument

Argumenty funkcji używają camelCase i są opisane w sekcji Argumenty odwołania do funkcji SQL usługi Databricks.

mapExpr

Notacja składniowa

Symbole specjalne wskazują sposób łączenia, powtarzania lub pomijania składników.

Wymagana sekwencja

Składniki oddzielone białym znakiem muszą być wyświetlane w kolejności.

SELECT expr

Wybór obowiązkowy

Nawiasy klamrowe { } z | separatorami oznaczają, że musisz wybrać dokładnie jedną opcję.

{ INT | INTEGER }

Wybór opcjonalny

Nawiasy kwadratowe [ ] z | separatorami oznaczają, że można wybrać co najwyżej jedną opcję.

[ ASC | DESC ]

Grupowanie

Nawiasy klamrowe { } bez | średniej należy uwzględnić wszystkie składniki.

{ SELECT expr }

Opcjonalny element

Nawiasy kwadratowe [ ] oznaczają, że dołączony składnik jest opcjonalny.

[ NOT NULL ]

Powtórzenie

Wielokropek [...] oznacza, że można powtórzyć poprzedni składnik. Jeśli jest poprzedzony separatorem (, ...), należy użyć tego separatora między powtórzeniami.

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

Comments

Usługa Databricks SQL obsługuje komentarze w stylu C (/* ... */) i komentarze wiersza (-- ...).

  • Last updated on