= hdfs
:type: input
:status: stable
:categories: ["Services"]



////
     THIS FILE IS AUTOGENERATED!

     To make changes, edit the corresponding source file under:

     https://github.com/redpanda-data/connect/tree/main/internal/impl/<provider>.

     And:

     https://github.com/redpanda-data/connect/tree/main/cmd/tools/docs_gen/templates/plugin.adoc.tmpl
////

// © 2024 Redpanda Data Inc.


component_type_dropdown::[]


Reads files from a HDFS directory, where each discrete file will be consumed as a single message payload.

```yml
# Config fields, showing default values
input:
  label: ""
  hdfs:
    hosts: [] # No default (required)
    user: ""
    directory: "" # No default (required)
```

== Metadata

This input adds the following metadata fields to each message:

- hdfs_name
- hdfs_path

You can access these metadata fields using
xref:configuration:interpolation.adoc#bloblang-queries[function interpolation].

== Fields

=== `hosts`

A list of target host addresses to connect to.


*Type*: `array`


```yml
# Examples

hosts: localhost:9000
```

=== `user`

A user ID to connect as.


*Type*: `string`

*Default*: `""`

=== `directory`

The directory to consume from.


*Type*: `string`