providers/presto/docs/connections.rst
.. Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
.. http://www.apache.org/licenses/LICENSE-2.0
.. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
.. _howto/connection:presto:
The Presto connection type enables connection to Presto which is an open-source distributed SQL query engine designed for fast analytics on large-scale data sources, enabling interactive querying across multiple data platforms.
Presto Hook uses the parameter presto_conn_id for Connection IDs and the value of the parameter as presto_default by default.
Presto 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.
Host The host to connect to.
Port The port to connect to the host. Presto will use 8080 as default.
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 Presto 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 ``kerberos``.
* ``source`` - Specifies source to connect to. Default value is ``airflow``.
* ``protocol`` - Specifies port to connect with. Default value is ``http``.
* ``catalog`` - Specifies which catalog to use. Default value is ``hive``.
* ``verify`` - Client certificate path to connect with SSL/TLS.
The following extra parameters can be used to configure authentication:
* ``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.