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

Это руководство объясняет, как подключиться к вашему **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.md#raw_business_data-structure) - Содержит таблицы бизнес-данных (пользователи, объекты, задачи и т. д.)
* [`raw_telematics_data`](/docs/analytics/ru/iot-query/schema-overview/bronze-layer.md#raw_telematics_data-structure) - Содержит телематические данные с клиентских устройств (GPS-треки, показания датчиков)

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

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

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

* Стандартных клиентов PostgreSQL (pgAdmin, DBeaver и т. д.)
* Языков программирования с драйверами PostgreSQL (Python, Java, Node.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: 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/ru/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.