> 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/ru/iot-query/connection-setup.md).

# Настройка подключения

Установите подключение PostgreSQL к IoT Query, настройте учетные данные, изучите архитектуру схемы данных и примените настройки безопасности подключения

Это руководство объясняет, как подключиться к вашему **IoT Query** экземпляру, который построен на базе **Neon PostgreSQL**.

## Параметры подключения

Когда ваш **IoT Query** экземпляр будет настроен, вы получите следующие параметры подключения по электронной почте:

<table><thead><tr><th width="164.9091796875">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td><strong>Хост</strong></td><td>Адрес сервера базы данных</td></tr><tr><td><strong>Порт</strong></td><td>Порт подключения (обычно 5432)</td></tr><tr><td><strong>Имя базы данных</strong></td><td>Назначенное вам имя базы данных</td></tr><tr><td><strong>Имя пользователя</strong></td><td>Ваше имя пользователя базы данных</td></tr><tr><td><strong>Пароль</strong></td><td>Ваш защищенный пароль базы данных</td></tr><tr><td><strong>Режим SSL</strong></td><td>Режим SSL-подключения</td></tr></tbody></table>

## Архитектура данных

Ваш **IoT Query** организует данные в определенных схемах:

* [`raw_business_data`](/docs/analytics/ru/iot-query/schema-overview/bronze-layer/raw-business-data.md) - Содержит таблицы бизнес-данных (пользователи, объекты, задания и т. д.)
* [`raw_telematics_data`](/docs/analytics/ru/iot-query/schema-overview/bronze-layer/raw-telematics-data.md) - Содержит телематические данные с клиентских устройств (GPS-треки, показания датчиков)

{% hint style="info" %}
При запросе данных необходимо указать как схему (например, `raw_business_data`) так и имя таблицы (например, `объекты`): `SELECT * FROM raw_business_data.objects LIMIT 10;`
{% endhint %}

## Совместимость с PostgreSQL

**IoT Query** полностью совместим с протоколом PostgreSQL. Вы можете подключиться с помощью:

* Стандартных клиентов PostgreSQL (pgAdmin, DBeaver и т. д.)
* Языков программирования с драйверами PostgreSQL (Python, Java, Узел.js)
* Инструментов бизнес-аналитики, поддерживающих PostgreSQL (Tableau, Power BI)

## Формат строки подключения

Для программного доступа используйте стандартный формат строки подключения PostgreSQL:

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

Пример с заполнителями:

{% code overflow="wrap" %}

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

{% endcode %}

## Охрана подключения

Важные аспекты Охрана:

* **Шифрование SSL** - Передача ваших данных шифруется в соответствии с указанным режимом SSL
* **Конфигурация сети** - Ваша сеть должна разрешать исходящие подключения к указанным хосту и порту
* **Безопасность учетных данных** - Ваши учетные данные для подключения уникальны для вашего экземпляра и должны храниться в безопасности

### Рекомендации по подключениям

При работе с вашим **IoT Query**:

* **Управляйте неактивными подключениями** - Закрывайте неиспользуемые подключения, чтобы освободить ресурсы
* **Используйте пул подключений** - Для приложений с частым доступом к базе данных
* **Безопасно храните учетные данные** - Никогда не прописывайте учетные данные непосредственно в скриптах или приложениях
* **Установите подходящие тайм-ауты** - Настройте разумные тайм-ауты подключения для вашего случая использования

## Устранение неполадок подключения

Если возникли проблемы с подключением:

1. Убедитесь, что параметры подключения совпадают с указанными в приветственном электронном письме
2. Убедитесь, что ваша сеть разрешает подключение к указанным хосту и порту
3. Убедитесь, что ваш клиент поддерживает требуемый режим SSL

## Следующие шаги

После установления подключения перейдите к разделу [Обзор схемы](/docs/analytics/ru/iot-query/schema-overview.md) чтобы узнать о доступных структурах данных и таблицах.


---

# 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/ru/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.