Skip to main content
Datasource reference configuration showing datasource picker

Overview

The Datasource Reference source type lets you create a new datasource that reads data from another existing datasource. This is the foundation for derived datasources that compute or combine data from multiple sources.

Configuration

FieldDescription
idThe ID of an existing worker-mode datasource to use as a data source.
Only worker-mode datasources (datasources that pull and store data) can be used as references. The referenced datasource must have a live version with data.

Use Cases

Datasource references are used in several special configurations:
ConfigurationDescription
Merged DatasourcesCombine two datasources by joining them on a common field. See Special Configurations.
Best ProductsCompute top-performing products by combining a product catalog datasource with an analytics datasource.
Top AttributesIdentify preferred product attributes (brands, categories) per user based on behavioral data.
Bought Together (Cross-sell)Identify products frequently purchased together.

How It Works

  1. The new datasource reads data from the referenced datasource’s live storage instead of an external source.
  2. Fields from the referenced datasource are available for mapping in the new datasource.
  3. When the referenced datasource updates, the dependent datasource can automatically refresh (depending on the configured refresh schedule).
You can chain datasource references to build multi-step data pipelines — for example, merge a product catalog with CRM data, then compute best products on the merged result.