Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 13 additions & 7 deletions docs/src/main/sphinx/admin/properties-client-protocol.md
Original file line number Diff line number Diff line change
Expand Up @@ -165,21 +165,28 @@ The object storage location to use for spooling segments. Must be accessible by
the coordinator and all workers. With the `protocol.spooling.retrieval-mode`
retrieval modes `STORAGE` and `COORDINATOR_STORAGE_REDIRECT` the location must
also be accessible by all clients. Valid location values vary by object storage
type, and typically follow a pattern of `scheme://bucketName/path/`.
type, and follow these patterns:

Examples:

* `s3://my-spooling-bucket/my-segments/`
* **S3:** `s3://my-spooling-bucket/my-segments/`
* **Azure Storage:** `abfss://[email protected]/my-segments/`
* **Google Cloud Storage:** `gs://my-spooling-bucket/my-segments/`

:::{note}
For Azure Storage, use the ABFS format with hierarchical namespace enabled.
The legacy WASB format (`wasbs://` or `wasb://`) is also supported but deprecated.
:::

:::{caution}
The specified object storage location must not be used for spooling for another
Trino cluster or any object storage catalog. When using the same object storage
for multiple services, you must use separate locations for each one. For
example:

* `s3://my-spooling-bucket/my-segments/cluster1-spooling`
* `s3://my-spooling-bucket/my-segments/cluster2-spooling`
* `s3://my-spooling-bucket/my-segments/iceberg-catalog`
* `s3://my-spooling-bucket/my-segments/cluster1-spooling/`
* `s3://my-spooling-bucket/my-segments/cluster2-spooling/`
* `s3://my-spooling-bucket/my-segments/iceberg-catalog/`
:::

### `fs.segment.ttl`
Expand Down Expand Up @@ -230,7 +237,7 @@ Interval to prune expired segments.

### `fs.segment.pruning.batch-size`

- **Type:** integer
- **Type:** [](prop-type-integer)
- **Default value:** `250`

Number of expired segments to prune as a single batch operation.
Expand Down Expand Up @@ -259,4 +266,3 @@ size limits.
Prepared statement compression is not applied if the size gain is less than the
configured value. Smaller statements do not benefit from compression, and are
left uncompressed.

10 changes: 5 additions & 5 deletions docs/src/main/sphinx/client/client-protocol.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,8 +81,8 @@ Azure Storage, and Google Cloud Storage. The object storage system must provide
good connectivity for all cluster nodes as well as any clients.

Activate the desired system with
`fs.s3.enabled`, `fs.azure.enabled`, or `fs.s3.enabled=true` in
`etc/spooling-manager.properties`and configure further details using relevant
`fs.s3.enabled`, `fs.azure.enabled`, or `fs.gcs.enabled` in
`etc/spooling-manager.properties` and configure further details using relevant
properties from [](prop-spooling-file-system),
[](/object-storage/file-system-s3), [](/object-storage/file-system-azure), and
[](/object-storage/file-system-gcs).
Expand Down Expand Up @@ -120,7 +120,7 @@ The following client drivers and client applications support the spooling protoc
* [Trino Python client](https://github.com/trinodb/trino-python-client), version
0.332.0 and newer

Refer to the documentation for other your specific client drivers and client
Refer to the documentation for your specific client drivers and client
applications for up to date information.

(protocol-direct)=
Expand All @@ -142,8 +142,8 @@ characteristics, compared to the spooling protocol:

### Configuration

Use of the direct protocol requires not configuration. Find optional
configuration properties in [](prop-protocol-shared).
Use of the direct protocol requires no configuration.
Find optional configuration properties in [](prop-protocol-shared).

## Development and reference information

Expand Down