Referência
Fontes de dados do HubCount BI Studio: tipos de conexão
Os tipos de conexão do HubCount BI Studio, onde a conexão fica salva, quando o Sync Agent atualiza e como as empresas do escritório entram no projeto.
Toda análise no HubCount BI Studio 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 aplicativo instalado e o navegador, onde as conexões ficam guardadas e o que muda por causa das empresas do escritório.
Tipos de conexão
| Tipo | O que lê | Quem busca os dados |
|---|---|---|
| Banco de Dados | SQL Server, PostgreSQL, MySQL, OracleDB, Firebird, SAP HANA e ODBC, com uma consulta SQL | O HubCount BI Studio, no horário agendado |
| API | Sistemas com API REST que respondem em JSON | O HubCount BI Studio, no horário agendado |
| Arquivo Local | Planilhas Excel (.xlsx) e arquivos CSV | O HubCount BI Studio, a partir do arquivo |
| Google Sheets | Planilhas do Google Drive, uma aba por cubo | O HubCount BI Studio, no horário agendado |
| Webhook | Dados em JSON que outro sistema envia | O seu sistema, quando quiser |
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: use 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: use API REST.
- O sistema não tem API, mas dispara avisos (webhooks): use webhook.
- Os dados estão numa planilha: use Google Sheets se a planilha é compartilhada no Drive e Arquivo Local se é um arquivo no computador.
Aplicativo instalado x navegador
O HubCount BI Studio funciona como aplicativo instalado no computador (Windows, macOS e Linux) e também no navegador, em bi.hubcount.com.br, quando a sua organização habilita a versão web. A diferença está em quem acessa a fonte de dados.
| Tipo | HubCount BI Studio instalado | HubCount BI Studio no navegador |
|---|---|---|
| Banco de dados | A conexão sai do seu computador. Alcança bancos da rede interna do escritório ou da empresa. | A conexão sai de um servidor da HubCount. O banco precisa aceitar conexões vindas da internet. |
| ODBC | Lista os DSNs configurados no seu computador. | Pede o nome de um DSN, ou uma connection string completa, configurado no servidor que executa a API web. Não lê os DSNs do seu computador. |
| Arquivo Local (Excel e CSV) | Lê o arquivo direto do seu computador. | Envia uma cópia do arquivo para o servidor da sua organização. 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 HubCount. | Só na nuvem HubCount. |
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 HubCount. | 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. |
| 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.
Neste computador ou Nuvem HubCount
A conexão diz onde os dados estão. O cubo diz quando e onde a atualização roda. Essa escolha fica na aba de sincronização do cubo: ative Atualizar automaticamente e depois escolha em Onde sincronizar.
| Opção | Quem executa a atualização | O que precisa estar aberto |
|---|---|---|
| Neste computador | O seu computador | O HubCount BI Studio instalado ou o HubCount Sync Agent |
| Nuvem HubCount | Os servidores da HubCount | Nada. Exige que a conexão esteja salva na nuvem |
No navegador, só a opção da nuvem fica disponível.
HubCount Sync Agent
O HubCount Sync Agent é um aplicativo leve, instalado no computador ou no servidor do escritório, que mantém os cubos atualizados sem o HubCount BI Studio completo aberto. Use quando a fonte de dados só existe na rede interna e você quer atualizar todo dia sem deixar o HubCount BI Studio aberto.
- Você entra com a mesma conta do portal da HubCount.
- As credenciais das conexões ficam só no computador do agente.
- O agente só executa cubos configurados para atualizar neste computador. Cubos configurados para a nuvem aparecem como Nuvem HubCount e ficam fora do agendamento local.
- O intervalo mínimo entre envios é de 1 hora.
- O agendamento local só roda com o agente aberto, mesmo que minimizado na bandeja do sistema. Ative a opção de iniciar com o Windows no painel do agente.
- Evite agendar o mesmo cubo no HubCount BI Studio e no Sync Agent da mesma máquina ao mesmo tempo.
Empresas do escritório no projeto
No HubCount, cada projeto pode ter empresas vinculadas. Elas definem para quais empresas os dados do projeto valem e abrem o dashboard certo no HubCount BI Web.
Vincular empresas ao projeto
- Abra as Configurações de projeto do projeto, ou crie um projeto novo.
- Na seção Empresas vinculadas, clique no campo de empresas e busque pelo nome ou pelo CNPJ.
- Escolha as empresas que fazem parte do projeto. Use Ver todas para ver a lista completa quando houver muitas.
- Salve o projeto.
Vincule só as empresas que fazem sentido para o projeto. Elas definem o escopo das consultas, dos dashboards e das configurações do projeto.
O campo Id da Empresa
Quando os dados de várias empresas chegam no mesmo cubo, um campo do tipo Id da Empresa separa os registros por empresa. Ele identifica a empresa a que cada registro pertence. Em cubos de webhook sem esse campo, o editor de campos mostra um aviso sugerindo adicioná-lo.
Frequência de atualização por empresa
Na frequência de atualização do cubo, você escolhe entre duas formas:
- Definir uma frequência de atualização para todas as empresas do projeto: a mesma agenda vale para todas.
- Definir uma frequência de atualização para cada empresa do projeto: cada empresa vinculada tem a sua agenda, em uma lista que se expande empresa por empresa.
Abrir o dashboard da empresa
No topo do HubCount BI Studio, o botão Abrir dashboard web abre o dashboard publicado no HubCount BI Web. Com empresas vinculadas, ele mostra a lista de empresas do projeto para você escolher qual abrir. O botão fica desativado quando o projeto não tem nenhuma empresa vinculada.
Exemplo: as conexões da Contabilidade Exemplo
| Conexão | Tipo | Armazenamento | Cubos |
|---|---|---|---|
| ERP Padaria (SQL Server) | Banco de Dados | Local: o servidor só existe na rede interna | Vendas, Estoque |
| CRM da Transportadora | API | Nuvem: atualiza de madrugada, sem computador ligado | Oportunidades |
| Metas comerciais 2026 | Google Sheets | Nuvem | Metas |
| Pedidos da loja online | Webhook | Nuvem | Pedidos |
O projeto “BI Comercial 2026” vincula a Padaria Exemplo e a Transportadora Exemplo. A agenda do cubo Vendas é por empresa: a Padaria atualiza todo dia às 6 horas e a Transportadora, uma vez por semana.