exec

Comando que se usa para ejecutar una consulta de StackQL, ya sea como una instrucción o como un lote de instrucciones de un script de StackQL (archivo IQL).

---

Sintaxis

stackql exec [query] [flags]

---

Argumentos

Argumento	Descripción	Ejemplo
query	Consulta de StackQL que se va a realizar o comando que se va a ejecutar	"SELECT * FROM google.compute.instances WHERE project = 'myproject' AND zone = 'us-east1-a'" Tenga en cuenta que la consulta debe ir entre comillas simples o dobles

Opciones

Opción	Descripción
-o --output	Modo de salida, los valores válidos incluyen: table (valor predeterminado), json, jsonl (JSON delimitado por saltos de línea, ndjson se acepta como alias), csv, text y otel (registros de log de OpenTelemetry, consulte Modos de salida), ejemplo: --output jsonl
-i --infile	Ejecuta la consulta desde el archivo especificado si es necesario; si se especifica, se ignora cualquier consulta proporcionada como argumento, ejemplo: --infile myquery.iql
-q --iqldata	Datos de origen para el comando mediante un archivo json o jsonnet, ejemplo: --iqldata vars.jsonnet
--dryrun	Opción de ejecución de prueba; solo se ejecuta el preprocesador y se devuelve la salida
--var	Variables externas (pueden ser variables de entorno o secretos) que usan los archivos jsonnet especificados con la opción --iqldata, ejemplo --var region=${AWS_REGION}
-f --outfile	Archivo en el que se escriben los resultados si es necesario (el comportamiento predeterminado es mostrar los resultados solo en la consola), ejemplo --outfile myoutput.csv
-H --help	Muestra la información de ayuda
-v --verbose	Ejecuta las consultas en modo detallado con salida adicional enviada a stdout; si se selecciona la opción -f, esta información de log adicional se escribe en el archivo de salida junto con los resultados de la consulta

consulte Opciones globales para ver opciones adicionales

---

Ejemplos

Mostrar los resultados de la consulta en la consola en formato de tabla:

stackql exec "SHOW services IN google"

Mostrar los resultados de la consulta en la consola en formato json:

stackql exec "SHOW services IN google" -o json

Escribir los resultados de la consulta en un archivo en formato json:

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

Ejecutar una consulta desde un archivo de entrada (archivo IQL) y escribir los resultados en un archivo en formato json:

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

---

Estado de salida

exec termina con el estado 0 una vez procesada la entrada; los errores de las instrucciones individuales se escriben en la consola, por lo que los scripts deben inspeccionar la salida. A partir de v1.0 termina con el estado 1 cuando falla una instrucción de configuración SET o UNSET, cuando la gestión de accesos está habilitada y se rechaza una instrucción, o cuando una ejecución de IaC en versión preliminar informa de un recurso que ha fallado.