Смена внешнего порта GreenPlum

README.md

@@ -199,7 +199,7 @@ docker compose -f docker-compose.yml exec bookings-db bash -lc 'PGPASSWORD="$POS
 - `GP_USER` — пользователь (по умолчанию: gpadmin)
 - `GP_PASSWORD` — пароль (по умолчанию: gpadmin)
 - `GP_DB` — база данных (по умолчанию: gpadmin)
-- `GP_PORT` — порт (по умолчанию: 5432)
+- `GP_PORT` — порт Greenplum внутри Docker-сети (по умолчанию: 5432, менять обычно не нужно; внешний порт на хосте для подключения клиентов — 5435).
 
 ### Демо-БД bookings (Postgres)
 - `BOOKINGS_DB_USER` — пользователь Postgres для демобазы (по умолчанию: bookings)
@@ -247,6 +247,56 @@ docker compose -f docker-compose.yml exec bookings-db bash -lc 'PGPASSWORD="$POS
 
 ---
 
+## 🧩 Подключение к базам через DBeaver
+
+Ниже — краткая инструкция, как подключиться к Greenplum и демо-БД bookings из DBeaver. Перед этим убедитесь, что стенд запущен:
+
+- `cp .env.example .env` (если ещё не делали)
+- `make up`
+- `make bookings-init`
+- `make ddl-gp`
+
+### Greenplum (аналитическая БД)
+
+1. Откройте DBeaver → **New Database Connection**.
+2. Выберите драйвер **PostgreSQL** (или **Greenplum**, если он есть в вашей версии DBeaver).
+3. На вкладке **Main** заполните поля (по умолчанию):
+   - `Host`: `localhost`
+   - `Port`: `5435` (внешний порт Greenplum на хосте)
+   - `Database`: значение `GP_DB` (по умолчанию `gpadmin`)
+   - `Username`: значение `GP_USER` (по умолчанию `gpadmin`)
+   - `Password`: значение `GP_PASSWORD` (по умолчанию `gpadmin`)
+4. Нажмите **Test Connection** → **OK**, затем **Finish**.
+
+После подключения:
+
+- Основные таблицы лаба — в схеме `public` базы `gpadmin` (например, `public.orders`).
+- После настройки PXF и выполнения `make ddl-gp` станет доступна внешняя таблица `public.ext_bookings_bookings` — чтение из демо-БД bookings через PXF.
+
+### bookings-db (демо-БД источника)
+
+Для работы с исходными данными (демо-БД `demo`) достаточно стандартного PostgreSQL-подключения.
+
+1. Откройте DBeaver → **New Database Connection** → драйвер **PostgreSQL**.
+2. На вкладке **Main** укажите (значения по умолчанию из `.env.example`):
+   - `Host`: `localhost`
+   - `Port`: значение `BOOKINGS_DB_PORT` из `.env` (по умолчанию `5434`)
+   - `Database`: `demo`
+   - `Username`: `BOOKINGS_DB_USER` (по умолчанию `bookings`)
+   - `Password`: `BOOKINGS_DB_PASSWORD` (по умолчанию `bookings`)
+3. Нажмите **Test Connection** → **OK**, затем **Finish**.
+
+После подключения:
+
+- Основные таблицы находятся в схеме `bookings` базы `demo` (например, `bookings.bookings`, `bookings.tickets`, `bookings.flights` и т.д.).
+- Можно сравнивать данные:
+  - между `bookings.bookings` в Postgres и `public.ext_bookings_bookings` в Greenplum;
+  - между временем (`book_date`) в UTC в `demo` и локальным временем в Greenplum (учитывая `TZ=Europe/Moscow`).
+
+> Если вы меняли порты или креды в `.env`, не забудьте подставить те же значения в настройках соединений в DBeaver.
+
+---
+
 ## 🆘 Типичные проблемы и решения
 
 | Проблема | Решение |