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

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:

  1. Explicitly using the CAST() function in PostgreSQL and Oracle

  2. Use :: operator, this works only in PostgreSQL

Example:

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

or

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

TIMESTAMP

::timestamptz

TIMESTAMPZ

::date

DATE

::time

TIME

::bit

BIT

::bit(n)

BIT VARYING(N)

::cidr

CIDR

::inet

INET

::json

JSON

::jsonb

JSONB

::macaddr

MACADDR

::macaddr8

MACADDR8

::pg_lsn

PG_LSN

::tsquery

TSQUERY

::tsvector

TSVECTOR

::txid_snapshot

TXID_SNAPSHOT

::uuid

UUID

::xml

XML

...and others

Oracle cast operations

You can find more information on the official website: https://docs.oracle.com/javadb/10.8.1.2/ref/rrefsqlj33562.html

Types

B O O L E A N

S M A L L I N T

I N T E G E R

B I G I N T

D E C I M A L

R E A L

D O U B L E

F L O A T

C H A R

V A R C H A R

L O N G V A R C H A R

C H A R F O R B I T D A T A

V A R C H A R F O R B I T D A T A

L O N G V A R C H A R F O R B I T D A T A

C L O B

B L O B

D A T E

T I M E

T I M E S T A M P

X M L

BOOLEAN

Y

-

-

-

-

-

-

-

Y

Y

Y

-

-

-

Y

-

-

-

-

-

SMALLINT

-

Y

Y

Y

Y

Y

Y

Y

Y

-

-

-

-

-

-

-

-

-

-

-

INTEGER

-

Y

Y

Y

Y

Y

Y

Y

Y

-

-

-

-

-

-

-

-

-

-

-

BIGINT

-

Y

Y

Y

Y

Y

Y

Y

Y

-

-

-

-

-

-

-

-

-

-

-

DECIMAL

-

Y

Y

Y

Y

Y

Y

Y

Y

-

-

-

-

-

-

-

-

-

-

-

REAL

-

Y

Y

Y

Y

Y

Y

Y

-

-

-

-

-

-

-

-

-

-

-

-

DOUBLE

-

Y

Y

Y

Y

Y

Y

Y

-

-

-

-

-

-

-

-

-

-

-

-

FLOAT

-

Y

Y

Y

Y

Y

Y

Y

-

-

-

-

-

-

-

-

-

-

-

-

CHAR

Y

Y

Y

Y

Y

-

-

-

Y

Y

Y

-

-

-

Y

-

Y

Y

Y

-

VARCHAR

Y

Y

Y

Y

Y

-

-

-

Y

Y

Y

-

-

-

Y

-

Y

Y

Y

-

LONG VARCHAR

Y

-

-

-

-

-

-

-

Y

Y

Y

-

-

-

Y

-

-

-

-

-

CHAR FOR BIT DATA

-

-

-

-

-

-

-

-

-

-

-

Y

Y

Y

Y

Y

-

-

-

-

VARCHAR FOR BIT DATA

-

-

-

-

-

-

-

-

-

-

-

Y

Y

Y

Y

Y

-

-

-

-

LONG VARCHAR FOR BIT DATA

-

-

-

-

-

-

-

-

-

-

-

Y

Y

Y

Y

Y

-

-

-

-

CLOB

Y

-

-

-

-

-

-

-

Y

Y

Y

-

-

-

Y

-

-

-

-

-

BLOB

-

-

-

-

-

-

-

-

-

-

-

-

-

-

-

Y

-

-

-

-

DATE

-

-

-

-

-

-

-

-

Y

Y

-

-

-

-

-

-

Y

-

-

-

TIME

-

-

-

-

-

-

-

-

Y

Y

-

-

-

-

-

-

-

Y

-

-

TIMESTAMP

-

-

-

-

-

-

-

-

Y

Y

-

-

-

-

-

-

Y

Y

Y

-

XML

-

-

-

-

-

-

-

-

-

-

-

-

-

-

-

-

-

-

-

Y

PreviousDynamic QueryNextStored Procedure

Last updated