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
| Argumento | Descrição | Exemplo |
|---|---|---|
query | Consulta do StackQL a ser realizada ou comando a ser executado | "SELECT * FROM google.compute.instancesWHERE project = 'myproject' AND zone = 'us-east1-a'"Observe que a consulta deve estar entre aspas simples ou duplas |
Opções
| Opção | Descriçã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 |
--dryrun | Opção de execução de teste; somente o pré-processador é executado e a saída é retornada |
--var | Variá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.