Page tree

Release 8.7.1


Scheduled Maintenance: will be offline for maintenance at 3:00pm UTC on Tuesday March 28 for about 15 minutes.



This section provides general information on how the Designer Cloud Enterprise Edition uses SQL to interact with your databases, including syntax requirements and examples.

Basic Syntax

Your SQL statements must be valid for the syntax expected by the target relational system. In particular, object delimiters may vary between systems. 

NOTE: The proper syntax depends on your database system. Please consult the documentation for your product for details.

Tip: Although some relational systems do not require object delimiters around column names, it is recommended that you add them to all applicable objects.

Tip: Avoid using column type identifiers (e.g. int) and other SQL keywords as object names. Some systems may generate invalid SQL errors.

NOTE: In the following sections, Oracle syntax is used in the examples. Please modify the examples for your target system.

Supported syntax by datastore

For more information on the supported syntax for your datastore, please see the documentation for the connection type. See Connection Types.

General Examples

Here are some basic SQL examples to get started.

Column aliasing

If your select statement results in multiple columns with same name, the query fails to validate or fails on execution, such as selecting all columns in a JOIN. In these cases, columns must be properly aliased.

NOTE: This error will be caught either during validating or during dataset import.

For example, in the following JOIN, the EMPLOYEE and DEPARTMENT tables have column names department_id and department_id

SELECT * FROM EMPLOYEE INNER JOIN DEPARTMENT ON (department_id = department_id);

The above query generates an error. Columns must be properly aliased, as in the following:

SELECT, e.department_id, e.first_name, e.last_name, d.department_name FROM EMPLOYEE AS E INNER JOIN DEPARTMENT d ON (e.department_id = d.department_id);

Collect whole table

SELECT * FROM "DB1"."table2";

Filter columns

SELECT lastName,firstName FROM "DB1"."table2";

Filter rows

SELECT lastName,firstName FROM "DB1"."table2" WHERE invoiceAmt > 10000;

Multi-line statement for imported datasets

The following example uses a multi-line SQL sequence to import a dataset:

NOTE: Multi-line SQL support is considered an advanced use case. This feature must be enabled.

The following example inserts values in the TABLE_INVENTORY table and then queries the table. It utilizes Oracle syntax:


This page has no comments.