Configuração de conexão

Este guia explica como conectar-se à sua instância do DataHub, que é construída sobre Neon PostgreSQL.

Parâmetros de conexão

Quando sua instância do DataHub for configurada, você receberá esses parâmetros de conexão por e-mail:

Parâmetro	Descrição
Host	O endereço do servidor de banco de dados
Porta	A porta de conexão (normalmente 5432)
Nome do banco de dados	O nome do banco de dados atribuído a você
Nome de usuário	Seu nome de usuário do banco de dados
Senha	Sua senha segura do banco de dados
Modo SSL	O modo de conexão SSL

Arquitetura de dados

Seu DataHub organiza os dados em schemas específicos:

• raw_business_data - Contém tabelas de dados de negócios (usuários, objetos, tarefas, etc.)

• raw_telematics_data - Contém dados telemáticos provenientes de dispositivos do cliente (rastreios GPS, leituras de sensores)

Ao consultar dados, você deve especificar tanto o schema (por exemplo raw_business_data) quanto o nome da tabela (por exemplo objects): SELECT * FROM raw_business_data.objects LIMIT 10;

Compatibilidade com PostgreSQL

O DataHub é totalmente compatível com o protocolo PostgreSQL. Você pode conectar-se usando:

• Clientes PostgreSQL padrão (pgAdmin, DBeaver, etc.)

• Linguagens de programação com drivers PostgreSQL (Python, Java, Node.js)

• Ferramentas de business intelligence que suportam PostgreSQL (Tableau, Power BI)

Formato da string de conexão

Para acesso programático, use o formato padrão da string de conexão PostgreSQL:

postgresql://username:password@host:port/database?sslmode=ssl_mode

Exemplo com espaços reservados:

postgresql://client_user:[email protected]:5432/client_123_dwh?sslmode=require

Segurança da conexão

Considerações importantes de segurança:

• Criptografia SSL - Sua transmissão de dados é criptografada de acordo com o modo SSL especificado

• Configuração de rede - Sua rede deve permitir conexões de saída para o host e a porta fornecidos

• Segurança das credenciais - Suas credenciais de conexão são exclusivas para sua instância e devem ser mantidas em segurança

Melhores práticas para conexões

Ao trabalhar com seu DataHub:

• Gerencie conexões ociosas - Feche conexões quando não estiverem em uso para liberar recursos

• Use pooling de conexão - Para aplicações com acesso frequente ao banco de dados

• Armazene credenciais com segurança - Nunca codifique credenciais diretamente em scripts ou aplicações

• Defina timeouts apropriados - Configure timeouts de conexão razoáveis para seu caso de uso

Solução de problemas de conexão

Se você encontrar problemas de conexão:

1. Verifique se seus parâmetros de conexão correspondem aos do e-mail de boas-vindas

2. Confirme se sua rede permite a conexão com o host e a porta especificados

3. Garanta que seu cliente suporte o modo SSL exigido

Próximos passos

Após estabelecer uma conexão, prossiga para a Visão geral do schema seção para aprender sobre as estruturas de dados e tabelas disponíveis.