BucketFS overview
Learn about the BucketFS filesystem in Exasol.
What is BucketFS?
BucketFS is a synchronous file system that is available on all database nodes in an Exasol cluster. Each node in the cluster can connect to the BucketFS service and will see the same content as the other nodes.
A BucketFS service stores files in buckets.
During installation, Exasol creates a BucketFS service named bfsdefault
with a bucket named default
. You can create additional BucketFS services and buckets as needed after the installation. Each bucket can have different access privileges.
In on-premises installations of Exasol 2025.1 and later you can use Exasol Admin to manage buckets and files in BucketFS. In other versions of Exasol you can use an HTTP client or a command-line file transfer tool such as curl to upload and manage files in the buckets.
Exasol also provides BucketFS Client, a Java-based tool for Windows and Linux that allows you to create new buckets and bucket services in addition to uploading and managing files. To learn more, see the BucketFS Client User Guide on GitHub.
In Exasol SaaS you cannot access BucketFS directly, you need to use the File manager in the web console to upload and manage files. To learn more, see File management (SaaS).
Usage notes
-
The data in BucketFS is replicated locally on every node and automatically synchronized. To avoid performance issues, do not store very large amounts of data in BucketFS.
-
BucketFS is a pure file-based system and has no transactional semantic. There is no lock on files, so the latest write operation will overwrite the file.
-
Writing data to BucketFS is an atomic operation, meaning that it either completes entirely or not at all.
-
Data in BucketFS is not part of the database backups and must be manually backed up by downloading the files.
-
The default BucketFS service has HTTPS activated on port 2581 and HTTP deactivated by default. To change the ports, use the ConfD job bucketfs_modify.
