blob: 6cbee0c09dbd4e83e8a9b870c7ae348848861bde [file] [log] [blame]
.. 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
.. Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
Apache HDFS Connection
The Apache HDFS connection type enables connection to Apache HDFS.
Default Connection IDs
HDFS Hook uses parameter ``hdfs_conn_id`` for Connection IDs and the value of the parameter
as ``hdfs_default`` by default.
Web HDFS Hook uses parameter ``webhdfs_conn_id`` for Connection IDs and the value of the
parameter as ``webhdfs_default`` by default.
Configuring the Connection
The host to connect to, it can be ``local``, ``yarn`` or an URL. For Web HDFS Hook it is possible to specify multiple hosts as a comma-separated list.
Specify the port in case of host be an URL.
Effective user for HDFS operations (non-Kerberized).
Extra (optional, connection parameters)
Specify the extra parameters (as json dictionary) that can be used in HDFS connection. The following
parameters out of the standard python parameters are supported:
* ``autoconfig`` - Default value is bool: False. Use snakebite's automatically configured client. This HDFSHook implementation requires snakebite.
* ``hdfs_namenode_principal`` - Specifies the Kerberos principal to use for HDFS.
The following extra parameters can be used to configure SSL for Web HDFS Hook:
* ``use_ssl`` - If SSL should be used. By default is set to `false`.
* ``verify`` - How to verify SSL. For more information refer to