Configuração de conexão

Este guia explica como conectar-se ao seu IoT Query instância, que é construída sobre Neon PostgreSQL.

Parâmetros de conexão

Quando seu IoT Query instância estiver configurada, você receberá estes 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 (tipicamente 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 IoT Query organiza os dados em esquemas 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 de dispositivos de clientes (trajetos GPS, leituras de sensores)

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

Compatibilidade com PostgreSQL

IoT Query é 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 de 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 - A transmissão dos seus 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 seguras

Boas práticas para conexões

Ao trabalhar com seu IoT Query:

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

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

• Armazene credenciais de forma segura - Nunca codifique credenciais diretamente em scripts ou aplicações

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

Solução de problemas de conexão

Se 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 ao host e à porta especificados

3. Garanta que seu cliente suporte o modo SSL exigido

Próximos passos

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