System Functions

System functions provide access to information in the Teiid system from within a query.


Retrieve a string from the command payload or null if no command payload was specified. The command payload is set by the TeiidStatement.setPayload method on the Teiid JDBC API extensions on a per-query basis.


If the key parameter is provided, the command payload object is cast to a java.util.Properties object and the corresponding property value for the key is returned. If the key is not specified the return value is the command payload object toString value.

key, return value are strings


Retrieve a system environment property.


To prevent untrusted access to system properties, this function is not enabled by default. The ENV function needs to be enabled via CLI


or edit the standalone-teiid.xml file and add following to the "teiid" subsystem


then call using ENV('KEY'), which returns value as string. Ex: ENV('PATH')


Retrieve the node id - typically the System property value for "" which will not be set for Teiid embedded.


return value is string.


Retrieve the string form of the current session id.


return value is string.


Retrieve the name of the user executing the query.


includeSecurityDomain is a boolean. return value is string.

If includeSecurityDomain is omitted or true, then the user name will be returned with @security-domain appended.


Retrieve the catalog name of the database. The VDB name is always the catalog name.


return value is string.


Retrieve the session variable.


name is a string and the return value is an object.

A null name will return a null value. Typically you will use the a get wrapped in a CAST to convert to the desired type.


Set the session variable.

TEIID_SESSION_SET(name, value)

name is a string, value is an object, and the return value is an object.

The previous value for the key or null will be returned. A set has no effect on the current transaction and is not affected by commit/rollback.


Get a column value from the generated keys of the previous statement.


column_name is a string. The return value is of type object.

Null is returned if there is no such generated key nor matching key column. Typically this function will only be used within the scope of procedure to determine a generated key value from an insert. It should not be expected that all inserts provide generated keys as not all sources support returning generated keys.

results matching ""

    No results matching ""