Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
Використання StackQL
StackQL має кілька режимів використання: інтерактивна оболонка StackQL, командний рядок StackQL з інструкціями StackQL або виконання однієї чи кількох інструкцій StackQL із вхідного файлу (файлу IQL). Кожен із цих режимів докладніше описано нижче:
- Використання інтерактивної оболонки StackQL (
stackql shell) - Використання утиліти командного рядка StackQL (
stackql exec) - Використання вхідного файлу (файлу IQL) (
stackql exec -i)
Використання інтерактивної оболонки StackQL
Оболонка StackQL надає інженерам інтерактивне середовище програмування для розгортання хмарних ресурсів і роботи з ними, а також дає змогу інтерактивно аналізувати (за допомогою інструкцій SELECT) їхнє хмарне середовище. Функціонально оболонка подібна до оболонки MySQL або інших оболонок REPL (Read Evaluate Print Loop). Оболонка приймає коректні інструкції StackQL і повертає результати користувачеві. Інструкції можуть займати кілька рядків і виконуються після введення завершальної крапки з комою.
Оболонку StackQL можна запустити командою shell, як показано нижче (відомості про автентифікацію провайдерів див. у StackQL Provider Registry):
# Launching the StackQL Interactive Shell
stackql shell --auth="${AUTH}"
Після запуску оболонки з автентифікацією для постачальника хмарних послуг ви можете виконувати запити StackQL (запити SELECT або операції DDL, тобто інфраструктура як код).
За замовчуванням оболонка StackQL повертає результати в табличному форматі, проте за допомогою прапорця --output доступні також формати виводу json, jsonl, csv, text і otel; див. Режими виводу.
Файл ініціалізації .stackqlrc
Значення за замовчуванням для параметрів команд StackQL, як-от формат виводу, можна встановити у файлі ініціалізації .stackqlrc. Якщо цей файл є в поточному каталозі, який використовує виконуваний файл StackQL, його буде завантажено автоматично; інакше на нього можна вказати за допомогою прапорця --configfile, як показано нижче:
# Specifying an Initialization (.stackqlrc) File
./stackql shell --configfile /tmp/.stackqlrc
Докладніше про параметри команд див. на сторінці Глобальні прапорці.
Використання утиліти командного рядка StackQL
Команди StackQL можна виконувати неінтерактивно за допомогою команди exec виконуваного файлу StackQL. У пакеті можна виконати кілька команд, якщо кожну окрему команду завершено крапкою з комою (;). Прапорці команд, як-от прапорець --output, можна вказати в командному рядку або у файлі ініціалізації .stackqlrc, описаному вище.
Вивід виконуваного файлу StackQL надсилається в stdout системи, яку ви використовуєте; цей вивід можна проаналізувати у скрипті BASH або PowerShell.
Ось приклад скрипту Windows PowerShell із командою StackQL:
$gcp_project = "stackql-demo"
$gcp_zone = "australia-southeast1-a"
$env:GOOGLE_CREDENTIALS = Get-Content -Raw "C:\tmp\stackql-demo.json"
Write-Output "Selecting instances in ${gcp_zone}..."
$query = "`"select id, name, machineType `
from google.compute.instances `
where project = '${gcp_project}' `
and zone = '${gcp_zone}';`""
$flags = "--output json"
$cmd = "stackql.exe exec"
$select = $cmd, $query, $flags -join " "
(iex $select | ConvertFrom-Json) | Out-GridView -Title 'StackQL Query Results'
Наведена вище команда PowerShell демонструє вибірку екземплярів Compute Engine з відображенням виводу за допомогою Out-GridView.
Використання вхідного файлу (файлу IQL)
Вхідні файли StackQL можна використовувати для виконання кількох команд, завершених крапкою з комою. Це ще один варіант неінтерактивного або пакетного програмування інфраструктури. Вхідний файл вказують за допомогою параметра -i або --infile, як показано нижче:
# create an iql file
echo "select id, name from google.compute.instances \
where project = 'stackql-demo' \
and zone = 'australia-southeast1-a'" > listinstances.iql
# execute an iql file
./stackql exec -i listinstances.iql \
--auth '{ "google": { "type": "service_account", "credentialsfilepath": "/mnt/c/tmp/stackql-demo.json" } }' \
--output json | jq '.[] | .name'