-
Notifications
You must be signed in to change notification settings - Fork 1.7k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add Default Row Commit Version to AddFile and RemoveFile #1781
Add Default Row Commit Version to AddFile and RemoveFile #1781
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks like a good start on the feature. Just a couple nits.
It does not handle any transaction conflicts yet.
This is merely TODO, right?
@@ -278,8 +278,11 @@ abstract class CloneTableBase( | |||
val copiedFile = fileToCopy.copy(dataChange = true) | |||
opName match { | |||
case CloneTableCommand.OP_NAME => | |||
// CLONE does not preserve Row IDs and Commit Versions |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
why not?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It is explained in the design document. The fundamental problem is that there is no way to remove a file and add it back with a different baseRowId
in the same commit. This causes issues with incremental clones.
val filters: Seq[Expression] = Seq(col("id = 150").expr) | ||
val scan: DeltaScan = deltaLog.update().filesForScan(filters) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is there some reason these val
(and only these) need explicit types?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There's no reason. I think I temporarily added them when I was fighting with IntellIJ not being able to infer the right type. I will remove it.
@@ -1710,6 +1715,8 @@ trait OptimisticTransactionImpl extends TransactionalWrite | |||
conflictChecker.checkConflicts() | |||
} | |||
|
|||
protected def getFirstAttemptVersion: Long = readVersion + 1L |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is the first attempted commit version?
(not sure if name change or just doc comment is better)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The name was chosen to match getNextAttemptVersion
. I will add a doc comment to make it clearer what it is.
<!-- 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 Delta Protocol for Row IDs was introduced in this PR: #1610 Support for writing fresh row IDs / row commit versions was introduced in the following PRs: - #1723 - #1781 - #1896 **This is sufficient to enable row tracking on a table and write to a table that has row tracking enabled** but not to actually read row IDs / row commit versions back, which is also being added in Delta at the moment ([read BaseRowId](283ac02). [read defaultRowCommitVersion](#2795), [read RowId](#2856)...) Using row tracking is currently only allowed in testing, this change allows enabling row tracking outside of testing so that the upcoming Delta 3.2 release includes support for writing to tables with row tracking enabled, making Delta writers future-proof. <!-- - 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. --> ## How was this patch tested? Tests have already been added in previous changes, this only flips the switch to let users enabled Row Tracking outside of tests. <!-- 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? Users are now able to enable Row Tracking when creating a delta table: ``` CREATE TABLE tbl(a int) USING DELTA TBLPROPERTIES ('delta.enableRowTracking' = 'true') ``` <!-- 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'. -->
<!-- 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 Delta Protocol for Row IDs was introduced in this PR: delta-io#1610 Support for writing fresh row IDs / row commit versions was introduced in the following PRs: - delta-io#1723 - delta-io#1781 - delta-io#1896 **This is sufficient to enable row tracking on a table and write to a table that has row tracking enabled** but not to actually read row IDs / row commit versions back, which is also being added in Delta at the moment ([read BaseRowId](delta-io@283ac02). [read defaultRowCommitVersion](delta-io#2795), [read RowId](delta-io#2856)...) Using row tracking is currently only allowed in testing, this change allows enabling row tracking outside of testing so that the upcoming Delta 3.2 release includes support for writing to tables with row tracking enabled, making Delta writers future-proof. <!-- - 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. --> ## How was this patch tested? Tests have already been added in previous changes, this only flips the switch to let users enabled Row Tracking outside of tests. <!-- 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? Users are now able to enable Row Tracking when creating a delta table: ``` CREATE TABLE tbl(a int) USING DELTA TBLPROPERTIES ('delta.enableRowTracking' = 'true') ``` <!-- 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'. -->
Description
This PR implements part of the changes proposed in #1747. It adds the
defaultRowCommitVersion
field toAddFile
andRemoveFile
, and it makes sure that it's populated during commits and read during log replay. It does not handle any transaction conflicts yet.How was this patch tested?
Added a new test suite
DefaultRowCommitVersionSuite
.Does this PR introduce any user-facing changes?
No