Skip to content
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

[BUG] Default columns is also a reader feature, the PROTOCOL doc is wrong. #2790

Closed
wants to merge 1 commit into from

Conversation

mwc360
Copy link
Contributor

@mwc360 mwc360 commented Mar 22, 2024

The docs here correctly state that enabling Default Columns will prevent older versions without the Default Column feature from reading the table: https://docs.delta.io/3.1.0/delta-default-columns.html
The PROTOCOL doc conflicts with the above. I tested and confirmed that Default Columns is a table feature that requires the reader to support.

Signed-off-by: Miles Cole m.w.c.360@gmail.com

Which Delta project/connector is this regarding?

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

Description

Documentation needs updating

How was this patch tested?

Just documentation

Does this PR introduce any user-facing changes?

No

The docs here state that enabling Default Columns will prevent older versions without the Default Column feature from reading the table: https://docs.delta.io/3.1.0/delta-default-columns.html
@felipepessoto
Copy link
Contributor

Previously the decision was to make it a write only feature. That changed? Or docs are incorrect?

#2240 (comment)

@mwc360
Copy link
Contributor Author

mwc360 commented Mar 24, 2024

Previously the decision was to make it a write only feature. That changed? Or docs are incorrect?

#2240 (comment)

You're right, something with my testing was wrong. It does not block reader access for older delta versions,

The documentation here incorrectly notes that "Enabling default column values for a table upgrades the Delta table version as a byproduct of enabling table features. This protocol upgrade is irreversible. Tables with default column values enabled can only be read in Delta Lake 3.1 and above."

@mwc360
Copy link
Contributor Author

mwc360 commented Mar 24, 2024

I'll cancel this PR and open one up for the doc that should be fixed. thanks!

@mwc360 mwc360 closed this Mar 24, 2024
@mwc360
Copy link
Contributor Author

mwc360 commented Mar 24, 2024

New PR opened here: #2794

@mwc360 mwc360 deleted the patch-1 branch March 24, 2024 18:03
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.

2 participants