diff --git a/docs/src/main/sphinx/object-storage.md b/docs/src/main/sphinx/object-storage.md index 390f59e87d7e..b48d914c76d3 100644 --- a/docs/src/main/sphinx/object-storage.md +++ b/docs/src/main/sphinx/object-storage.md @@ -59,6 +59,7 @@ compatible replacements: * [](/object-storage/file-system-azure) * [](/object-storage/file-system-gcs) * [](/object-storage/file-system-s3) +* [](/object-storage/file-system-local) * [](/object-storage/file-system-alluxio) The native support is available in all four connectors, and must be activated @@ -101,6 +102,7 @@ storage: /object-storage/file-system-azure /object-storage/file-system-gcs /object-storage/file-system-s3 +/object-storage/file-system-local /object-storage/file-system-hdfs /object-storage/file-system-cache /object-storage/file-system-alluxio diff --git a/docs/src/main/sphinx/object-storage/file-system-local.md b/docs/src/main/sphinx/object-storage/file-system-local.md new file mode 100644 index 000000000000..3ea2492925f7 --- /dev/null +++ b/docs/src/main/sphinx/object-storage/file-system-local.md @@ -0,0 +1,45 @@ +# Local file system support + +Trino includes support to access a local file system with a catalog using the +Delta Lake, Hive, Hudi, or Iceberg connectors. The local file system must be a +local mount point for a shared file system available on all cluster nodes. + +Support for local file system is not enabled by default, but can be activated by +setting the `fs.local.enabled` property to `true` in your catalog configuration +file. + +## General configuration + +Use the following properties to configure general aspects of local file system +support: + +:::{list-table} +:widths: 40, 60 +:header-rows: 1 + +* - Property + - Description +* - `fs.native-local.enabled` + - Activate the support for local file system access. Defaults to `false`. Set + to `true` to use local file system and enable all other properties. +* - `local.location` + - Local path on all nodes to the root of the shared file system using the prefix + `local://` with the path to the mount point. + +::: + +The following example displays the related section from a +`etc/catalog/example.properties` catalog configuration using the Hive connector. +The coordinator and all workers nodes have an external storage mounted at +`/storage/datalake`, resulting in the location `local:///storage/datalake`. + +```properties +connector.name=hive +... +fs.native-local.enabled=true +local.location=local:///storage/datalake +``` + +Creating a schema named `default` results in the path +`/storage/datalake/default`. Tables within that schema result in separated +directories such as `/storage/datalake/default/table1`.