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.
run_select_query
Executa uma instrução SELECT nos providers configurados e retorna as linhas do resultado. Somente leitura - mutações e operações de ciclo de vida não são aceitas; para elas, use run_mutation_query ou run_lifecycle_operation.
As linhas do resultado são retornadas ao cliente, mas ficam excluídas propositalmente do log de auditoria.
Veja também:
[ Visão geral do MCP ] [ validate_select_query ] [ list_methods ] [ SELECT na especificação da linguagem ]
Entradas
| Argumento | Obrigatório | Descrição |
|---|---|---|
sql | Sim | Uma instrução SELECT. As instruções de metadados (SHOW, DESCRIBE, DESC, EXPLAIN) são classificadas como somente leitura pelo controle de políticas e também são aceitas; DESC é reconhecido a partir do StackQL v0.12.732. |
row_limit | Não | Limite do número de linhas retornadas ao cliente. 0 (padrão) significa sem limite do lado do cliente. |
source | Não | ID do item da Query Library quando o SQL veio de query_library_get. Serve apenas para atribuição; não altera a execução nem as aprovações. |
format | Não | Renderização do texto: markdown ou json. Quando omitido, usa a configuração de renderização do servidor. |
Saída
| Renderizador | Formato |
|---|---|
| Tabela | {rows: [...]} - um objeto por linha, indexado pelo nome da coluna |
Controle
Permitida em todos os modos do servidor (read_only, safe, delete_safe, full_access) quando todas as instruções do payload são somente leitura. A partir da v1.0, esta ferramenta recusa INSERT, UPDATE, REPLACE, DELETE e EXEC em todos os modos, incluindo full_access, com um erro que indica run_mutation_query ou run_lifecycle_operation. Um payload com várias instruções é classificado pela instrução mais privilegiada que ele contém, então uma mutação depois de um SELECT inicial é recusada da mesma forma. A ferramenta declara destructiveHint: false e openWorldHint: true.
Exemplo
Experimente este prompt em qualquer cliente MCP compatível com elicitação que tenha o servidor MCP do StackQL registrado:
List the VPC networks in my Google Cloud project my-project
and tell me which ones use auto subnet creation.
Veja um exemplo no Claude Desktop: