• Use File source connector to sync data to Pulsar


Pulsar IO



Enterprise Support

Apache community supported



File Source

The File source connector pulls messages from files in directories and persists the messages to Pulsar topics.


The configuration of the File source connector has the following properties.


Name Type Required Default Description
inputDirectory String true No default value The input directory to pull files.
recurse Boolean false true Whether to pull files from subdirectory or not.
keepFile Boolean false false If set to true, the file is not deleted after it is processed, which means the file can be picked up continually.
fileFilter String false [^\.].* The file whose name matches the given regular expression is picked up.
pathFilter String false NULL If recurse is set to true, the subdirectory whose path matches the given regular expression is scanned.
minimumFileAge Integer false 0 The minimum age that a file can be processed.

Any file younger than minimumFileAge (according to the last modification date) is ignored.
maximumFileAge Long false Long.MAX_VALUE The maximum age that a file can be processed.

Any file older than maximumFileAge (according to last modification date) is ignored.
minimumSize Integer false 1 The minimum size (in bytes) that a file can be processed.
maximumSize Double false Double.MAX_VALUE The maximum size (in bytes) that a file can be processed.
ignoreHiddenFiles Boolean false true Whether the hidden files should be ignored or not.
pollingInterval Long false 10000L Indicates how long to wait before performing a directory listing.
numWorkers Integer false 1 The number of worker threads that process files.

This allows you to process a larger number of files concurrently.

However, setting this to a value greater than 1 makes the data from multiple files mixed in the target topic.


Before using the File source connector, you need to create a configuration file through one of the following methods.

  • JSON

        "inputDirectory": "/Users/david",
        "recurse": true,
        "keepFile": true,
        "fileFilter": "[^\\.].*",
        "pathFilter": "*",
        "minimumFileAge": 0,
        "maximumFileAge": 9999999999,
        "minimumSize": 1,
        "maximumSize": 5000000,
        "ignoreHiddenFiles": true,
        "pollingInterval": 5000,
        "numWorkers": 1
  • YAML

        inputDirectory: "/Users/david"
        recurse: true
        keepFile: true
        fileFilter: "[^\\.].*"
        pathFilter: "*"
        minimumFileAge: 0
        maximumFileAge: 9999999999
        minimumSize: 1
        maximumSize: 5000000
        ignoreHiddenFiles: true
        pollingInterval: 5000
        numWorkers: 1


Here is an example of using the File source connecter.

  1. Pull a Pulsar image.

    $ docker pull apachepulsar/pulsar:{version}
  2. Start Pulsar standalone.

    $ docker run -d -it -p 6650:6650 -p 8080:8080 -v $PWD/data:/pulsar/data --name pulsar-standalone apachepulsar/pulsar:{version} bin/pulsar standalone
  3. Create a configuration file file-connector.yaml.

        inputDirectory: "/opt"
  4. Copy the configuration file file-connector.yaml to the container.

    $ docker cp connectors/file-connector.yaml pulsar-standalone:/pulsar/
  5. Download the File source connector.

    $ curl -O{version}/connectors/pulsar-io-file-{version}.nar
  6. Start the File source connector.

    $ docker exec -it pulsar-standalone /bin/bash
    $ ./bin/pulsar-admin sources localrun \
    --archive /pulsar/pulsar-io-file-{version}.nar \
    --name file-test \
    --destination-topic-name  pulsar-file-test \
    --source-config-file /pulsar/file-connector.yaml
  7. Start a consumer.

    ./bin/pulsar-client consume -s file-test -n 0 pulsar-file-test
  8. Write the message to the file test.txt.

    echo "hello world!" > /opt/test.txt

    The following information appears on the consumer terminal window.

    ----- got message -----
    hello world!