Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

exec

Comando usado para executar uma consulta do StackQL, seja como uma instrução, seja como um lote de instruções de um script do StackQL (arquivo IQL).


Sintaxe​

stackql exec [query] [flags]


Argumentos​

ArgumentoDescriçãoExemplo
queryConsulta do StackQL a ser realizada
ou comando a ser executado
"SELECT * FROM google.compute.instances
WHERE project = 'myproject' AND zone = 'us-east1-a'"
Observe que a consulta deve estar entre aspas simples ou duplas

Opções​

OpçãoDescrição
-o
--output
Modo de saída, os valores válidos incluem: table (valor padrão), json, jsonl (JSON delimitado por quebras de linha, ndjson é aceito como alias), csv, text e otel (registros de log do OpenTelemetry, consulte Modos de saída), exemplo: --output jsonl
-i
--infile
Executa a consulta a partir do arquivo especificado, se necessário; se ele for especificado, qualquer consulta fornecida como argumento é ignorada, exemplo: --infile myquery.iql
-q
--iqldata
Dados de origem para o comando, usando um arquivo json ou jsonnet, exemplo: --iqldata vars.jsonnet
--dryrunOpção de execução de teste; somente o pré-processador é executado e a saída é retornada
--varVariáveis externas (podem ser variáveis de ambiente ou segredos) usadas pelos arquivos jsonnet especificados com a opção --iqldata, exemplo --var region=${AWS_REGION}
-f
--outfile
Arquivo no qual os resultados são gravados, se necessário (o comportamento padrão é exibir os resultados somente no console), exemplo --outfile myoutput.csv
-h
--help
Exibe as informações de ajuda
-v
--verbose
Executa as consultas no modo detalhado, com saída adicional enviada para stdout; se a opção -f for selecionada, essas informações de log adicionais são gravadas no arquivo de saída junto com os resultados da consulta


consulte Opções globais para ver opções adicionais


Exemplos​

Exibir os resultados da consulta no console em formato de tabela:

stackql exec "SHOW services IN google"

Exibir os resultados da consulta no console em formato json:

stackql exec "SHOW services IN google" -o json

Gravar os resultados da consulta em um arquivo em formato json:

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

Executar uma consulta a partir de um arquivo de entrada (arquivo IQL), gravando os resultados em um arquivo em formato json:

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

Status de saída​

exec termina com o status 0 depois que a entrada é processada; os erros de instruções individuais são gravados no console, portanto os scripts devem inspecionar a saída. A partir da v1.0, ele termina com o status 1 quando uma instrução de configuração SET ou UNSET falha, quando o gerenciamento de acesso está habilitado e uma instrução é recusada ou quando uma execução de IaC em versão prévia informa um recurso com falha.