Jak číst diagram syntaxe

  • Článek

Platí pro:zaškrtnutá možnost Ano , kontrola Databricks SQL označená ano Databricks Runtime

Tato část popisuje různé vzory syntaxe používané v referenčních informacích k SQL.

Základní komponenty

Klíčové slovo

SELECT

Klíčová slova v SQL jsou v tomto dokumentu vždy velká a malá písmena, ale nerozlišují se u nich velká a malá písmena.

Token

( )
<  >
.
*
,

Jazyk SQL obsahuje kulaté složené závorky ((, )) i šikmé složené závorky (<, >), tečky (.), čárky (,) a několik dalších znaků. Pokud se tyto znaky nacházejí v diagramu syntaxe, musíte je zadat tak, jak jsou.

Klauzule

LIMIT clause

SELECT named_expression

named_expression
  expression AS alias

Klauzule představuje pojmenovanou podsekci syntaxe. Místní klauzule je popsána ve stejném diagramu syntaxe, který ji vyvolává. Pokud je klauzule běžná, odkazuje na jinou část odkazu Databricks SQL. Některé klauzule jsou známé podle hlavní keyword klauzule a jsou znázorněny klíčovým slovem velkého písmena, za kterým následuje klauzule. Ostatní klauzule mají vždy malá písmena a tam, kde je to vhodné, používají podtržítko (_). Místní klauzule jsou plně vysvětlené v následující části. Všechny ostatní klauzule mají krátký popis s odkazem na hlavní stránku.

Argument

mapExpr

Argumenty pro funkce jsou zadány v camelCase. Databricks SQL popisuje význam argumentů v části Argumenty.

Řetězec tokenů

SELECT expr

Součásti oddělené prázdnými znaky musí být zadány v pořadí bezpodmínečně a musí být odděleny pouze prázdnými znaky nebo komentáři. Databricks SQL podporuje komentáře formuláře /* ... */ (styl C) a -- ..., které přesahují až na konec řádku.

Volba

Určuje fork v syntaxi .

Povinná volba

{ INT | INTEGER }

Složené závorky { ... } znamenají, že musíte zadat přesně jednu z více součástí. Každá volba je oddělena |.

Volitelná volba

[ ASC | DESC ]

Hranaté závorky [ ... ] označují, že si můžete vybrat maximálně jednu z více součástí. Každá volba je oddělena |.

Seskupení

{ SELECT expr }

{ SELECT
 expr }

Složené závorky { ... } určují, že je nutné zadat všechny vložené součásti. Pokud diagram syntaxe přesahuje více řádků, tento formulář objasňuje, že znázorňuje stejnou syntaxi.

Možnost

[ NOT NULL ]

Hranaté závorky [...] určují, že uzavřené součásti jsou volitelné.

Opakování

col_option [...]

col_alias [, ...]

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

Zápis [...] se třemi tečkami označuje, že bezprostředně předcházející komponentu, seskupení nebo volbu můžete opakovat vícekrát. Pokud tři tečky předchází jiný znak, například oddělená tečka [. ...]nebo čárka [, ...], musíte každé opakování oddělit tímto znakem.