# exec

> O comando stackql exec executa uma instrução do StackQL ou um script de instruções, com opções para formato de saída, autenticação e registro de providers.

Source: https://stackql.io/pt-br/command-line-usage/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.instances` `WHERE 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](/getting-started/output-modes#otel-output)), 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](/command-line-usage/global-flags) para ver opções adicionais

* * *

### Exemplos

Exibir os resultados da consulta no console em formato de tabela:
```shell
stackql exec "SHOW services IN google"
```

Exibir os resultados da consulta no console em formato json:
```shell
stackql exec "SHOW services IN google" -o json
```

Gravar os resultados da consulta em um arquivo em formato json:
```shell
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:
```shell
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`](/language-spec/set) ou [`UNSET`](/language-spec/unset) falha, quando o [gerenciamento de acesso](/command-line-usage/access-management) está habilitado e uma instrução é recusada ou quando uma execução de IaC em versão prévia informa um recurso com falha.
