Lusid.RelationalDataset.x.x

LUSID automatically creates a Lusid.RelationalDataset.<rdd-scope>.<rdd-code> provider in the Luminesce catalog for each relational dataset definition (RDD) that exists:

You can use this provider to write a Luminesce SQL query that queries the dataset for that RDD. More information.

See also: Lusid.RelationalDataset.<rdd-scope>.<rdd-code>.Writer

Basic usage

select * from Lusid.RelationalDataset.<rdd-scope>.<rdd-code> where <filter-expression>;

Query parameters

Lusid.RelationalDataset.<rdd-scope>.<rdd-code> has parameters that enable you to filter or refine a query.

To list available parameters, their data types, default values, and an explanation for each, run a query like this one using a suitable tool:

select FieldName, DataType, ParamDefaultValue, Description from Sys.Field 
  where TableName = 'Lusid.RelationalDataset.MyRDDs.Addresses' and FieldType = 'Parameter';

Data fields

By default, Lusid.RelationalDataset.<rdd-scope>.<rdd-code> returns a table of data populated with particular fields (columns). You can return a subset of these fields.

To list fields available to return, their data types, whether fields are considered 'main', and an explanation for each, run a query like this one using a suitable tool:

select FieldName, DataType, IsMain, IsPrimaryKey, SampleValues, Description from Sys.Field 
  where TableName = 'Lusid.RelationalDataset.MyRDDs.Addresses' and FieldType = 'Column';

Note: Fields marked 'main' are returned by queries that select a caret character, for example select ^ from Lusid.RelationalDataset.MyRDDs.Addresses

Examples

Note: For more example Luminesce SQL queries, visit our Github repo.

Example 1: Retrieve the latest records

Specify QueryMethod = 'Latest' to return just data series in the dataset.

select * from Lusid.RelationalDataset.MyRDDs.Addresses
  where QueryMethod = 'Latest';

Example 2: Retrieve every record

Specify QueryMethod = 'TimeSeries' to additionally return data points within data series.

select * from Lusid.RelationalDataset.MyRDDs.Addresses
  where QueryMethod = 'TimeSeries';

Example 3: Retrieve records effective from a particular date

select * from Lusid.RelationalDataset.MyRDDs.Addresses 
  where EffectiveAt >= #2025-01-01#