Skip to content

docs: 34.0.0 release notes#18231

Merged
capistrant merged 17 commits intoapache:34.0.0from
317brian:34-release-notes
Aug 11, 2025
Merged

docs: 34.0.0 release notes#18231
capistrant merged 17 commits intoapache:34.0.0from
317brian:34-release-notes

Conversation

@317brian
Copy link
Copy Markdown
Contributor

WIP. This is caught up to late June. I am working on getting the most recent commits added.

Need to work on the highlights entry for Dart

This PR has:

  • been self-reviewed.
  • added documentation for new or modified features or behaviors.
  • a release note entry in the PR description.
  • added Javadocs for most classes and all non-trivial methods. Linked related entities via Javadoc links.
  • added or updated version, license, or notice information in licenses.yaml
  • added comments explaining the "why" and the intent of the code wherever would not be obvious for an unfamiliar reader.
  • added unit tests or modified existing tests to cover new code paths, ensuring the threshold for code coverage is met.
  • added integration tests.
  • been tested in a test Druid cluster.

@317brian 317brian marked this pull request as draft July 10, 2025 19:06
@317brian 317brian added this to the 34.0.0 milestone Jul 14, 2025
Comment thread docs/release-info/release-notes.md Outdated
Dart specific endpoints have been removed and folded into SqlResource. [#18003](https://github.com/apache/druid/pull/18003)
Added a new engine QueryContext parameter. The value can be native or msq-dart. The value determines the engine used to run the query. The default value is native. [#18003](https://github.com/apache/druid/pull/18003)

MSQ Dart is now able to query real-time tasks by setting the query context parameter includeSegmentSource to realtime, in a similar way to MSQ tasks. [#18076](https://github.com/apache/druid/pull/18076)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

We can also specify that this is the default mode for Dart queries. I might have missed this in the PR initially.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Lets add an example where we hit the sql resource with engine=msq-dart

Comment thread docs/release-info/release-notes.md Outdated
Copy link
Copy Markdown
Contributor

@kfaraz kfaraz left a comment

Choose a reason for hiding this comment

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

left some suggestions

Comment thread docs/release-info/release-notes.md Outdated
Comment thread docs/release-info/release-notes.md Outdated
Comment thread docs/release-info/release-notes.md Outdated
Comment thread docs/release-info/release-notes.md Outdated
Comment thread docs/release-info/release-notes.md Outdated
Comment thread docs/release-info/release-notes.md Outdated
Comment thread docs/release-info/release-notes.md Outdated
Comment thread docs/release-info/release-notes.md
Comment thread docs/release-info/release-notes.md Outdated
[#18028](https://github.com/apache/druid/pull/18028)

### Preferred tier selection
You can now configure the Broker service to prefer Historicals on a specific tier. This can help ensure Druid executes queries within the same availability zone if you have Druid deployed across multiple availability zones.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Waiting on PR author for release notes : #18136 (comment)

Comment thread docs/release-info/release-notes.md Outdated
Dart specific endpoints have been removed and folded into SqlResource. [#18003](https://github.com/apache/druid/pull/18003)
Added a new engine QueryContext parameter. The value can be native or msq-dart. The value determines the engine used to run the query. The default value is native. [#18003](https://github.com/apache/druid/pull/18003)

MSQ Dart is now able to query real-time tasks by setting the query context parameter includeSegmentSource to realtime, in a similar way to MSQ tasks. [#18076](https://github.com/apache/druid/pull/18076)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Lets add an example where we hit the sql resource with engine=msq-dart

Comment thread docs/release-info/release-notes.md Outdated

#### SET statements

The web console supports using SET statements to specify query context parameters. For example, if you include `SET timeout = 20000;` in your query, the timeout query context parameter is set.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This should be a headline feature.
Lets add an example which hits the sql endpoint, executes dart, and has timeout set.

Copy link
Copy Markdown
Contributor Author

@317brian 317brian Jul 21, 2025

Choose a reason for hiding this comment

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

I can move this to the headline section. This entry is specifically about the web console support for SET though.

I added an example that hits the SQL endpoint, uses dart etc to the API one

317brian and others added 3 commits July 21, 2025 15:45
Co-authored-by: Karan Kumar <karankumar1100@gmail.com>
Co-authored-by: Kashif Faraz <kashif.faraz@gmail.com>
Comment thread docs/release-info/release-notes.md Outdated
Comment thread docs/release-info/release-notes.md Outdated
Comment on lines +154 to +155
- `druid.manager.segments.killUnused.enabled` - Whether the feature is enabled or not
- `druid.manager.segments.killUnused.bufferPeriod` - The amount of time that a segment must be unused before it is able to be permanently removed from metadata and deep storage. This can serve as a buffer period to prevent data loss if data ends up being needed after being marked unused.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Do you think it's worth mentioning what the defaults for these configs are? (false and P30D)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

+1

Comment thread docs/release-info/release-notes.md Outdated
Comment thread docs/release-info/release-notes.md Outdated
Comment thread docs/release-info/release-notes.md
317brian and others added 2 commits July 22, 2025 10:07
Co-authored-by: Abhishek Radhakrishnan <abhishek.rb19@gmail.com>
Comment thread docs/release-info/release-notes.md Outdated
@317brian 317brian marked this pull request as ready for review July 29, 2025 19:22
@317brian 317brian requested review from capistrant and cryptoe August 4, 2025 17:50
Comment thread docs/release-info/release-notes.md
Comment thread docs/release-info/release-notes.md
Copy link
Copy Markdown
Contributor

@capistrant capistrant left a comment

Choose a reason for hiding this comment

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

added color to one new feature

Comment thread docs/release-info/release-notes.md Outdated
Copy link
Copy Markdown
Contributor

@capistrant capistrant left a comment

Choose a reason for hiding this comment

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

I know D32 technically deprecated java11 and hadoop ingest. but do we want to drive them home with big bold sections for deprecations in D34 to really drive this point home these things are going away sooner rather than later?

@capistrant
Copy link
Copy Markdown
Contributor

I know D32 technically deprecated java11 and hadoop ingest. but do we want to drive them home with big bold sections for deprecations in D34 to really drive this point home these things are going away sooner rather than later?

Talked with @abhishekagarwal87 and he thought maybe we call out in these release notes that hadoop ingest/java11 remain deprecated and are planning to have support dropped in Druid 35 with an urge for community to migrate off

Co-authored-by: Lucas Capistrant <capistrant@users.noreply.github.com>
Comment thread docs/release-info/release-notes.md Outdated
Copy link
Copy Markdown
Contributor

@capistrant capistrant left a comment

Choose a reason for hiding this comment

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

I'm cool with latest state. Thank you for all the iterations and review cycles!

Comment thread docs/release-info/release-notes.md Outdated
@capistrant capistrant merged commit 0d51afd into apache:34.0.0 Aug 11, 2025
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants