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

@@ -538,6 +538,29 @@
" for row in cur.fetchall():\n",
" print(f'{row[0]}.{row[1]}')"
]
},
{
"cell_type": "markdown",
"id": "11",
"metadata": {},
"source": [
"## Tables Created by This Notebook and Their Relationships\n",
"\n",
"### Tables Created / Maintained\n",
"1. `TARGET_TABLE` (configured at runtime)\n",
"- Generic loader output table built from the current dataframe schema.\n",
"- Replaced/appended according to `if_exists` behavior.\n",
"- Optional point geometry can be added in helper cells.\n",
"\n",
"### Key Relationships\n",
"- This notebook is table-agnostic: relationships depend on the selected `TARGET_TABLE` and source columns.\n",
"- When key columns (for example `master_id`, `geoid`, IDs, dates) are present, the loaded table can be joined to domain tables.\n",
"- When geometry is present, the loaded table can participate in spatial joins.\n",
"\n",
"### Rerun Notes\n",
"- Safe to rerun for recurring refreshes of different source files.\n",
"- Always confirm `TARGET_TABLE` and `if_exists` before execution to avoid unintended replacement of existing tables."
]
}
],
"metadata": {