Spool Dir

This Kafka Connect connector provides the capability to watch a directory for files and read the data as new files are written to the input directory. Each of the records in the input file will be converted based on the user supplied schema.

The CSVRecordProcessor supports reading CSV or TSV files. It can convert a CSV on the fly to the strongly typed Kafka Connect data types. It currently has support for all of the schema types and logical types that are supported in Kafka Connect. If you couple this with the Avro converter and Schema Registry by Confluent, you will be able to process CSV, Json, or TSV files to strongly typed Avro data in real time.


Running these connectors with multiple tasks requires a shared volume across all of the Kafka Connect workers. Kafka Connect does not have a mechanism for synchronization of tasks. Because of this each task will select which file it will use the following algorithm hash(<filename>) % totalTasks == taskNumber. If you are not using a shared volume this could cause issues where files are not processed. Using more than one task could also affect the order that the data is written to Kafka.


The preferred method of installation is to utilize the Confluent Hub Client.

Confluent Hub

The plugin is hosted on the Confluent Hub. Installation through the Confluent Hub Client is simple. Use the following command line.

confluent-hub install jcustenborder/kafka-connect-spooldir:latest

Manual Installation

  1. Compile the source code with mvn clean package
  2. Create a subdirectory called kafka-connect-spooldir under the plugin.path on your connect worker.
  3. Extract the contents of the zip file from target/components/packages/ to the directory you created in the previous step.
  4. Restart the connect worker.