# Configuração da conexão

Este guia explica como se conectar à sua **IoT Query** instância, que é baseada em **Neon PostgreSQL**.

## Parâmetros de conexão

Quando sua **IoT Query** instância for 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 (normalmente 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

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

* [`raw_business_data`](/docs/analytics/pt-br/iot-query/schema-overview/bronze-layer.md#raw_business_data-structure) - Contém tabelas de dados de negócios (usuários, objetos, tarefas etc.)
* [`raw_telematics_data`](/docs/analytics/pt-br/iot-query/schema-overview/bronze-layer.md#raw_telematics_data-structure) - Contém dados telemáticos de dispositivos do cliente (rastros GPS, leituras de sensores)

{% hint style="info" %}
Ao consultar os dados, você deve especificar tanto o esquema (por exemplo, `raw_business_data`) quanto a tabela (por exemplo, `objects`) pelo nome: `SELECT * FROM raw_business_data.objects LIMIT 10;`
{% endhint %}

## 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 drivers PostgreSQL (Python, Java, Node.js)
* Ferramentas de business intelligence que oferecem suporte a 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 placeholders:

{% 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 da sua instância e devem ser mantidas em segurança

### 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 pooling 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 timeouts apropriados** - Configure timeouts de conexão razoáveis para o seu caso de uso

## Solução de problemas de conexão

Se você encontrar problemas de conexão:

1. Verifique se os parâmetros de conexão correspondem aos do seu 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 ofereça 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](/docs/analytics/pt-br/iot-query/schema-overview.md) para conhecer as estruturas de dados e tabelas disponíveis.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://navixy.com/docs/analytics/pt-br/iot-query/connection-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.