# Лексична структура

> Лексична структура StackQL: як синтаксичний аналізатор розбиває на лексеми інструкції, ідентифікатори, лапки, літерали, коментарі та пробільні символи.

Source: https://stackql.io/uk/language-spec/lexical-structure

Див. також:  
[[ Ієрархія ресурсів StackQL ]](/getting-started/resource-hierarchy) [[ Ключові слова ]](/language-spec/keywords) [[ Типи даних ]](/language-spec/data-types) [[ DESCRIBE ]](/language-spec/describe)

Лексична структура й граматика StackQL побудовані за зразком реалізації мови MySQL (адаптації стандарту ANSI SQL-92) з деякими розширеннями.  Інструкції StackQL використовують, щоб виконувати запити до хмарних ресурсів (за допомогою граматики `SELECT`) або створювати, змінювати чи видаляти інфраструктуру за допомогою стандартних інструкцій мови маніпулювання даними (DML), як-от `INSERT`, `UPDATE`, `REPLACE` і `DELETE`.  Крім того, операції, що не належать до DML, наприклад запуск екземпляра або отримання чи розміщення об'єкта в бакеті AWS S3, реалізовано як вбудовані процедури провайдера (подібні до збережених процедур у СКБД).  Вбудовані процедури провайдера викликають за допомогою інструкції `EXEC`.

Предметно-орієнтована мова SQL у StackQL дає змогу програмувати інфраструктуру як декларативно, так і процедурно.

* * * 

## Синтаксис
Операції StackQL складаються з однієї або кількох інструкцій, що завершуються крапкою з комою (`;`).  Інструкції містять ключові слова, ідентифікатори, параметри та значення; ось приклад інструкції StackQL, що створює диск на 10 ГБ у GCP:

```sql
INSERT INTO google.compute.disks (project, zone, name, sizeGb)
SELECT 'myProject', 'australia-southeast1-a', 'my10GbDisk', 10;
```

У наведеному вище прикладі _`INSERT`_, _`INTO`_ і _`SELECT`_ - це ключові слова, _google.compute.disks_ - ідентифікатор, _project_, _zone_, _name_, _sizeGb_ - параметри, а _'myProject'_, _'australia-southeast1-a'_, _'my10GbDisk'_, _10_ - значення.

## Ключові слова
Ключові слова обробляються без урахування регістру, тобто `INSERT` і `insert` рівнозначні, проте за домовленістю їх часто пишуть великими літерами. Повний список ключових слів наведено в розділі "Ключові слова".

## Ідентифікатори
Ідентифікатори - це символи, що позначають об'єкти в ієрархії ресурсів постачальника хмарних послуг.  Ідентифікатори складаються з кількох частин; докладніше про ідентифікатори див. у розділі "Ієрархія ресурсів StackQL".

## Параметри та значення
Параметри визначає ресурс; їх можна знайти за допомогою інструкції `DESCRIBE` для відповідного ресурсу постачальника хмарних послуг.  Значення - це типізовані скалярні або складні об'єкти, що відповідають параметрам.  Докладніше про параметри та значення див. у розділах `DESCRIBE` і "Типи даних".

## Змінні
Ідентифікатор із префіксом долара, наприклад `$region`, виконує розіменування змінної сеансу, якій присвоєно значення за допомогою [`SET`](/language-spec/set); перед плануванням інструкції його замінюють типізованим значенням змінної.  `'$region'` в одинарних лапках - це рядковий літерал.  У реченні `FROM` змінна `$variable` відповідає імені відношення, а `IDENTIFIER($variable)` у позиціях виразів відповідає імені стовпця.  Шлях у подвійних лапках із префіксом долара, наприклад `"$.auth.aws.password"`, - це ціль конфігурації середовища виконання, яку приймають `SET` і `UNSET`.  Змінні сеансу доступні в StackQL `v1.0` і новіших версіях, див. [Змінні сеансу](/getting-started/session-variables).

## Оператори
`||` - це оператор конкатенації рядків, який має вищий пріоритет, ніж оператори порівняння.  `OR` - логічна диз'юнкція.  Випуски StackQL до `v1.0` розпізнавали `||` як лексему `OR`.

## Коментарі
StackQL підтримує багаторядкові й однорядкові коментарі в інструкціях StackQL; приклади коментарів наведено нижче:

```sql
/* This
Is a
Multiline
Comment
*/

--This is an inline comment
```
