Добро пожаловать в HarborDB! Это руководство проведёт вас через процесс создания вашего первого подключения к PostgreSQL. Независимо от того, подключаетесь ли вы к локальной базе данных на вашем Mac или к удалённому серверу, HarborDB делает этот процесс простым и безопасным.

Предварительные требования

Прежде чем начать, убедитесь, что у вас есть:

HarborDB установлен (см. Руководство по установке)
Сервер PostgreSQL запущен и доступен
Данные подключения готовы:
- Имя хоста или IP-адрес
- Номер порта (по умолчанию: 5432)
- Имя базы данных
- Имя пользователя и пароль
- Опционально: SSL-сертификат, если требуется

Шаг 1: Запуск HarborDB и доступ к подключениям

Откройте HarborDB из папки "Программы" или Launchpad
Найдите боковую панель подключений в левой части окна
Нажмите кнопку "+" или перейдите в Файл → Добавить подключение

Шаг 2: Заполнение данных подключения

В диалоговом окне подключения есть несколько полей для заполнения:

Основная информация

Имя: Удобное имя для этого подключения (например, "Локальная разработка", "Продакшен-сервер")
Хост: Адрес сервера PostgreSQL
- Локальная база данных: localhost или 127.0.0.1
- Удалённый сервер: IP-адрес или имя хоста (например, db.example.com)
Порт: Порт PostgreSQL (по умолчанию: 5432)
База данных: Конкретная база данных для подключения
Имя пользователя: Ваше имя пользователя PostgreSQL
Пароль: Ваш пароль PostgreSQL

Дополнительные параметры (опционально)

Схема: Предпочитаемая схема (по умолчанию: public)
Режим SSL: Выберите в зависимости от конфигурации вашего сервера:
- prefer: Использовать SSL, если доступен
- require: Требовать SSL-подключение
- verify-full: Требовать SSL с проверкой сертификата
Таймаут: Таймаут подключения в секундах
Имя приложения: Пользовательский идентификатор для этого подключения

Шаг 3: Тестирование подключения

Перед сохранением всегда тестируйте подключение:

Нажмите "Проверить подключение" в диалоговом окне
Дождитесь подтверждения — вы должны увидеть "Подключение успешно"
Проверьте предупреждения о SSL или других настройках

Распространённые результаты тестирования

✅ Успех: Вы готовы сохранить и подключиться
❌ Сбой: Проверьте сообщение об ошибке для получения подсказок:
- "Подключение отклонено": Сервер не запущен или брандмауэр блокирует
- "Аутентификация не удалась": Неправильное имя пользователя/пароль
- "База данных не существует": Неправильное имя базы данных

Шаг 4: Сохранение и защита подключения

Варианты хранения пароля

HarborDB предлагает безопасное хранение пароля:

Сохранить в связке ключей (Рекомендуется): Пароль зашифрован в связке ключей macOS
Сохранить в подключении: Пароль хранится с настройками подключения (менее безопасно)
Спрашивать каждый раз: Запрашивать пароль при каждом подключении

Выбор подходящего варианта

| Метод хранения | Безопасность | Удобство | Лучше всего для | | --------------------- | ------------ | ------------ | ------------------------------------- | | Связка ключей macOS | 🔒 Высокая | ⚡ Высокое | Ежедневное использование, доверенные компьютеры | | Файл подключения | 🔒 Средняя | ⚡ Высокое | Быстрая настройка, тестирование | | Спрашивать каждый раз | 🔒 Наивысшая | ⚡ Низкое | Общие компьютеры, высокая безопасность |

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

Выберите метод хранения пароля
Нажмите "Сохранить", чтобы сохранить подключение
Найдите ваше подключение в боковой панели подключений
Дважды щелкните, чтобы подключиться

Шаг 5: Подключение и исследование

После подключения вы можете:

Навигация по базе данных

Разверните подключение, чтобы увидеть базы данных
Просматривайте схемы и таблицы в боковой панели
Щёлкните правой кнопкой мыши по таблицам для быстрых действий:
- Просмотр структуры таблицы
- Предварительный просмотр первых 100 строк
- Создание SELECT-запроса

Быстрые действия для начала работы

Откройте редактор запросов: Нажмите на иконку SQL или нажмите ⌘ + N
Выполните тестовый запрос:
```
SELECT version();
```
Изучите интерфейс: Ознакомьтесь с вкладками, панелями и инструментами

Управление подключениями

Организация нескольких подключений

По мере добавления подключений поддерживайте их организацию:

Избранное: Отмечайте часто используемые подключения для быстрого доступа
Группы: Организуйте по проекту, окружению или команде
Цветовое кодирование: Используйте метки или соглашения об именовании

Редактирование существующих подключений

Щёлкните правой кнопкой мыши по подключению в боковой панели
Выберите "Изменить подключение"
Обновите любые поля по необходимости
Протестируйте и сохраните изменения

Дублирование подключений

Сэкономите время, дублируя похожие подключения:

Щёлкните правой кнопкой мыши по исходному подключению
Выберите "Дублировать"
Измените только изменённые поля
Сохраните как новое подключение

Лучшие практики безопасности

Безопасность паролей

Никогда не делитесь паролями из связки ключей
Используйте сложные пароли для пользователей PostgreSQL
Регулярно меняйте пароли
Избегайте повторного использования паролей на разных серверах

Безопасность подключений

Используйте SSL для удалённых подключений
Ограничьте права базы данных необходимыми операциями
Используйте подключения только для чтения для отчётности
Регулярно проводите аудит журналов подключений

Сетевая безопасность

Настройка брандмауэра: Разрешайте только доверенные IP-адреса
Доступ по VPN для удалённых баз данных
SSH-туннелирование для дополнительных уровней безопасности

Типичные сценарии подключения

Локальный PostgreSQL (установлен через Homebrew)

Имя: Локальный PostgreSQL
Хост: localhost
Порт: 5432
База данных: postgres
Имя пользователя: your_username
Пароль: [Связка ключей]

Контейнер Docker PostgreSQL

Имя: Docker Dev DB
Хост: localhost
Порт: 5432  # Или пользовательский порт, если сопоставлен иначе
База данных: app_database
Имя пользователя: postgres
Пароль: postgres_password

Amazon RDS PostgreSQL

Имя: AWS Production
Хост: your-db-instance.region.rds.amazonaws.com
Порт: 5432
База данных: production_db
Имя пользователя: app_user
Режим SSL: verify-full

Google Cloud SQL

Имя: GCP Cloud SQL
Хост: /cloudsql/project:region:instance
Порт: 5432
База данных: cloud_db
Режим SSL: require

Устранение проблем с подключением

"Не удаётся подключиться к серверу"

Убедитесь, что PostgreSQL запущен:

# В Терминале
pg_isready -h localhost -p 5432

Проверьте настройки брандмауэра:
- Брандмауэр macOS (Системные настройки → Безопасность и конфиденциальность)
- Правила сетевого брандмауэра

Проверьте сетевое подключение:

# В Терминале
ping your-server-address
telnet your-server-address 5432

"Сбой аутентификации пароля"

Проверьте метод аутентификации PostgreSQL:
- Просмотрите файл pg_hba.conf
- Убедитесь в использовании аутентификации md5 или scram-sha-256
Сбросьте пароль при необходимости:
```
ALTER USER username WITH PASSWORD 'new_password';
```

Убедитесь, что пользователь имеет доступ к базе данных:

-- Подключитесь как суперпользователь
\du  -- Список пользователей
\l   -- Список баз данных

Ошибки SSL/TLS подключения

Проверьте требования SSL:
- Сервер может требовать определённый режим SSL
- Возможно, потребуется импортировать сертификат
Настройте режим SSL в настройках подключения
Импортируйте сертификат, если используете режим verify-full

Советы по производительности

Пул подключений

Держите подключения открытыми для частого использования
Закрывайте неиспользуемые подключения, чтобы освободить ресурсы
Используйте пул подключений для приложений

Сетевая оптимизация

Локальные подключения: Используйте localhost для лучшей производительности
Удалённые подключения: Убедитесь в достаточной пропускной способности
Сжатие: Включите при работе с большими наборами результатов

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

Теперь, когда вы подключены:

Изучите основы запросов — Научитесь писать и выполнять SQL-запросы
Навигация по базе данных — Изучите схемы, таблицы и связи
Экспорт данных — Сохраняйте результаты в CSV или JSON

Получение помощи

Если у вас всё ещё возникают трудности:

Проверьте наше Руководство по поддержке для дополнительного устранения неполадок
Посетите Часто задаваемые вопросы (FAQ) для получения ответов на общие вопросы
Свяжитесь со службой поддержки для получения персональной помощи

Создание первого подключения