Skip to content

[delta][refactor-only] DeltaTableV2 Improvements - #5256

Merged
OussamaSaoudi merged 7 commits into
delta-io:masterfrom
philipzhux:dtv2-private
Oct 1, 2025
Merged

OussamaSaoudi merged 7 commits into
delta-io:masterfrom
philipzhux:dtv2-private

Conversation

@philipzhux

@philipzhux philipzhux commented Sep 25, 2025 •

Copy link
Copy Markdown
Contributor

Which Delta project/connector is this regarding?

  • Spark
  • Standalone
  • Flink
  • Kernel
  • Other (fill in here)

Description

  1. Correctly, the apply function is the only valid code path to construct a DeltaTableV2. To avoid undefined behaviors, we make the default ctor of the DeltaTableV2 private. The only usage of the default ctor elsewhere is to provide a custom clock into the delta log, which we now make a custom helper function to cover that purpose.
  2. A test-only change. In the vacuum suite, the delta log cache was cleared and delta log was accessed to make sure it was created with the manual testing clock. We want to move this before the construction of DeltaTableV2 to make sure it covers the delta log in DeltaTableV2.
  3. Minor redirect fix. Currently, the redirect code in DeltaTableV2.apply calls deltaTable.copy regardless of whether there is redirection or not. A small refactor is done to avoid the cost of copying when there is no redirections.

How was this patch tested?

Existing UTs.

Does this PR introduce any user-facing changes?

No

@philipzhux philipzhux changed the title move dtv2 private Make DeltaTableV2 Ctor Private Sep 25, 2025

def apply(spark: SparkSession, tableDir: File, clock: Clock): DeltaTableV2 = {
val tablePath = new Path(tableDir.getAbsolutePath)
new DeltaTableV2(spark, tablePath, catalogTable = None, None, None, Map.empty) {

@philipzhux philipzhux Sep 25, 2025 •

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Note to reviewers: Changes needed because we make DTv2 default ctor private.

@philipzhux philipzhux changed the title Make DeltaTableV2 Ctor Private [delta][refactor-only] DeltaTableV2 Improvements Sep 25, 2025
@OussamaSaoudi
OussamaSaoudi merged commit 6a0c210 into delta-io:master Oct 1, 2025
27 checks passed
huashi-st pushed a commit to huashi-st/delta that referenced this pull request Apr 24, 2026
<!--
Thanks for sending a pull request!  Here are some tips for you:
1. If this is your first time, please read our contributor guidelines:
https://github.com/delta-io/delta/blob/master/CONTRIBUTING.md
2. If the PR is unfinished, add '[WIP]' in your PR title, e.g., '[WIP]
Your PR title ...'.
  3. Be sure to keep the PR description updated to reflect all changes.
  4. Please write your PR title to summarize what this PR proposes.
5. If possible, provide a concise example to reproduce the issue for a
faster review.
6. If applicable, include the corresponding issue number in the PR title
and link it in the body.
-->

#### Which Delta project/connector is this regarding?
<!--
Please add the component selected below to the beginning of the pull
request title
For example: [Spark] Title of my pull request
-->

- [x] Spark
- [ ] Standalone
- [ ] Flink
- [ ] Kernel
- [ ] Other (fill in here)

## Description

<!--
- Describe what this PR changes.
- Describe why we need the change.
 
If this PR resolves an issue be sure to include "Resolves #XXX" to
correctly link and close the issue upon merge.
-->
1. Correctly, the apply function is the only valid code path to
construct a DeltaTableV2. To avoid undefined behaviors, we make the
default ctor of the DeltaTableV2 private. The only usage of the default
ctor elsewhere is to provide a custom clock into the delta log, which we
now make a custom helper function to cover that purpose.
2. A test-only change. In the vacuum suite, the delta log cache was
cleared and delta log was accessed to make sure it was created with the
manual testing clock. We want to move this before the construction of
DeltaTableV2 to make sure it covers the delta log in DeltaTableV2.
3. Minor redirect fix. Currently, the redirect code in
`DeltaTableV2.apply` calls `deltaTable.copy` regardless of whether there
is redirection or not. A small refactor is done to avoid the cost of
copying when there is no redirections.

## How was this patch tested?
Existing UTs.

<!--
If tests were added, say they were added here. Please make sure to test
the changes thoroughly including negative and positive cases if
possible.
If the changes were tested in any way other than unit tests, please
clarify how you tested step by step (ideally copy and paste-able, so
that other reviewers can test and check, and descendants can verify in
the future).
If the changes were not tested, please explain why.
-->

## Does this PR introduce _any_ user-facing changes?

<!--
If yes, please clarify the previous behavior and the change this PR
proposes - provide the console output, description and/or an example to
show the behavior difference if possible.
If possible, please also clarify if this is a user-facing change
compared to the released Delta Lake versions or within the unreleased
branches such as master.
If no, write 'No'.
-->
No

---------

Co-authored-by: Philip Zhu <philip.zhu@databricks.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants