Apache Trino Connection¶

The Apache Trino connection type enables connection to Trino which is a distributed SQL query engine designed to query large data sets distributed over one or more heterogeneous data sources.

Default Connection IDs¶

Trino Hook uses the parameter trino_conn_id for Connection IDs and the value of the parameter as trino_default by default. Trino Hook supports multiple authentication types to ensure all users of the system are authenticated, the parameter auth can be set to enable authentication. The value of the parameter is None by default.

Configuring the Connection¶

Host

The host to connect to, it can be local, yarn or an URL.

Port

Specify the port in case of host is an URL.

Login

Effective user for connection.

Password

This can be to pass to enable Basic Authentication. This is an optional parameter and is not required if a different authentication mechanism is used.

Extra (optional, connection parameters)

Specify the extra parameters (as json dictionary) that can be used in Trino connection. The following parameters out of the standard python parameters are supported:

auth - Specifies which type of authentication needs to be enabled. The value can be certs, kerberos, or jwt
impersonate_as_owner - Boolean that allows to set AIRFLOW_CTX_DAG_OWNER as a user of the connection.

The following extra parameters can be used to configure authentication:

jwt__token - If jwt authentication should be used, the value of token is given via this parameter.
jwt__file - If jwt authentication should be used, the location on disk for the file containing the jwt token.
certs__client_cert_path, certs__client_key_path- If certificate authentication should be used, the path to the client certificate and key is given via these parameters.
kerberos__service_name, kerberos__config, kerberos__mutual_authentication, kerberos__force_preemptive, kerberos__hostname_override, kerberos__sanitize_mutual_error_response, kerberos__principal, kerberos__delegate, kerberos__ca_bundle - These parameters can be set when enabling kerberos authentication.
session_properties - JSON dictionary which allows to set session_properties. Example: {'session_properties':{'scale_writers':true,'task_writer_count:1'}}
client_tags - List of comma separated tags. Example {'client_tags':['sales','cluster1']}`
timezone - The time zone for the session can be explicitly set using the IANA time zone name. Example: {'timezone':'Asia/Jerusalem'}.
extra_credential - List of key-value string pairs which are passed to the Trino connector. For more information, refer to the Trino client protocol doc page here: https://trino.io/docs/current/develop/client-protocol.html
roles - Mapping of catalog names to their corresponding Trino authorization role. For more information, refer to the Trino Python client docs here: https://github.com/trinodb/trino-python-client?tab=readme-ov-file#roles

Note: If jwt__file and jwt__token are both given, jwt__file will take precedent.