Use cases

Filter data using an SQL query to display specific data from the database.

You can compose a query:

As text

By using the String formatter and its relative placeholders:

sql_identifier

and

sql_literal

TIP: Do not specify the table name in the

FROM

clause. Specify the table name in the dynamic link to the

BrowseName

of the table with an

{0:sql_identifier}

placeholder in a string formatter.

Use case: filter by time

Use the

Time

Timestamp

column that contains the date and time to filter data by time.

Use the

sql_literal

literal in the placeholder of the string formatter. Consider using a temporary

DateTime

variable.

Example. Export records that have a Timestamp greater than a certain instant of time:

SELECT * FROM {0:sql_identifier} WHERE Timestamp > {1:sql_literal}

Example. Export records that have a Timestamp between two instants of time:

SELECT * FROM {0:sql_identifier} WHERE Timestamp BETWEEN {1:sql_literal} AND {2:sql_literal}

Use the Timestamp column to create a time filter on a Logger. Use the Time column to filter alarm history.

Use case: filter by alarm severity

The

Severity

column contains the value of the severity of an alarm. Use this column to filter various severities of an alarm grid or alarm history grid.

Example. Export the history of alarms with severity 1:

SELECT * FROM {0:sql_identifier} WHERE Severity = 1

Example. Export the history of alarms with severity between 1 and 3:

SELECT * FROM {0:sql_identifier} WHERE Severity BETWEEN 1 AND 3

Use case: filter by alarm or variable

The

ConditionName

column contains the name of the alarm. Filter archived alarms to obtain specific alarms. You can filter alarm names if they follow a specific pattern.

The condition can be used on the

SourceName

column to filter by the input variable.

Example. Export the alarm history with a given BrowseName in the past:

SELECT * FROM {0:sql_identifier} WHERE ConditionName = {1:sql_literal}

Example. Export the history of the alarms connected to the variable:

SELECT * FROM {0:sql_identifier} WHERE SourceName = {1:sql_literal}

Example. Export the history of alarms starting with Exclusive:

SELECT * FROM {0:sql_identifier} WHERE ConditionName LIKE 'Exclusive%'

Use case: filtering Recorded Alarms

Export some columns of the logger.

Example. Export the alarm history with only the Italian columns:

SELECT "ActiveState_it-IT", "AckedState_it-IT", "ConfirmedState_it-IT", "ConditionName", "EnabledState_it-IT", "SourceName", "Time", "Message_it-IT", "Severity" FROM {0:sql_identifier}

SQL queries

Provide Feedback

Have questions or feedback about this documentation? Please submit your feedback here.