Como conversar com o Google BigQuery em menos de 5 minutos
Suba o Data Talks, conecte um dataset BigQuery com service account e faça sua primeira pergunta — fim a fim, em menos de 5 minutos.
BigQuery é um dos warehouses mais fáceis de consultar — desde que você saiba SQL. Pra quem não sabe, o editor é um muro. Este tutorial mostra como apontar o Data Talks pra um dataset BigQuery e fazer sua primeira pergunta em linguagem natural. Fim a fim, leva menos de 5 minutos.
Passo 1 — rodar o Data Talks localmente
Clone o repo e suba a stack com Docker Compose. UI em http://localhost:5173 em cerca de um minuto.
git clone https://github.com/Empreiteiro/data-talks.git
cd data-talks
docker compose up -dPasso 2 — criar uma service account no BigQuery
No Google Cloud Console, crie uma service account com duas roles: BigQuery Data Viewer (ler tabelas) e BigQuery Job User (rodar queries). Gere uma chave JSON para ela. É a credencial que o Data Talks vai usar.
Dica: escope a service account para um único dataset se quiser isolamento estrito. Use IAM conditions no dataset, não no projeto.
Passo 3 — adicionar BigQuery como fonte
Na UI do Data Talks, clique 'Adicionar fonte' → 'BigQuery'. Cole o JSON da service account, escolha o projeto e o dataset. O schema é inspecionado em segundos.
Passo 4 — fazer a primeira pergunta
Abra uma nova conversa. Selecione a fonte BigQuery. Pergunte algo simples como:
Mostre a receita total por mês nos últimos 12 meses.
Em poucos segundos, o agente gera Standard SQL, executa e devolve um gráfico de linha. Clique em 'Mostrar SQL' para inspecionar a query — vai parecer uma agregação mensal sensata sobre sua tabela fato.
Passo 5 — fixar o gráfico e configurar um alerta
Fixe o gráfico num dashboard. Depois clique 'Configurar alerta' na conversa: escolha semanal, configure webhook ou Telegram, e a mesma pergunta agora roda toda semana entregando resultados para seu time.
Pra onde ir agora
- Adicione um segundo dataset BigQuery e faça uma pergunta cruzando fontes.
- Conecte sua réplica Postgres também — Data Talks cruza fontes numa só conversa.
- Experimente Studio reports para resumos executivos com comentário da IA.
- Leia a página de integração com BigQuery — cobre controle de custo, tabelas particionadas e inferência de JOIN.
Esse é o loop: conectar → perguntar → fixar → alertar. Cinco minutos do clone até uma métrica recorrente no seu inbox.