Query input parameters

Refer to values provided to a query at runtime to dynamically customize its behavior. They are placeholders in a query that get substituted with actual data during execution. These parameters help avoid hardcoding values in SQL statements, improve query flexibility, and enhance security by preventing SQL injection when used correctly.

Query parameters should be surrounded by curly brackets.

select * from "User" where "firstName"={firstName} and "secondName"={secondName}

There are two input parameters in the example above:

firstName
secondName

Parameter names can differ from SQL table column names; this is valid:

select * from "User" where "firstName"={fName} and "secondName"={sName}

In this case, fName and sName will be visible in the connector builder view.

The name should consist only of letters, digits, and underscore characters, , and must start with a letter.

{myParam1_} - valid
{1myParam} - not valid
{_myParam} - not valid
{myParam@$#^%&*!-+=} - not valid

Data types

The parameter type should be defined. Default system type is: pdk.core.String. The system automatically converts the selected type to the corresponding DB data type. For example, pdk.core.String can be automatically converted to VARCHAR, TEXT, CHAR, and other types. If you need to cast to a specific DB type, the cast function should be used.

Possible types

pdk.core.String and pdk.core.Array<String>
pdk.core.Integer and pdk.core.Array<Integer>
pdk.core.Boolean and pdk.core.Array<Boolean>
pdk.core.Float and pdk.core.Array<Float>
pdk.core.Array<Byte> - for BLOB data type

Arrays are processed as lists of values with a comma as the delimiter.

select * from "users" where "id" in ({ids})

ids parameter type is pdk.core.Array<Integer> and contains values [1,2,3]. SQL will be transformed into:

select * from "users" where "id" in (1,2,3)

Cast functions

Type Casts converts a value from one data type to another specified data type. This can be done in two ways:

Explicitly using the CAST() function in PostgreSQL and Oracle
Use :: operator, this works only in PostgreSQL

Example:

insert into "application" ("applicationAsJson") values ({application}::json)

insert into "application" ("applicationAsJson") values (CAST({application} as json))

{application} is an input parameter with the selected type pdk.core.String.

Cast operation will transform string to json.

PostgreSQL cast operators

Cast operator

The platform type

PostgreSQL Type

::timestamp

Data types

Possible types

Cast functions

PostgreSQL cast operators

Oracle cast operations