Integration.Run

The Integration.Run provider enables you to write a Luminesce SQL query that provides details on the current state of one or more integration instance runs.

Note: The LUSID user running the query must have sufficient access control permissions to both use the provider and read integration run data. This should automatically be the case if you are the domain owner.

See also: Integration.Dashboard, Integration.Execute, Integration.Log

Basic usage

select * from Integration.Run where <filter-expression>;

Data fields

By default, Integration.Run 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 the following query using a suitable tool:

select FieldName, DataType, IsMain, IsPrimaryKey, SampleValues, Description from Sys.Field where TableName = 'Integration.Run' and FieldType = 'Column';

Note: Fields marked 'main' are returned by queries that include a caret character, for example select ^ from Integration.Run.

Examples

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

Example 1: Retrieve first 10 integration instance runs

select * from Integration.Run limit 10

Example 2: Retrieve run details for a particular integration instance

select RunId, Status from Integration.Run where InstanceId = '6ec0f4a6-14f4-48ea-b803-a750feb0d313'

Example 3: Retrieve runs for a particular day

select * from Integration.Run where AsAtCreated >= #2025-10-08#