googlebigquery-automation

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 Metabase usando o Rube MCP (Composio).

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

Pré-requisitos

• 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 do BigQuery
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas atuais das ferramentas

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 ele 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 ATIVO antes de executar qualquer fluxo de trabalho

Nota: Os dados do BigQuery são acessados através do Metabase, uma ferramenta de inteligência de negócios que se conecta ao BigQuery como 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 no seu banco de dados BigQuery.

Ferramenta: METABASE_POST_API_DATASET
Parâmetros:
  - database (obrigatório): ID do banco de dados do Metabase (inteiro)
  - type (obrigatório): "native" para consultas SQL
  - native (obrigatório): Objeto com a string "query"
    - query: String SQL bruta (ex.: "SELECT * FROM users LIMIT 10")
    - template_tags: Variáveis de consulta parametrizadas (opcional)
  - constraints: { "max-results": 1000 } (opcional)

2. Executar uma Consulta MBQL Estruturada

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

Ferramenta: METABASE_POST_API_DATASET
Parâmetros:
  - database (obrigatório): ID do banco de dados do Metabase
  - type (obrigatório): "query" para MBQL
  - query (obrigatório): Objeto com:
    - source-table: ID da tabela (inteiro)
    - aggregation: ex.: [["count"]] ou [["sum", ["field", 5, null]]]
    - breakout: Campos de agrupamento
    - filter: Condições de filtro
    - limit: Máximo de linhas
    - order-by: Campos de ordenação

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.

Ferramenta: METABASE_POST_API_DATASET_QUERY_METADATA
Parâmetros:
  - database (obrigatório): ID do banco de dados do Metabase
  - type (obrigatório): "query" ou "native"
  - query (obrigatório): Objeto de consulta (ex.: {"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.

Ferramenta: METABASE_POST_API_DATASET_NATIVE
Parâmetros:
  - database (obrigatório): ID do banco de dados do Metabase
  - type (obrigatório): "native"
  - native (obrigatório): Objeto com "query" e "template_tags" opcional
  - parameters: Valores dos parâmetros da consulta (opcional)

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.

Ferramenta: METABASE_GET_API_DATABASE
Descrição: Recupera uma lista de todas as instâncias de banco de dados configuradas no Metabase.
Nota: Chame RUBE_SEARCH_TOOLS para obter o esquema completo desta ferramenta.

6. Obter Esquema de Metadados do Banco de Dados

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

Ferramenta: METABASE_GET_API_DATABASE_ID_METADATA
Descrição: Recupera metadados completos para um banco de dados específico, incluindo
  todas as tabelas e campos.
Nota: Chame RUBE_SEARCH_TOOLS para obter o esquema completo desta ferramenta.

Padrões Comuns

• Descubra e depois consulte: 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-primeiro: 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 (ex.: SELECT * FROM users WHERE id = {{user_id}}).
• Exploração de esquemas: Use METABASE_POST_API_DATASET_QUERY_METADATA para entender estruturas de tabelas antes de construir consultas complexas.
• Obter valores de parâmetros: Use METABASE_POST_API_DATASET_PARAMETER_VALUES para recuperar valores possíveis para menus suspensos de filtro.

Armadilhas Conhecidas

• O parâmetro database é um ID inteiro interno do Metabase, não o nome do projeto ou conjunto de dados do BigQuery. Use METABASE_GET_API_DATABASE para encontrar IDs de banco de dados válidos primeiro.
• source-table em consultas MBQL também é um inteiro interno do Metabase, não o nome da tabela do BigQuery. Descubra IDs de tabelas através das ferramentas de metadados.
• Consultas SQL nativas usam o dialeto SQL do BigQuery (SQL Padrão). Certifique-se de que sua sintaxe é compatível com o BigQuery.
• O padrão max-results em constraints pode limitar as linhas retornadas. Defina explicitamente para grandes conjuntos de resultados.
• As respostas de METABASE_POST_API_DATASET contêm resultados aninhados sob data — analise com cuidado, pois a estrutura pode estar profundamente aninhada.
• IDs de campos do Metabase usados nos arrays aggregation, breakout e filter do MBQL devem ser inteiros obtidos das respostas de metadados.

Referência Rápida

Ação	Ferramenta	Parâmetros Chave
Executar consulta SQL	METABASE_POST_API_DATASET	database, type: "native", native.query
Executar consulta MBQL	METABASE_POST_API_DATASET	database, type: "query", query
Obter metadados da consulta	METABASE_POST_API_DATASET_QUERY_METADATA	database, type, query
Converter para SQL	METABASE_POST_API_DATASET_NATIVE	database, type, native
Obter valores de parâmetros	METABASE_POST_API_DATASET_PARAMETER_VALUES	parameter, field_ids
Listar bancos de dados	METABASE_GET_API_DATABASE	(veja esquema completo via RUBE_SEARCH_TOOLS)
Obter metadados do banco de dados	METABASE_GET_API_DATABASE_ID_METADATA	(veja esquema completo via RUBE_SEARCH_TOOLS)

---

Desenvolvido por Composio