# Configuração da 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:

<table><thead><tr><th width="164.9091796875">Parâmetro</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Host</strong></td><td>O endereço do servidor de banco de dados</td></tr><tr><td><strong>Porta</strong></td><td>A porta de conexão (tipicamente 5432)</td></tr><tr><td><strong>Nome do banco de dados</strong></td><td>O nome do banco de dados atribuído a você</td></tr><tr><td><strong>Nome de usuário</strong></td><td>Seu nome de usuário do banco de dados</td></tr><tr><td><strong>Senha</strong></td><td>Sua senha segura do banco de dados</td></tr><tr><td><strong>Modo SSL</strong></td><td>O modo de conexão SSL</td></tr></tbody></table>

## Arquitetura de dados

Seu **IoT Query** organiza os dados em esquemas específicos:

* [`raw_business_data`](https://www.navixy.com/docs/analytics/pt-br/schema-overview/bronze-layer#raw_business_data-structure) - Contém tabelas de dados de negócios (usuários, objetos, tarefas, etc.)
* [`raw_telematics_data`](https://www.navixy.com/docs/analytics/pt-br/schema-overview/bronze-layer#raw_telematics_data-structure) - Contém dados telemáticos de dispositivos de clientes (trajetos GPS, leituras de sensores)

{% hint style="info" %}
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;`
{% endhint %}

## 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:

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

Exemplo com espaços reservados:

{% code overflow="wrap" %}

```sql
postgresql://client_user:your_password@db.example.cloud:5432/client_123_dwh?sslmode=require
```

{% endcode %}

## 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](https://www.navixy.com/docs/analytics/pt-br/iot-query/schema-overview) seção para aprender sobre as estruturas de dados e tabelas disponíveis.