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

Document row level deletes for Iceberg #12061

Merged
merged 1 commit into from
Apr 27, 2022

Conversation

alexjo2144
Copy link
Member

Description

Documentation for #11886

Is this change a fix, improvement, new feature, refactoring, or other?

Documentation of a new feature

^^^^^^^^^^^^^^^^^^

Tables using v2 of the Iceberg specification support deletion of individual rows
using the ``merge-on-read`` mode. In order to use this feature the ``format_version``
Copy link
Member

Choose a reason for hiding this comment

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

merge-on-read in monospace looks like we support deletes only if deletion mode is merge-on-read, while we ignore it

let's not use the merge-on-read in a code block. Let's say we create deletion files.


Tables using v2 of the Iceberg specification support deletion of individual rows
using the ``merge-on-read`` mode. In order to use this feature the ``format_version``
table property must be set to ``2``.
Copy link
Member

Choose a reason for hiding this comment

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

  • for new Tables, from Trino perspective, user doesn't need to set format_version=2, because it's the default
  • for existing tables, referring to format_version may be confusing because we don't show it yet (Show Iceberg table version in SHOW CREATE TABLE #11980) and don't allow changing it (tbd)

let's just say the table must be in "v2" iceberg spec version

Currently, the Iceberg connector only supports deletion by partition.
This SQL below will fail because the ``WHERE`` clause selects only some of the rows
in the partition::
Both v1 and v2 tables will perform a partition delete if the ``WHERE`` clause
Copy link
Member

Choose a reason for hiding this comment

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

Is it clear that v1 and v2 refer to Iceberg spec versions?

@alexjo2144 alexjo2144 force-pushed the iceberg/delete-docs branch from 7441a4e to 23f580c Compare April 22, 2022 14:44
@alexjo2144
Copy link
Member Author

Updated, thanks

@findepi findepi merged commit 940b6d9 into trinodb:master Apr 27, 2022
@findepi findepi added the no-release-notes This pull request does not require release notes entry label Apr 27, 2022
@github-actions github-actions bot added this to the 379 milestone Apr 27, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cla-signed docs no-release-notes This pull request does not require release notes entry
Development

Successfully merging this pull request may close these issues.

2 participants