Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
exec
Команда для виконання запиту StackQL - як окремої інструкції або як пакета інструкцій зі скрипту StackQL (файлу IQL).
Синтаксис
stackql exec [query] [flags]
Аргументи
| Аргумент | Опис | Приклад |
|---|---|---|
query | Запит StackQL, який потрібно виконати, або команда, яку потрібно запустити | "SELECT * FROM google.compute.instancesWHERE 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 у попередній версії повідомляє про збій ресурсу, або, коли ввімкнено керування доступом, якщо будь-яка інструкція завершується помилкою чи відхиляється.