Skip to Content
Puppi
Connectors

Filesystem

Parquet files under a local root directory.

@puppi/adapter-filesystem stores a table materialization as one Parquet file under a local directory. The binding’s config has one field, root, and no secret.

A storage ref <prefix>.<name> is the file <root>/<prefix>/<name>.parquet. A write replaces the whole file. A reader does not see a partial object, and two writes of one key leave one file. The directory for the prefix is created when the file is written.

import * as filesystem from "@puppi/adapter-filesystem";
import { defineConfig } from "@puppi/sdk";

export default defineConfig({
  connections: { lake: filesystem },
});
{
  "lake": {
    "config": { "root": "/var/puppi/lake" }
  }
}