Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

exec

Команда для виконання запиту StackQL - як окремої інструкції або як пакета інструкцій зі скрипту StackQL (файлу IQL).


Синтаксис​

stackql exec [query] [flags]


Аргументи​

АргументОписПриклад
queryЗапит StackQL, який потрібно виконати,
або команда, яку потрібно запустити
"SELECT * FROM google.compute.instances
WHERE project = 'myproject' AND zone = 'us-east1-b'"
Зверніть увагу, що запит має бути взятий в одинарні або подвійні лапки

Прапорці​

ПрапорецьОпис
-o
--output
Режим виводу, допустимі значення: table (за замовчуванням), json, jsonl (JSON, розділений символами нового рядка; ndjson приймається як псевдонім), csv, text і otel (записи журналу OpenTelemetry, див. Режими виводу), приклад: --output jsonl
-i
--infile
Виконати запит із зазначеного файлу, якщо потрібно; якщо прапорець вказано, будь-який запит, переданий як аргумент, ігнорується, приклад: --infile myquery.iql
-q
--iqldata
Вхідні дані для команди з файлу json або jsonnet, приклад: --iqldata vars.jsonnet
--dryrunПрапорець пробного запуску; виконується лише препроцесор, і повертається його вивід
--varЗовнішні змінні (це можуть бути змінні середовища або секрети), які завантажують файли jsonnet, вказані за допомогою прапорця --iqldata, приклад: --var region=${AWS_REGION}
-f
--outfile
Файл, у який за потреби виводяться результати (за замовчуванням результати виводяться лише в консоль), приклад: --outfile myoutput.csv
-h
--help
Вивести довідку
-v
--verbose
Виконувати запити в докладному режимі з додатковим виводом у stdout; якщо вибрано параметр -f, ця додаткова інформація журналювання записується у файл виводу разом із результатами запиту


додаткові параметри див. на сторінці Глобальні прапорці


Приклади​

Виведення результатів запиту в консоль у форматі таблиці:

stackql exec "SHOW services IN google"

Виведення результатів запиту в консоль у форматі json:

stackql exec "SHOW services IN google" -o json

Виведення результатів запиту у файл у форматі json:

stackql exec "SHOW services IN google" -o json -f services.json

Виконання запиту з вхідного файлу (файлу IQL) з виведенням результатів у файл у форматі json:

stackql exec -i getservices.iql -o json -f services.json

Код завершення​

Команда exec завершується з кодом 0 після обробки вхідних даних; помилки окремих інструкцій виводяться в консоль, тому скрипти мають перевіряти вивід. Починаючи з v1.0, вона завершується з кодом 1, якщо інструкція конфігурації SET або UNSET завершується помилкою, якщо запуск IaC у попередній версії повідомляє про збій ресурсу, або, коли ввімкнено керування доступом, якщо будь-яка інструкція завершується помилкою чи відхиляється.