docs(readme): add DBeaver guide and move DE-task to docs
- Why: - simplify first data checks for interview/demo audience - keep task reference in a stable docs location - What: - add short DBeaver connection section with ready-to-use params and quick SQL checks - update DE-task links in README to docs path - move DE-task from data/ to docs/ - Check: - README links resolve to docs/DE-task.md - git shows file move data/DE-task.md -> docs/DE-task.md
This commit is contained in:
@@ -4,7 +4,7 @@
|
||||
[](./docs/ARCHITECTURE.md)
|
||||
[]()
|
||||
|
||||
Мини-демо для решения задания [DE-task.md](./data/DE-task.md): развернуть инфраструктуру на своей машине, прогнать кликстрим через Kafka в ClickHouse, сделать регулярный расчёт в Airflow и подготовить витрины под дашборд.
|
||||
Мини-демо для решения задания [DE-task.md](./docs/DE-task.md): развернуть инфраструктуру на своей машине, прогнать кликстрим через Kafka в ClickHouse, сделать регулярный расчёт в Airflow и подготовить витрины под дашборд.
|
||||
|
||||
Фокус проекта: быстро показать работающий end-to-end сценарий и понятным языком объяснить, как устроены слои и почему пайплайн не падает на "грязных" данных.
|
||||
|
||||
@@ -77,6 +77,30 @@ docker compose exec -T clickhouse clickhouse-client --user=default --password=12
|
||||
|
||||
---
|
||||
|
||||
## Подключение DBeaver (кратко)
|
||||
|
||||
После прогона `ddl_init -> kafka_load -> etl_pipeline` можно быстро проверить витрины в DBeaver (удобно для демо бизнесу).
|
||||
|
||||
1. `Database -> New Database Connection -> ClickHouse`
|
||||
2. Параметры:
|
||||
- `Host`: `localhost`
|
||||
- `Port`: `9123` (HTTP)
|
||||
- `Database`: `default`
|
||||
- `Username`: `default`
|
||||
- `Password`: `123456`
|
||||
3. Нажать `Test Connection` -> `Finish`
|
||||
|
||||
Если ваш драйвер просит native-протокол, используйте порт `8002`.
|
||||
|
||||
Полезные быстрые запросы для первичного анализа:
|
||||
```sql
|
||||
SELECT count() AS rows FROM dm.v_events_enriched;
|
||||
SELECT * FROM dm.v_daily_traffic ORDER BY event_date DESC LIMIT 20;
|
||||
SELECT * FROM dm.v_utm_effectiveness ORDER BY clicks DESC LIMIT 20;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Архитектура (в двух словах)
|
||||
|
||||
```mermaid
|
||||
@@ -231,4 +255,4 @@ flowchart LR
|
||||
## Документация
|
||||
|
||||
- [Архитектура и слои](./docs/ARCHITECTURE.md) — подробное описание STG/ODS/DDS/DM, ER-диаграммы, обоснование решений
|
||||
- [DE-task.md](./data/DE-task.md) — исходное задание
|
||||
- [DE-task.md](./docs/DE-task.md) — исходное задание
|
||||
|
||||
Reference in New Issue
Block a user