Standardize notebook table-relationship documentation cells

This commit is contained in:
2026-05-22 14:21:51 -07:00
parent c95f22fcdb
commit 03239ad007
9 changed files with 147 additions and 191 deletions

View File

@@ -844,21 +844,18 @@
"source": [
"## Tables Created by This Notebook and Their Relationships\n",
"\n",
"This notebook creates and/or maintains one primary PostGIS table:\n",
"\n",
"### Tables Created / Maintained\n",
"1. `public.data_center_historical_climate`\n",
"- One row per data center (`master_id`).\n",
"- Stores climate summary metrics (temperature, humidity, wet-bulb, precipitation variability, cooling-degree-days, wind fields/status), geometry, and lineage timestamps.\n",
"- Upserted incrementally so reruns refresh changed rows without duplicating records.\n",
"\n",
"### Relationship Summary\n",
"- One row per `master_id` with climate summary fields and geometry.\n",
"- Populated by incremental upsert so reruns refresh existing sites and add new sites.\n",
"\n",
"### Key Relationships\n",
"- `public.master_data_centers (master_id)`\n",
" - 1-to-1 (effective) -> `public.data_center_historical_climate (master_id)`\n",
"\n",
"`public.data_center_historical_climate.master_id` is a foreign key to `public.master_data_centers.master_id` (with cascade delete), so climate rows track the master data-center record set.\n",
"\n",
"In short: **`master_data_centers` is the entity table, and `data_center_historical_climate` is its one-row-per-site climate feature extension.**"
"### Rerun Notes\n",
"- Safe to rerun when the master data-center set changes.\n",
"- Existing rows are updated in place; no duplicate-per-site history table is created by this notebook."
]
}
],