liveBook · Manning

Data dictionary

As explained in The Well-Grounded Data Analyst

A data dictionary is structured documentation describing a dataset's fields, meanings, formats, and permissible values.

A data dictionary is structured documentation for a dataset: it names fields and records their meanings, formats, and permitted values. Read it before exploring or transforming data, because it states the assumptions attached to each column. section 2.1.1 section 3.2.2

Treat the dictionary as a starting hypothesis, not proof. Compare its definitions with actual records: check whether identifiers join as expected, whether claimed date ranges exist, and whether required fields contain missing values. When documentation is absent, first note the available data consistently across files, then create a dictionary for the fields used. section 3.2.2 section 5.2.2 section 6.4.1

A useful dictionary can support practical analytical decisions by documenting:

  • Identifiers and relationships, such as customer, product, session, transaction, and location IDs. section 3.2.2 section 8.2.2
  • Time fields and their granularity, such as an event timestamp, count date, or hourly interval. section 4.2.2 section 8.2.2
  • Categorical codes and their meanings, such as event types, property types, tenure, and new-build status. section 4.2.2 section 10.2.2
  • How collection instruments map questions to answer columns, including questions represented across several columns. section 6.2.2

Restoring headings to transaction files

Yearly property files without headers can be loaded using names derived from the dictionary, including transaction ID, sale price, sale date, postcode, property type, and tenure. Parsing the date then makes it possible to verify that the combined data covers the expected years before analysis. section 10.2.2 section 10.4.1

Table 2.1 Data dictionary for the customer address dataset
Column
Definition
company_id
A unique identifier for each customer company in the dataset
address
A single field to store the customer address
total_spend
The total amount this customer has spent to date (in GBP)

This compact dictionary links a customer identifier, free-form address, and cumulative spend to the fields available for geographic analysis. section 2.1.1

How The Well-Grounded Data Analyst covers it

How deep it goes
Explains practical reading, schema verification, and dictionary creation, without defining a formal documentation standard.
Examples
Uses customer addresses, purchases, events, surveys, traffic counts, property transactions, and mobile events as documented datasets.
What it assumes
Assumes access to a dataset and any accompanying documentation while teaching documentation review as the first analytical step.
What you can do after
Evaluate/understand a dataset’s fields, test its documented assumptions, and create documentation when none is supplied.
How it connects
Connects exploratory data analysis, missing data, identifiers, categorical data, time series, and data preparation.

Also explained in

Compare how 5 books explain data dictionary →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of The Well-Grounded Data Analyst. The section links point to the parts of the book it draws on.