---
title: "Lusid.RelationalDataset.x.x"
slug: "lusidrelationaldatasetxx"
updated: 2026-01-26T16:41:16Z
published: 2026-01-26T16:41:16Z
canonical: "support.lusid.com/lusidrelationaldatasetxx"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lusid.RelationalDataset.x.x

| **Type** | **Read/write** | **Author** | **Availability** |
| --- | --- | --- | --- |
| [Data provider](/v1/docs/what-are-a-data-provider-and-a-direct-provider) | Read | FINBOURNE | Provided with LUSID |

LUSID automatically creates a `Lusid.RelationalDataset.<rdd-scope>.<rdd-code>` provider in the Luminesce catalog for each [relational dataset definition](/v1/docs/how-do-i-create-a-relational-dataset-definition) (RDD) that exists:

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-1OOJORGG.png)

You can use this provider to write a [Luminesce SQL query](/v1/docs/understanding-the-luminesce-sql-query-syntax) that queries the dataset for that RDD. [More information](/v1/docs/how-do-i-query-a-custom-dataset).

**See also**: [Lusid.RelationalDataset.<rdd-scope>.<rdd-code>.Writer](/v1/docs/lusidrelationaldatasetxxwriter)

## Basic usage

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

## Query parameters

`Lusid.RelationalDataset.&lt;rdd-scope&gt;.&lt;rdd-code&gt;` 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](/v1/docs/what-tools-are-available-to-write-luminesce-queries):

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

## Data fields

By default, `Lusid.RelationalDataset.&lt;rdd-scope&gt;.&lt;rdd-code&gt;` 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](/v1/docs/what-tools-are-available-to-write-luminesce-queries):

```sql
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](https://github.com/finbourne/luminesce-examples/tree/master/examples).

### Example 1: Retrieve the latest records

Specify `QueryMethod = 'Latest'` to return just [data series in the dataset](/v1/docs/anatomy-of-a-dataset).

```sql
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](/v1/docs/anatomy-of-a-dataset).

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

### Example 3: Retrieve records effective from a particular date

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