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.

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​

ArgumentoObrigatórioDescrição
sqlSimUma 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_limitNãoLimite do número de linhas retornadas ao cliente. 0 (padrão) significa sem limite do lado do cliente.
sourceNãoID 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.
formatNãoRenderização do texto: markdown ou json. Quando omitido, usa a configuração de renderização do servidor.

Saída​

RenderizadorFormato
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: