Automação do Google BigQuery via Rube MCP

Execute consultas SQL, explore esquemas de banco de dados e analise conjuntos de dados através da integração com o Metabase usando Rube MCP (Composio).

Documentação do Toolkit: composio.dev/toolkits/googlebigquery

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa via RUBE_MANAGE_CONNECTIONS com o toolkit metabase
• Uma instância do Metabase conectada à sua fonte de dados BigQuery
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit metabase
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Observação: Os dados do BigQuery são acessados através do Metabase, uma ferramenta de business intelligence que se conecta ao BigQuery como uma fonte de dados. As ferramentas abaixo executam consultas e recuperam metadados através da API do Metabase.

Fluxos de Trabalho Principais

1. Executar uma Consulta SQL Nativa

Use METABASE_POST_API_DATASET com o tipo native para executar consultas SQL brutas em seu banco de dados BigQuery.

Tool: METABASE_POST_API_DATASET
Parameters:
  - database (required): Metabase database ID (integer)
  - type (required): "native" for SQL queries
  - native (required): Object with "query" string
    - query: Raw SQL string (e.g., "SELECT * FROM users LIMIT 10")
    - template_tags: Parameterized query variables (optional)
  - constraints: { "max-results": 1000 } (optional)

2. Executar uma Consulta MBQL Estruturada

Use METABASE_POST_API_DATASET com o tipo query para consultas em Metabase Query Language (MBQL) com agregação e filtragem integradas.

Tool: METABASE_POST_API_DATASET
Parameters:
  - database (required): Metabase database ID
  - type (required): "query" for MBQL
  - query (required): Object with:
    - source-table: Table ID (integer)
    - aggregation: e.g., [["count"]] or [["sum", ["field", 5, null]]]
    - breakout: Group-by fields
    - filter: Filter conditions
    - limit: Max rows
    - order-by: Sort fields

3. Obter Metadados da Consulta

Use METABASE_POST_API_DATASET_QUERY_METADATA para recuperar metadados sobre bancos de dados, tabelas e campos disponíveis para consulta.

Tool: METABASE_POST_API_DATASET_QUERY_METADATA
Parameters:
  - database (required): Metabase database ID
  - type (required): "query" or "native"
  - query (required): Query object (e.g., {"source-table": 1})

4. Converter Consulta para SQL Nativo

Use METABASE_POST_API_DATASET_NATIVE para converter uma consulta MBQL em sua representação SQL nativa.

Tool: METABASE_POST_API_DATASET_NATIVE
Parameters:
  - database (required): Metabase database ID
  - type (required): "native"
  - native (required): Object with "query" and optional "template_tags"
  - parameters: Query parameter values (optional)

5. Listar Bancos de Dados Disponíveis

Use METABASE_GET_API_DATABASE para descobrir todas as conexões de banco de dados configuradas no Metabase.

Tool: METABASE_GET_API_DATABASE
Description: Retrieves a list of all Database instances configured in Metabase.
Note: Call RUBE_SEARCH_TOOLS to get the full schema for this tool.

6. Obter Metadados do Esquema do Banco de Dados

Use METABASE_GET_API_DATABASE_ID_METADATA para recuperar informações completas de tabelas e campos para um banco de dados específico.

Tool: METABASE_GET_API_DATABASE_ID_METADATA
Description: Retrieves complete metadata for a specific database including
  all tables and fields.
Note: Call RUBE_SEARCH_TOOLS to get the full schema for this tool.

Padrões Comuns

• Descobrir e depois consultar: Use METABASE_GET_API_DATABASE para encontrar IDs de banco de dados, depois METABASE_GET_API_DATABASE_ID_METADATA para explorar tabelas e campos, e então METABASE_POST_API_DATASET para executar consultas.
• Abordagem SQL em primeiro lugar: Use METABASE_POST_API_DATASET com type: "native" e escreva consultas SQL padrão para máxima flexibilidade.
• Consultas parametrizadas: Use template_tags em consultas nativas para parametrização segura (por exemplo, SELECT * FROM users WHERE id = {{user_id}}).
• Exploração de esquema: Use METABASE_POST_API_DATASET_QUERY_METADATA para entender as estruturas das tabelas antes de construir consultas complexas.

…