Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt

Use this file to discover all available pages before exploring further.

The schema defines data tables and how they are are linked together. Schemas often follow a star schema structure, where multiple reference tables are connected to a central table using key fields.
  • A reference table refers to tables that are joined to another table.
Database schema
A schema defines how data is organized and related within a database. Tables in a schema can be linked using references, which establish relationships between them. A reference maps key fields from one table (the owner) to foreign key fields in another table (the target). This allows data from different tables to be queried together. At the center of each schema is the fact table. This fact table typically contains the main transactional records, such as trades with fields like customer_name. Other tables can link to the central fact table or to each other through references. This creates a connected structure. In a typical star schema, reference tables act as dimension tables joined to the central fact table. This design simplifies queries and improves performance. More complex schemas include multiple tables, resulting in a snowflake schema or other variations. The additional tables are connected to the fact table at the center of the snowflake schema.
Database star schema

How are tables joined to form a schema?

A reference table can link to other tables. For example:
  • The fact table contains trade records with a customer_name field. There is only one fact table for each cube on the database schema.
  • A reference table maps customer_county to country_name.
This setup allows users to filter or classify trades by country, even though the fact table does not contain country data directly.
Database star schema
A table can reference another table multiple times, as long as each reference uses a different set of fields. For example:
  • The fact table contains trade records with seller and buyer fields.
  • The fields seller and buyer map to the key in a table for party records.
Database multiple records
Find out more about table joins:

Are all tables joined to the schema?

Isolated tables are part of the datastore but are not joined to the fact table. They are look-up tables that enrich data. Find out more about store look-up measures. Isolated tables are useful for:
  • Lookup and reference data: Store external values such as currency conversion rates or other market data.
  • Supporting calculations: Provide values that support the calculation of measures. These values can be market reference data or other computed values stored in the isolated table.
  • Display purposes: Help format or translate values for better readability.
Database isolated tables
Find out more about isolated tables:

What kinds of fields are supported by Atoti?

Atoti supports a wide range of field types:
  • Numerical (native) types: int, double, float
    Typically used as measures and aggregated by Atoti.
  • Strings
    Used as classifiers, table levels, and filters.
  • Dates and times
    Enable Atoti to interpret and filter by date ranges.
  • Vectors Useful for financial analytics like Value at Risk (VaR).
    Atoti is optimized for storing and aggregating vector-based data structures efficiently.
  • Objects Custom objects can be stored.
Find out more about key fields using: