Configuração da conexão

Estabeleça uma conexão PostgreSQL com IoT Query, configure as credenciais, entenda a arquitetura do esquema de dados e aplique as configurações de Segurança da conexão

Este guia explica como se conectar à sua IoT Query instância, baseada no Neon PostgreSQL.

Parâmetros de conexão

Quando sua 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 (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

Sua IoT Query organiza os dados em esquemas específicos:

• raw_business_data - Contém tabelas de dados empresariais (usuários, objetos, Tarefas etc.)

• raw_telematics_data - Contém dados telemáticos de dispositivos de clientes (trajetos de 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, objetos): SELECT * FROM raw_business_data.objects LIMIT 10;

Compatibilidade com PostgreSQL

IoT Query é totalmente compatível com o protocolo PostgreSQL. Você pode se conectar usando:

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

• Linguagens de programação com Motoristas PostgreSQL (Python, Java, Nó.js)

• Ferramentas de inteligência de negócios compatíveis com 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:[e-mail]: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 da sua instância e devem ser mantidas seguras

Melhores práticas para conexões

Ao trabalhar com sua IoT Query:

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

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

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

• Defina tempos limite apropriados - Configure tempos limite 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 ao host e à porta especificados

3. Certifique-se de que seu cliente oferece suporte ao modo SSL necessário

Próximas etapas

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