BigQuery (Service Account) (destino)

O BigQuery é uma solução de Bigdata criada pelo Google que permite o armazenamento e análise de dados em grande escala. Neste artigo, iremos mostrar como cadastrar um banco BigQuery como destino na plataforma da Kondado, para que você possa centralizar os dados de todas as ferramentas da sua empresa.

Não possui um banco de dados? Veja este tutorial de como criar um banco BigQuery

Clique aqui para acessar o tutorial de como conectar à sua ferramenta de visualização:
– Looker Studio
– Power BI

Neste tutorial, mostramos como adicionar o BigQuery com Service Account. Caso o seu ambiente do Google Cloud possua restrições que impedem a criação de chaves de autenticação (JSON), é possível desativá-las seguindo a documentação oficial do Google. Como alternativa, você também pode autenticar o BigQuery via email, utilize este tutorial

Não possui um banco de dados? Veja este tutorial de como criar um banco MySQL na AWS

1) Acesse a sua conta do Google Cloud

2) Clique neste link para acessar a seção de Service Accounts, ou siga a imagem abaixo:

3) Uma vez na seção de Service Accounts, clique em “CREATE SERVICE ACCOUNT”

4) No primeiro passo, preencha um nome para a sua Service Account (por exemplo, “kondado bigquery”) e clique em “CREATE”

5) No segundo passo do processo de criação, selecione os Roles “BigQuery Job User”, “BigQuery User”, e "BigQuery Data Editor" clique em CONTINUE

6) Agora basta clicar em “DONE” para finalizar a criação

7) Uma vez criada, você será direcionado para uma lista de todas as service accounts ativas. Localize a que você acabou de criar e, nos três pontos verticais à direita, clique em “Create key”

8) No diálogo, selecione o tipo “JSON” e depois clique em “CREATE”

9) Após clicar em criar, a chave será baixada no seu computador. Abra o arquivo que fez download em um editor de texto, ele terá um formato parecido com este:

ATENÇÃO: Antes de prosseguir, assegure-se que o seu projeto do Google Cloud está com o faturamento/billing ativo

10) Acesse a página do BigQuery e obtenha os IDs do projeto (em vermelho na figura abaixo) e o dataset (em verde) do seu destino no console do Google

11) Faça login na plataforma da Kondado

12) Navegue até a página de adição de destinos, clique em "Novo Destino" e selecione o destino do BigQuery Service Account

13) Preencha as informações do seu banco de dados conforme imagem abaixo:

  • Em ID do Projeto e ID do Dataset cole os valores obtidos no passo (10)
  • Em Credencial JSON, copie e cole TODO o conteúdo do arquivo baixado no passo (9), sem nenhuma alteração

ATENÇÃO: Certifique-se que o ID do Dataset NÃO contém o ID do projeto separado por ":". Por exemplo, "id_projeto:id_dataset" está errado. O correto é que o ID do projeto e ID do Dataset estejam cada um separadamente em seus respectivos campos

Agora basta salvar para que seu destino esteja apto para receber as primeiras integrações!

Cadastrar BigQuery (Service Account) como destino na Kondado

Configure uma Service Account no Google Cloud, gere uma chave JSON e registre o BigQuery como destino na Kondado para centralizar dados de mais de 80 fontes.

1
Criar Service Account no Google Cloud

Acesse sua conta do Google Cloud e vá até a seção de Service Accounts. Clique em CREATE SERVICE ACCOUNT, preencha um nome (ex.: "kondado bigquery") e atribua os roles BigQuery Job User, BigQuery User e BigQuery Data Editor.

2
Gerar chave JSON de autenticação

Na lista de service accounts, localize a conta criada, clique nos três pontos verticais e selecione Create key. Escolha o tipo JSON e faça o download. Abra o arquivo em um editor de texto para copiar todo o conteúdo posteriormente.

3
Verificar billing ativo e coletar IDs do projeto

Confirme que o faturamento/billing está ativo no seu projeto do Google Cloud. Acesse o console do BigQuery e anote o ID do Projeto e o ID do Dataset separadamente — não use o formato id_projeto:id_dataset.

4
Cadastrar destino na plataforma Kondado

Faça login na Kondado, navegue até a página de destinos e clique em Novo Destino. Selecione BigQuery (Service Account).

5
Preencher credenciais do destino

Cole o conteúdo da chave JSON, preencha os IDs de Projeto e Dataset em seus respectivos campos, dê um nome ao destino e salve.

6
Testar a conexão e iniciar integrações

Clique em TESTAR CONEXÃO para validar. Em seguida, crie integrações a partir das mais de 80 fontes disponíveis para começar a centralizar seus dados no BigQuery.

Perguntas frequentes

O que é o BigQuery e por que usá-lo como destino na Kondado?
O BigQuery é uma solução de Big Data do Google para armazenamento e análise de dados em grande escala. Usá-lo como destino na Kondado permite centralizar informações de mais de 80 fontes (CRMs, anúncios, e-commerce, bancos de dados) em um único data warehouse para análise.
Quais permissões (roles) são necessárias para a Service Account?
Você deve atribuir três roles à Service Account: BigQuery Job User, BigQuery User e BigQuery Data Editor. Essas permissões garantem que a Kondado possa executar jobs, acessar recursos e editar dados no seu projeto BigQuery.
O que fazer se meu ambiente Google Cloud não permite criar chaves JSON?
Se o seu ambiente possui restrições que impedem a criação de chaves de autenticação JSON, você pode desativá-las seguindo a documentação oficial do Google. Como alternativa, a Kondado também oferece autenticação do BigQuery via email, disponível em tutorial separado.
Por que preciso ter o faturamento/billing ativo no Google Cloud?
O billing ativo é obrigatório porque o BigQuery é um serviço pago do Google Cloud. Sem o faturamento ativado, não é possível utilizar o BigQuery como destino de dados, mesmo que você esteja dentro do tier gratuito.
Qual o erro mais comum ao preencher o ID do Dataset?
O erro mais comum é incluir o ID do projeto junto com o ID do dataset, no formato id_projeto:id_dataset. O correto é preencher cada ID separadamente em seu respectivo campo: ID do Projeto e ID do Dataset.
Por que usar Service Account em vez da autenticação por email?
A autenticação via Service Account é mais estável e não expira por políticas de sessão. Para uso contínuo do BigQuery como destino na Kondado, ela evita falhas inesperadas e mantém suas integrações rodando na frequência que você escolher sem necessidade de reautenticação.

Escrito por·Publicado em 2021-04-22·Atualizado em 2026-04-26