Skip to content

Conversation

@danielbelchior
Copy link
Contributor

@danielbelchior danielbelchior commented Jul 22, 2025

Description

This PR renames the configuration property s3.socket-read-timeout to
s3.socket-timeout in the S3 filesystem connector. The previous property
name was misleading, as it actually sets the underlying HTTP client's
socketTimeout, which controls both read and write timeouts. The new
property name, s3.socket-timeout, more accurately reflects its behavior
and improves clarity for users configuring S3 timeouts.

Additional context and related issues

The change updates the property name in both the code and documentation to
ensure consistency and avoid confusion. No functional behavior is changed;
the timeout continues to apply to both read and write operations at the
HTTP client level. This update aligns the property name with its actual
semantics and helps prevent misconfiguration by users.

Release notes

## Delta Lake connector
* Rename `s3.socket-read-timeout` config property to `s3.socket-timeout` to make it more clear that the timeout applies equally to socket read and write operations. ({issue}`26263`)

## Hudi connector
* Rename `s3.socket-read-timeout` config property to `s3.socket-timeout` to make it more clear that the timeout applies equally to socket read and write operations. ({issue}`26263`)

## Hive connector
* Rename `s3.socket-read-timeout` config property to `s3.socket-timeout` to make it more clear that the timeout applies equally to socket read and write operations. ({issue}`26263`)

## Iceberg connector
* Rename `s3.socket-read-timeout` config property to `s3.socket-timeout` to make it more clear that the timeout applies equally to socket read and write operations. ({issue}`26263`)

Closes: #26088

@cla-bot
Copy link

cla-bot bot commented Jul 22, 2025

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

@github-actions github-actions bot added the docs label Jul 22, 2025
@wendigo
Copy link
Contributor

wendigo commented Jul 22, 2025

We don't do breaking changes like that. We use @LegacyConfig to redirect previous config property to a new one.

@danielbelchior danielbelchior force-pushed the feature-s3-connector-write-timeout-parameter branch from ec38f88 to d815533 Compare July 22, 2025 18:36
@cla-bot
Copy link

cla-bot bot commented Jul 22, 2025

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

@ebyhr ebyhr force-pushed the feature-s3-connector-write-timeout-parameter branch from d815533 to a513434 Compare July 22, 2025 20:54
@cla-bot
Copy link

cla-bot bot commented Jul 22, 2025

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

@danielbelchior
Copy link
Contributor Author

Hi @ebyhr can you please help me with the CLA approval? I have 5 other PR waiting for this approval.

@pettyjamesm
Copy link
Member

Hi @ebyhr can you please help me with the CLA approval? I have 5 other PR waiting for this approval.

cc: @martint - CLA approval request

@ebyhr
Copy link
Member

ebyhr commented Jul 22, 2025

/test-with-secrets sha=a513434853670d70af73ed913ea732839253af57

@github-actions
Copy link

github-actions bot commented Jul 22, 2025

The CI workflow run with tests that require additional secrets finished as failure: https://github.com/trinodb/trino/actions/runs/16456523843

The property `s3.socket-read-timeout` was misleading, as it sets the
underlying HTTP client's `socketTimeout`, which controls both read and
write timeouts. To avoid confusion and better reflect its actual behavior,
the property has been renamed to `s3.socket-timeout`.

This change improves clarity for users configuring timeouts in the S3
filesystem and aligns the property name with its actual semantics.
@danielbelchior danielbelchior force-pushed the feature-s3-connector-write-timeout-parameter branch from a513434 to 6d8d461 Compare July 25, 2025 13:04
@cla-bot
Copy link

cla-bot bot commented Jul 25, 2025

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

@martint
Copy link
Member

martint commented Jul 25, 2025

@cla-bot check

@cla-bot
Copy link

cla-bot bot commented Jul 25, 2025

The cla-bot has been summoned, and re-checked this pull request!

@cla-bot cla-bot bot added the cla-signed label Jul 25, 2025
Copy link
Member

@pettyjamesm pettyjamesm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved, thanks @danielbelchior!

@pettyjamesm pettyjamesm merged commit b4a7176 into trinodb:master Jul 25, 2025
67 checks passed
@github-actions github-actions bot added this to the 477 milestone Jul 25, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

s3 connector write timeout parameter?

6 participants