Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
Лексична структура
Див. також:
[ Ієрархія ресурсів StackQL ] [ Ключові слова ] [ Типи даних ] [ DESCRIBE ]
Лексична структура й граматика StackQL побудовані за зразком реалізації мови MySQL (адаптації стандарту ANSI SQL-92) з деякими розширеннями. Інструкції StackQL використовують, щоб виконувати запити до хмарних ресурсів (за допомогою граматики SELECT) або створювати, змінювати чи видаляти інфраструктуру за допомогою стандартних інструкцій мови маніпулювання даними (DML), як-от INSERT, UPDATE, REPLACE і DELETE. Крім того, операції, що не належать до DML, наприклад запуск екземпляра або отримання чи розміщення об'єкта в бакеті AWS S3, реалізовано як вбудовані процедури провайдера (подібні до збережених процедур у СКБД). Вбудовані процедури провайдера викликають за допомогою інструкції EXEC.
Предметно-орієнтована мова SQL у StackQL дає змогу програмувати інфраструктуру як декларативно, так і процедурно.
Синтаксис
Операції StackQL складаються з однієї або кількох інструкцій, що завершуються крапкою з комою (;). Інструкції містять ключові слова, ідентифікатори, параметри та значення; ось приклад інструкції StackQL, що створює диск на 10 ГБ у GCP:
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; перед плануванням інструкції його замінюють типізованим значенням змінної. '$region' в одинарних лапках - це рядковий літерал. У реченні FROM змінна $variable відповідає імені відношення, а IDENTIFIER($variable) у позиціях виразів відповідає імені стовпця. Шлях у подвійних лапках із префіксом долара, наприклад "$.auth.aws.password", - це ціль конфігурації середовища виконання, яку приймають SET і UNSET. Змінні сеансу доступні в StackQL v1.0 і новіших версіях, див. Змінні сеансу.
Оператори
|| - це оператор конкатенації рядків, який має вищий пріоритет, ніж оператори порівняння. OR - логічна диз'юнкція. Випуски StackQL до v1.0 розпізнавали || як лексему OR.
Коментарі
StackQL підтримує багаторядкові й однорядкові коментарі в інструкціях StackQL; приклади коментарів наведено нижче:
/* This
Is a
Multiline
Comment
*/
--This is an inline comment