Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Data Model ERDs

Source Files

Data Model Design

Guidelines

  1. The database is a "black box", so nothing sees it except for core Registry code. All manipulation is done via APIs.
  2. Where possible, tables should be consolidated to keep the number of tables down and simplify administering them. As a general rule of thumb, if two tables have the same structure and vary by only one column name, the tables should be consolidated.

Naming Conventions

  1. Table names are prefixed CCT_ where CC indicates the responsible component and T indicates the type of table as enumerated above.
  2. Table and column names are all lowercase, with underscores (_) to separate words/fragments. StudlyCaps are not used.
  3. Natural english is preferred over major/minor. So start_date, not date_start.
  4. Column names should avoid incorporating the table name.
  5. The suffix _id indicates a row identifier.
  6. The suffix _t indicates a type identifier, as defined in ctx_data_types.

Terminology

Table Types

  • Staging (S): Tables that directly reflect the source (or "raw") data, with only minimal formatting changes.
  • Calculated (C): Tables that are the result of business rule execution.
  • Supporting (X): Tables that relate to the management of the system, and that are generally only modified by the administrator.
  • Original (O): Tables that hold data original to/originated by the Registry.
  • Dictionary (D): Support tables that hold definitions external to the Registry. Example: A list of countries.
  • View (V): A database view, constructed of underlying tables.

Table Data Descriptions

  • (Pre)defined: Definitions provided out of the box, may be added to by local deployment
  • Instantiated: Definitions added by local deployment
  • Standardized: Normalized data transformed from SOR specific format to common format
  • Raw: Untouched data from SOR
  • Calculated: Data calculated by transformation on raw, standardized, or calculated data

...