tak predchozi commit byl uprava dasbodu, toto je az fix te migrace
All checks were successful
deploy / deploy (push) Successful in 58s
test / smoke-test (push) Successful in 9s

This commit is contained in:
Dusan Vojacek
2026-04-10 20:58:04 +02:00
parent b8b3de2b70
commit 25090a9d95
3 changed files with 29 additions and 1 deletions

View File

@@ -0,0 +1,26 @@
---
description: TimescaleDB continuous aggregates komentáře a Flyway (EMS)
globs: db/**/*.sql
alwaysApply: false
---
# Timescale continuous aggregate v EMS
## Komentáře u CA (kritické)
Continuous aggregate vytvořený jako `CREATE MATERIALIZED VIEW … WITH (timescaledb.continuous)` **není** v systémovém katalogu PostgreSQL evidovaný jako běžný **materialized view**.
- **Nepoužívat** `COMMENT ON MATERIALIZED VIEW ems.<název_ca> …` → chyba SQL state **42809** („is not a materialized view“).
- **Použít** `COMMENT ON VIEW ems.<název_ca> …` — stejný vzor jako u `telemetry_inverter_hourly` v migraci **V011**.
Samotné **wrapper view** nad CA (např. `vw_telemetry_15m_7d` v repeatable `R__vw_telemetry_15m_7d.sql`) komentovat standardně `COMMENT ON VIEW`.
## Struktura repa
- **Definice CA + `add_continuous_aggregate_policy`**: verzovaná migrace `db/migration/V0xx__*.sql` (po aplikaci na DB neměnit — nová V migrace).
- **Definice čtecího view nad CA**: raději **repeatable** `db/views/R__vw_*.sql`, aby šla měnit jedna aktuální verze bez nové V migrace.
- **PostgREST**: `GRANT SELECT` na view v `db/views/R__z_postgrest_ems_anon_grants.sql`, ne na samotný CA.
## Odkaz v dokumentaci
Detailněji: `docs/04-modules/telemetry.md` (sekce o continuous aggregates a dashboardu).

View File

@@ -188,6 +188,7 @@ Specifikace z `docs/02-architecture.md`, modulových docs a komentářů v `plan
- Python: `snake_case`, type hints, Pydantic pro API modely. - Python: `snake_case`, type hints, Pydantic pro API modely.
- SQL: `snake_case`, explicitní FK; Flyway pořadí `V###__` / repeatable `R__`. - SQL: `snake_case`, explicitní FK; Flyway pořadí `V###__` / repeatable `R__`.
- Timescale **continuous aggregate** (CA): komentář k objektu CA je **`COMMENT ON VIEW`**, ne `COMMENT ON MATERIALIZED VIEW` (PG hlásí 42809). Viz `.cursor/rules/timescale-continuous-aggregate.mdc`.
- Výkon **W**, energie **Wh**, ceny **Kč/kWh**; čas v DB **`TIMESTAMPTZ` (UTC)**. - Výkon **W**, energie **Wh**, ceny **Kč/kWh**; čas v DB **`TIMESTAMPTZ` (UTC)**.
- NIKDY neupravuj existující V__ migrační soubory po jejich aplikaci na DB. - NIKDY neupravuj existující V__ migrační soubory po jejich aplikaci na DB.
- Pokud je potřeba opravit chybu ve verzované migraci, vytvoř novou V{N+1} migraci. - Pokud je potřeba opravit chybu ve verzované migraci, vytvoř novou V{N+1} migraci.

View File

@@ -27,7 +27,8 @@ SELECT add_continuous_aggregate_policy(
schedule_interval => INTERVAL '15 minutes' schedule_interval => INTERVAL '15 minutes'
); );
COMMENT ON MATERIALIZED VIEW ems.telemetry_inverter_15m IS -- Timescale CA není v katalogu „materialized view“ stejně jako V011 u telemetry_inverter_hourly.
COMMENT ON VIEW ems.telemetry_inverter_15m IS
'Čtvrthodinové agregáty telemetrie střídače. TimescaleDB continuous aggregate. 'Čtvrthodinové agregáty telemetrie střídače. TimescaleDB continuous aggregate.
Refresh každých 15 minut. Dashboard přehled (sloty 15 min). Refresh každých 15 minut. Dashboard přehled (sloty 15 min).
View vw_telemetry_15m_7d je v repeatable R__vw_telemetry_15m_7d.sql.'; View vw_telemetry_15m_7d je v repeatable R__vw_telemetry_15m_7d.sql.';