Google BigQuery
Consultar dados no Google BigQuery usando uma conta de serviço. Confira os campos necessários, a obtenção das credenciais e o funcionamento na Zild.
Consultar dados no Google BigQuery usando uma conta de serviço.
Onde configurar
Abra Zild Admin → Integrações → Conectores, localize o provedor e use Configurar ou Editar. Informe os dados deste guia, habilite o conector para o fluxo e salve.
Campos necessários
Os requisitos abaixo são os dados necessários ao fluxo que utiliza o conector. O cadastro genérico pode aceitar campos vazios que serão exigidos somente ao executar uma operação. O botão Salvar não confirma que a credencial funciona no provedor.
| Campo | Requisito para o fluxo |
|---|---|
CredentialsJson | JSON completo da chave da conta de serviço, incluindo project_id, client_email e private_key. |
Como obter as credenciais
- No Google Cloud, selecione o projeto e abra IAM e administrador → Contas de serviço.
- Selecione a conta de serviço, abra Chaves → Adicionar chave → Criar nova chave e escolha JSON.
- Informe o conteúdo completo do arquivo em CredentialsJson. Conceda acesso aos datasets e permissão para criar jobs de consulta no projeto.
Como funciona na Zild
A API extrai project_id do JSON, cria GoogleCredential e BigQueryClient e executa a consulta. O formulário não utiliza ApiKey para esse tipo.
Como conferir a configuração
Depois de salvar, use o fluxo correspondente (consulta, agente, chamada ou processamento) para verificar o acesso. Se houver erro, confira credencial, permissões e recurso escolhido no provedor. Para tipos limitados ou legados, confirme a disponibilidade com a administração antes de tentar usar.
Na edição, a Zild mostra credenciais protegidas como asteriscos. Preserve o valor mascarado para manter a credencial atual ou cole uma nova credencial para substituí-la.