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

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

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

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