SQL Test Tool

1. Fernhill SCADA
2. Help
3. SQL Test Tool

Introduction

The SQL Test Tool allows you to:

• Choose a standard SQL query to run on the Fernhill SCADA database.
• Develop your own SQL query to run on the Fernhill SCADA database.

The results of the query are displayed in a table:

Starting the SQL Test Tool

From the Windows Start Menu

Choose the appropriate method to start the SQL Test Tool based on the version of Windows you are using:

From the Notification Icon

You can also start the SQL Test Tool from the Fernhill SCADA Notification Icon:

1. Right click on the Fernhill SCADA Notification Icon ,
2. Expand the View menu,
3. Select any one of the options.

SQL Test Tool Toolbar

The toolbar provides quick access to these functions:

Icon	Description
	Clear the SQL editor window
	Load the SQL editor window from a file
	Save the contents of the SQL editor window to a file
	Delete text; automatically saving the deleted text to the clipboard
	Copy the current text selection to the clipboard
	Paste text from the clipboard into the SQL editor window
	Undo the last editor action
	Redo the last editor action
	Connect the SQL Test Tool to the locally running Fernhill SCADA
	Stop execution of the current query
	Execute the current query once
	Start execution of the current query continuously
	Toggle the display of row numbers
	Display the execution plan for the current query

Selecting a Predefined Query

Fernhill SCADA defines a number of predefined queries. The predefined queries provide a convenient shortcut to explore the Fernhill SCADA Database. To select a predefined query:

1. From the menu select File.
2. Select Open Query.
3. Select the query from the list.

Exploring the Fernhill SCADA Database Schema

The Fernhill SCADA database contains database schema tables. Database schema tables provide metadata about the tables in the Fernhill SCADA Database. To select a schema table:

1. From the menu select File.
2. Select Open Schema.
3. Select a table from the list.

Color and Menus

The result of an SQL SELECT statement is displayed in the output pane of the SQL Test Tool. You can use column alias strings to the enhance the appearance of the result. For example:

• You can use a column value to define the color of rows.
• You can use a column value to associated a menu with a row.

See Column Aliases in the SQL Test Tool for information on how to do this.

Editing SQL Queries

The bottom pane in the SQL Test Tool is a text editor. The text editor allows you to:

• Modify an existing SQL query.
• Enter a new SQL query.

Once you begin typing in the SQL Editor Window, the query stops automatic execution. When you have finished your edits, press the button to restart automatic execution.

For the commands and shortcuts supported by the SQL text editor see Text Editor. For information about the SQL Query language supported by Fernhill SCADA see Fernhill SCADA Structured Query Language (SQL).

Highlighting Syntax Errors

Syntax and other types of error are automatically highlighted using a red underline. If you position the mouse near an error, a tooltip displays the cause of the error:

Further Information

Diagnosing Connection Problems

If you are having problems connecting to a Fernhill SCADA Server.

Fernhill SCADA

To learn about the tools in Fernhill SCADA.

Column Aliases in the SQL Test Tool

To learn how column alias values can change row colors and associate a context menu with rows.

Text Editor

To learn about the commands and shortcuts supported by the text editor.

Fernhill SCADA Structured Query Language (SQL)

To learn about the structured query language (SQL) supported by Fernhill SCADA.

Glossary

For the meaning of terms used in Fernhill SCADA.

Fernhill SCADA Version 3.59. Copyright © 2012-2020 Fernhill Software Ltd: All rights reserved.