organize sections on adapted types, attachements, and filepaths

Author: dimitri-yatsenko

book/30-schema-design/010-schema.ipynb

@@ -11,13 +11,11 @@
     "  - date: 2025-01-12\n",
     "---\n",
     "\n",
-    "# Create Schemas\n",
-    "\n",
-    "## What is a schema?\n",
+    "# What is a schema?\n",
     "\n",
     "The term schema has two related meanings in the context of databases:\n",
     "\n",
-    "### 1. Schema as a Data Blueprint\n",
+    "## 1. Schema as a Data Blueprint\n",
     "A **schema** is a formal specification of the structure of data and the rules governing its integrity.\n",
     "It serves as a blueprint that defines how data is organized, stored, and accessed within a database.\n",
     "This ensures that the database reflects the rules and requirements of the underlying business or research project it supports.\n",
@@ -27,20 +25,20 @@
     "* Rules and constraints that ensure data consistency, accuracy, and reliability.\n",
     "* Relationships between tables, such as primary keys (unique identifiers for records) and foreign keys (references to related records in other tables).\n",
     "\n",
-    "#### Aims of Good Schema Design\n",
+    "### Aims of Good Schema Design\n",
     "* **Data Integrity**: Ensures consistency and prevents anomalies.\n",
     "* **Query Efficiency**: Facilitates fast and accurate data retrieval, supports complex queries, and optimizes database performance.\n",
     "* **Scalability**: Allows the database to grow and adapt as data volumes increase.\n",
     "\n",
-    "#### Key Elements of Schema Design\n",
+    "### Key Elements of Schema Design\n",
     "* **Tables and Attributes**: Each table is defined with specific attributes (columns), each assigned a data type.\n",
     "* **Primary Keys**: Uniquely identify each record in a table.\n",
     "* **Foreign Keys**: Establish relationships between entities in tables.\n",
     "* **Indexes**: Support efficient queries.\n",
     "\n",
     "Through careful schema design, database architects create systems that are both efficient and flexible, meeting the current and future needs of an organization. The schema acts as a living document that guides the structure, operations, and integrity of the database.\n",
     "\n",
-    "### 2. Schema as a Database Module\n",
+    "## 2. Schema as a Database Module\n",
     "\n",
     "In complex database designs, the term \"schema\" is also used to describe a distinct module of a larger database with its own namespace that groups related tables together. \n",
     "This modular approach:\n",
@@ -100,13 +98,6 @@
     "With this foundation, you are ready to begin declaring tables and building your data pipeline."
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  },
   {
    "cell_type": "markdown",
    "metadata": {},

book/30-schema-design/083-attach.ipynb

@@ -1,5 +1,12 @@
 {
  "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Filepaths"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 1,
@@ -1293,10 +1300,10 @@
        "<!-- StateFlower -->\n",
        "<g class=\"node\" id=\"node1\">\n",
        "<title>StateFlower</title>\n",
-       "<g id=\"a_node1\"><a xlink:title=\"→ State\r",
-       "------------------------------\r",
-       "flower_image         \r",
-       "INDEX (flower_image)\r",
+       "<g id=\"a_node1\"><a xlink:title=\"→ State\r\n",
+       "------------------------------\r\n",
+       "flower_image         \r\n",
+       "INDEX (flower_image)\r\n",
        "\">\n",
        "<ellipse cx=\"50.625\" cy=\"-17.5\" fill=\"#00007f\" fill-opacity=\"0.250980\" rx=\"50.7503\" ry=\"17.5\" stroke=\"#00007f\" stroke-opacity=\"0.250980\"/>\n",
        "<text fill=\"#00007f\" font-family=\"arial\" font-size=\"12.00\" text-anchor=\"middle\" x=\"50.625\" y=\"-14.4\">StateFlower</text>\n",
@@ -1306,9 +1313,9 @@
        "<!-- State -->\n",
        "<g class=\"node\" id=\"node2\">\n",
        "<title>State</title>\n",
-       "<g id=\"a_node2\"><a xlink:title=\"state_code           \r",
-       "------------------------------\r",
-       "state                \r",
+       "<g id=\"a_node2\"><a xlink:title=\"state_code           \r\n",
+       "------------------------------\r\n",
+       "state                \r\n",
        "\">\n",
        "<polygon fill=\"#000000\" fill-opacity=\"0.125490\" points=\"125.625,-106 85.625,-106 85.625,-71 125.625,-71 125.625,-106\" stroke=\"transparent\"/>\n",
        "<text fill=\"#000000\" font-family=\"arial\" font-size=\"10.00\" text-anchor=\"start\" text-decoration=\"underline\" x=\"93.625\" y=\"-87\">State</text>\n",
@@ -1323,10 +1330,10 @@
        "<!-- StateBird -->\n",
        "<g class=\"node\" id=\"node5\">\n",
        "<title>StateBird</title>\n",
-       "<g id=\"a_node5\"><a xlink:title=\"→ State\r",
-       "------------------------------\r",
-       "bird_image           \r",
-       "INDEX (bird_image)\r",
+       "<g id=\"a_node5\"><a xlink:title=\"→ State\r\n",
+       "------------------------------\r\n",
+       "bird_image           \r\n",
+       "INDEX (bird_image)\r\n",
        "\">\n",
        "<ellipse cx=\"160.625\" cy=\"-17.5\" fill=\"#00007f\" fill-opacity=\"0.250980\" rx=\"41.0015\" ry=\"17.5\" stroke=\"#00007f\" stroke-opacity=\"0.250980\"/>\n",
        "<text fill=\"#00007f\" font-family=\"arial\" font-size=\"12.00\" text-anchor=\"middle\" x=\"160.625\" y=\"-14.4\">StateBird</text>\n",
@@ -1341,9 +1348,9 @@
        "<!-- Organization -->\n",
        "<g class=\"node\" id=\"node3\">\n",
        "<title>Organization</title>\n",
-       "<g id=\"a_node3\"><a xlink:title=\"organization         \r",
-       "------------------------------\r",
-       "logo_url             \r",
+       "<g id=\"a_node3\"><a xlink:title=\"organization         \r\n",
+       "------------------------------\r\n",
+       "logo_url             \r\n",
        "\">\n",
        "<polygon fill=\"#000000\" fill-opacity=\"0.125490\" points=\"283.125,-106 212.125,-106 212.125,-71 283.125,-71 283.125,-106\" stroke=\"transparent\"/>\n",
        "<text fill=\"#000000\" font-family=\"arial\" font-size=\"10.00\" text-anchor=\"start\" text-decoration=\"underline\" x=\"220.125\" y=\"-87\">Organization</text>\n",
@@ -1353,10 +1360,10 @@
        "<!-- Logo -->\n",
        "<g class=\"node\" id=\"node4\">\n",
        "<title>Logo</title>\n",
-       "<g id=\"a_node4\"><a xlink:title=\"→ Organization\r",
-       "------------------------------\r",
-       "logo_image           \r",
-       "INDEX (logo_image)\r",
+       "<g id=\"a_node4\"><a xlink:title=\"→ Organization\r\n",
+       "------------------------------\r\n",
+       "logo_image           \r\n",
+       "INDEX (logo_image)\r\n",
        "\">\n",
        "<ellipse cx=\"247.625\" cy=\"-17.5\" fill=\"#00007f\" fill-opacity=\"0.250980\" rx=\"27.5\" ry=\"17.5\" stroke=\"#00007f\" stroke-opacity=\"0.250980\"/>\n",
        "<text fill=\"#00007f\" font-family=\"arial\" font-size=\"12.00\" text-anchor=\"middle\" x=\"247.625\" y=\"-14.4\">Logo</text>\n",