exec

Befehl zum Ausführen einer StackQL-Abfrage, entweder als einzelne Anweisung oder als Stapel von Anweisungen aus einem StackQL-Skript (IQL-Datei).

---

Syntax

stackql exec [query] [flags]

---

Argumente

Argument	Beschreibung	Beispiel
query	Auszuführende StackQL-Abfrage oder auszuführender Befehl	"SELECT * FROM google.compute.instances WHERE project = 'myproject' AND zone = 'us-east1-a'" Beachten Sie, dass die Abfrage in einfache oder doppelte Anführungszeichen eingeschlossen sein muss

Flags

Flag	Beschreibung
-o --output	Ausgabemodus, gültige Werte sind: table (Standard), json, jsonl (zeilengetrenntes JSON, ndjson wird als Alias akzeptiert), csv, text und otel (OpenTelemetry-Log-Records, siehe Ausgabemodi), Beispiel: --output jsonl
-i --infile	Führt die Abfrage bei Bedarf aus der angegebenen Datei aus; ist das Flag gesetzt, wird eine als Argument übergebene Abfrage ignoriert, Beispiel: --infile myquery.iql
-q --iqldata	Quelldaten für den Befehl aus einer json- oder jsonnet-Datei, Beispiel: --iqldata vars.jsonnet
--dryrun	Dry-Run-Flag; nur der Präprozessor wird ausgeführt und die Ausgabe wird zurückgegeben
--var	Externe Variablen (können Umgebungsvariablen oder Secrets sein), die von den mit dem Flag --iqldata angegebenen jsonnet-Dateien eingelesen werden, Beispiel --var region=${AWS_REGION}
-f --outfile	Datei, in die die Ergebnisse bei Bedarf geschrieben werden (standardmäßig werden die Ergebnisse nur auf der Konsole ausgegeben), Beispiel --outfile myoutput.csv
-H --help	Hilfeinformationen ausgeben
-v --verbose	Führt Abfragen im ausführlichen Modus mit zusätzlicher Ausgabe auf stdout aus; ist die Option -f gewählt, werden diese zusätzlichen Protokollinformationen zusammen mit den Abfrageergebnissen in die Ausgabedatei geschrieben

weitere Optionen finden Sie unter Globale Flags

---

Beispiele

Abfrageergebnisse im Tabellenformat auf der Konsole ausgeben:

stackql exec "SHOW services IN google"

Abfrageergebnisse im json-Format auf der Konsole ausgeben:

stackql exec "SHOW services IN google" -o json

Abfrageergebnisse im json-Format in eine Datei ausgeben:

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

Abfrage aus einer Eingabedatei (IQL-Datei) ausführen und die Ergebnisse im json-Format in eine Datei ausgeben:

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

---

Exit-Status

exec beendet sich mit Status 0, sobald die Eingabe verarbeitet wurde; Fehler einzelner Anweisungen werden auf die Konsole geschrieben, Skripte sollten daher die Ausgabe prüfen. Ab v1.0 beendet es sich mit Status 1, wenn eine SET- oder UNSET-Konfigurationsanweisung fehlschlägt, wenn die Zugriffsverwaltung aktiviert ist und eine Anweisung verweigert wird, oder wenn ein Preview-IaC-Lauf eine fehlgeschlagene Ressource meldet.