Skip to content

Commit cbd6a36

Browse files
docs: define the term as 'schema dimension' (shortened to 'dimension') (#239)
Promote 'schema dimension' to the defined term in its two definitional homes (Entity Integrity section Schema dimensions; Read Diagrams section Dimensions and Underlined Names), then shorten to 'dimension' in-context. Canon already used 'Schema dimensions' as the section heading and 'lineage through schema dimensions' in prose — this makes the defined term consistent and disambiguates from array and data-warehouse 'dimension'. Headings/anchors unchanged. Note: read-diagrams cell source normalized to a single string by the notebook editor; llms-full.txt regenerates from source.
1 parent a54cd9c commit cbd6a36

2 files changed

Lines changed: 4 additions & 16 deletions

File tree

src/explanation/entity-integrity.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -213,7 +213,8 @@ in a single statement.
213213

214214
## Schema dimensions
215215

216-
A **dimension** is an independent axis of variation in the data. The rule:
216+
A **schema dimension** — often shortened to *dimension* — is an independent axis of
217+
variation in the data. The rule:
217218

218219
> **Any table that introduces a new primary-key attribute introduces a new
219220
> dimension.**

src/how-to/read-diagrams.ipynb

Lines changed: 2 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -389,20 +389,7 @@
389389
"cell_type": "markdown",
390390
"id": "cell-dim-md",
391391
"metadata": {},
392-
"source": [
393-
"## Dimensions and Underlined Names\n",
394-
"\n",
395-
"A **dimension** is a new entity type introduced by a table that defines new primary key attributes. Each underlined table introduces exactly **one** dimension—even if it has multiple new PK attributes, together they identify one new entity type.\n",
396-
"\n",
397-
"| Visual | Meaning |\n",
398-
"|--------|--------|\n",
399-
"| **Underlined** | Introduces a new dimension (new entity type) |\n",
400-
"| Not underlined | Exists in the space defined by dimensions from referenced tables |\n",
401-
"\n",
402-
"**Key rules:**\n",
403-
"- Computed tables **never** introduce dimensions (always non-underlined)\n",
404-
"- Part tables **can** introduce dimensions (may be underlined)"
405-
]
392+
"source": "## Dimensions and Underlined Names\n\nA **schema dimension** (often shortened to *dimension*) is a new entity type introduced by a table that defines new primary key attributes. Each underlined table introduces exactly **one** dimension—even if it has multiple new PK attributes, together they identify one new entity type.\n\n| Visual | Meaning |\n|--------|--------|\n| **Underlined** | Introduces a new dimension (new entity type) |\n| Not underlined | Exists in the space defined by dimensions from referenced tables |\n\n**Key rules:**\n- Computed tables **never** introduce dimensions (always non-underlined)\n- Part tables **can** introduce dimensions (may be underlined)"
406393
},
407394
{
408395
"cell_type": "code",
@@ -3473,4 +3460,4 @@
34733460
},
34743461
"nbformat": 4,
34753462
"nbformat_minor": 5
3476-
}
3463+
}

0 commit comments

Comments
 (0)