Fontes de dados do Hubviz: tipos de conexão e onde usar

Toda análise no Hubviz começa numa conexão: ela diz onde estão os dados e como chegar até eles. Cada conexão alimenta um ou mais cubos. Esta página mostra os tipos de conexão, as diferenças entre o app instalado e o navegador e onde as conexões ficam guardadas.

Tipos de conexão

Tipo	O que lê	Quem busca os dados	Guia
Banco de Dados	SQL Server, PostgreSQL, MySQL, OracleDB, Firebird, SAP HANA e ODBC, com uma consulta SQL	O Hubviz, no horário agendado	Bancos de dados
API	Sistemas com API REST que respondem em JSON	O Hubviz, no horário agendado	API REST
Arquivo Local	Planilhas Excel (.xlsx) e arquivos CSV	O Hubviz, a partir do arquivo	Excel e CSV
Google Sheets	Planilhas do Google Drive, uma aba por cubo	O Hubviz, no horário agendado	Google Sheets
Webhook	Dados em JSON que outro sistema envia	O seu sistema, quando quiser	Webhook

O tipo é a primeira escolha ao criar um cubo:

Qual tipo escolher

• Os dados estão num sistema próprio da empresa, com banco SQL: banco de dados. É o caminho mais completo: você junta tabelas e filtra na consulta.
• O sistema é na nuvem (CRM, ERP online, plataforma de anúncio) e tem API: API REST.
• O sistema não tem API, mas dispara avisos (webhooks): webhook.
• Os dados estão numa planilha: Google Sheets se a planilha é compartilhada no Drive, Excel e CSV se é um arquivo.

App instalado x navegador

O Hubviz Studio funciona instalado no computador ou no navegador. A diferença está em quem acessa a fonte de dados.

Tipo	Hubviz Studio instalado	Hubviz Studio no navegador
Banco de dados	A conexão sai do seu computador. Alcança bancos da rede interna da empresa.	A conexão sai dos servidores do Hubviz. O banco precisa aceitar conexões vindas da internet.
ODBC	Lista os DSNs configurados no seu computador.	Pede o nome de um DSN configurado no servidor que executa a API do Hubviz. Não lê os DSNs do seu computador.
Excel e CSV	Lê o arquivo direto do seu computador.	Envia uma cópia do arquivo. Mudou a planilha, envie de novo.
API REST, Google Sheets e Webhook	Funcionam igual nos dois.	Funcionam igual nos dois.
Atualização automática	Pode rodar neste computador ou na nuvem.	Só na nuvem.

Onde a conexão fica salva

Ao criar ou editar uma conexão, escolha o Armazenamento no topo da janela.

Opção	Onde fica	Quem vê	Atualização na nuvem
Local (padrão)	Só neste computador. No navegador, só neste navegador.	Só você, neste dispositivo.	Não
Nuvem	Na nuvem do Hubviz.	Você e quem você escolher em Acesso ao perfil.	Sim

Onde criar e editar conexões

• Ao criar um cubo: em Cubos, clique em +, depois em Criar Manualmente, escolha o tipo e clique em Criar Nova Conexão. Para mudar uma conexão existente, selecione e clique em Editar Conexão.
• No menu do topo: abra Fontes de Dados. A tela lista todas as conexões disponíveis para você.

Na tela Fontes de Dados	O que faz
Adicionar nova conexão	Cria uma conexão sem criar cubo.
Escopo	Todos mostra todas as conexões. Deste projeto em destaque destaca as usadas pelo projeto escolhido em Projeto para foco. Somente este projeto mostra só essas.
Incluir ODBC Configurações	Faz a opção ODBC aparecer no tipo de banco. Veja ODBC.
Exportar JSON e Importar JSON	Copiam conexões entre computadores, num arquivo JSON.
Ícone ao lado do nome	Computador para conexão local, nuvem para conexão na nuvem.
Ações	Editar, Excluir e Testar Autenticação.

Uma conexão pode servir a vários cubos. Se a senha do banco mudar, edite a conexão uma vez e todos os cubos que a usam passam a usar a senha nova.

Exemplo: as conexões da Aurora

Conexão	Tipo	Armazenamento	Cubos
ERP Aurora (SQL Server)	Banco de Dados	Local: o servidor só existe na rede interna	Vendas, Estoque
CRM Aurora	API	Nuvem: atualiza de madrugada, sem computador ligado	Oportunidades
Metas comerciais 2026	Google Sheets	Nuvem	Metas
Pedidos da loja online	Webhook	Nuvem	Pedidos

Depois de conectar, siga para Campos do cubo e Medidas.