Jak používat referenční informace k SQL

Platí pro: Databricks SQL Databricks Runtime

Tato příručka vysvětluje, jak číst a procházet referenční informace k jazyku SQL, včetně popisků dostupnosti platformy a zápisu syntaxe.

Popisky "Platí pro"

Referenční informace k SQL se týkají Databricks SQL, Databricks Runtime a katalogu Unity. Každý článek obsahuje popisek "Platí pro" v horní části, který ukazuje, které produkty a verze tuto funkci podporují.

Čtení popisku

Označení	Význam
Kontrola SQL Databricks Databricks Runtime	Všechny verze Databricks SQL i Databricks Runtime
Databricks SQL	Pouze Databricks SQL (nepodporuje se v Databricks Runtime)
Kontrola SQL Databricks Databricks Runtime 11.3 LTS a vyšší	Všechny verze Databricks SQL a Databricks Runtime 11.3 LTS a novější
Kontrola SQL Databricks Databricks Runtime 11.3 LTS a vyšší ano Unity Catalog	Pouze katalog Unity, všechny verze Databricks SQL a Databricks Runtime 11.3 LTS a novější

Popisky na úrovni parametrů

Některé články obsahují popisek "Platí pro" v horní části a další popisky pro konkrétní parametry v článku. Popisek na úrovni parametru přepíše popisek na úrovni článku pouze pro tento parametr.

Příklad 1: Parametr vyžaduje minimální verzi databricks Runtime.

Popisek článku: Kontrola SQL Databricks Databricks Runtime

Popisek parametru: Kontrola SQL Databricks Databricks Runtime 11.3 LTS a vyšší

To znamená, že většina článku platí pro všechny verze Databricks SQL i Databricks Runtime, ale tento konkrétní parametr vyžaduje Databricks Runtime 11.3 LTS nebo novější.

Příklad 2: Parametr není k dispozici pro úlohy SQL Warehouse

Popisek článku: Kontrola SQL Databricks Databricks Runtime

Popisek parametru: Databricks Runtime 11.3 LTS a vyšší

To znamená, že většina stránky platí pro všechny verze obou produktů, ale tento konkrétní parametr je podporován pouze v Databricks Runtime 11.3 LTS a novější (nepodporuje se v Databricks SQL).

---

Diagramy syntaxe

Příkazy SQL jsou zdokumentované pomocí diagramů syntaxe, které ukazují, jak vytvořit platné příkazy.

Základní prvky

Diagramy syntaxe používají tyto základní komponenty k reprezentaci příkazů SQL. Za každou komponentou následuje příklad.

Keyword

Klíčová slova se zobrazují velkými písmeny, ale nerozlišují velká a malá písmena.

SELECT

Žeton

Literální znaky, které musíte zadat přesně tak, jak je znázorněno: (, ), <>, ., , *,

Clause

Klauzule jsou pojmenované oddíly syntaxe. Velká písmena (například LIMIT clause) odkazují na jejich dokumentaci. Místně se definují malá písmena s podtržítky (například named_expression).

LIMIT clause
named_expression

Argument

Argumenty funkce používají camelCase a jsou popsány v části Argumenty odkazu na funkci SQL Databricks.

mapExpr

Zápis syntaxe

Speciální symboly označují, jak lze komponenty kombinovat, opakovat nebo vynechat.

Požadovaná posloupnost

Součásti oddělené prázdným znakem musí být uvedeny v pořadí.

SELECT expr

Povinná volba

Složené složené závorky { } s | oddělovači znamenají, že musíte vybrat přesně jednu možnost.

{ INT | INTEGER }

Volitelná volba

Hranaté závorky [ ] s | oddělovači znamenají, že můžete zvolit maximálně jednu možnost.

[ ASC | DESC ]

Seskupení

Složené složené závorky { } bez | střední hodnoty musíte zahrnout všechny komponenty.

{ SELECT expr }

Volitelný prvek

Hranaté závorky [ ] znamenají, že uzavřená součást je volitelná.

[ NOT NULL ]

Repetition (Opakování)

Tři tečky [...] znamenají, že předchozí komponentu můžete opakovat. Pokud předchází oddělovač (, ...), musíte tento oddělovač použít mezi opakováním.

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

---

Comments

Databricks SQL podporuje komentáře ve stylu C (/* ... */) a řádkové komentáře (-- ...).