> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/pt-br/iot-query/connection-setup.md).

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

<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/raw-business-data.md) - Contém tabelas de dados empresariais (usuários, objetos, Tarefas etc.)
* [`raw_telematics_data`](/docs/analytics/pt-br/iot-query/schema-overview/bronze-layer/raw-telematics-data.md) - Contém dados telemáticos de dispositivos de clientes (trajetos de 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, `objetos`): `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 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:

```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** - 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](/docs/analytics/pt-br/iot-query/schema-overview.md) para conhecer as estruturas de dados e tabelas disponíveis.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.