Skip to content

docs: fix and improve the description about row id#5463

Merged
wjones127 merged 7 commits intolance-format:mainfrom
yanghua:docs-row-id
Dec 15, 2025
Merged

docs: fix and improve the description about row id#5463
wjones127 merged 7 commits intolance-format:mainfrom
yanghua:docs-row-id

Conversation

@yanghua
Copy link
Copy Markdown
Collaborator

@yanghua yanghua commented Dec 12, 2025

There are some misunderstood for users about the row ID in the doc. See: #4935 (comment)

This PR tries to correct and improve it.

@chatgpt-codex-connector
Copy link
Copy Markdown

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Dec 12, 2025
Copy link
Copy Markdown
Contributor

@wjones127 wjones127 left a comment

Choose a reason for hiding this comment

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

Thanks for working on this. Have a few minor comments.

Comment thread docs/src/format/table/row_id_lineage.md Outdated
Comment thread docs/src/format/table/row_id_lineage.md Outdated
Comment thread docs/src/format/table/row_id_lineage.md Outdated
Comment thread docs/src/format/table/row_id_lineage.md Outdated
Comment thread docs/src/format/table/row_id_lineage.md Outdated
Comment thread docs/src/format/table/row_id_lineage.md Outdated
@wjones127 wjones127 changed the title docs: fix and improve the describtion about row id docs: fix and improve the description about row id Dec 12, 2025
@wjones127 wjones127 self-assigned this Dec 12, 2025
yanghua and others added 5 commits December 13, 2025 15:53
Co-authored-by: Will Jones <willjones127@gmail.com>
Co-authored-by: Will Jones <willjones127@gmail.com>
Co-authored-by: Will Jones <willjones127@gmail.com>
Co-authored-by: Will Jones <willjones127@gmail.com>
@yanghua
Copy link
Copy Markdown
Collaborator Author

yanghua commented Dec 13, 2025

@wjones127, I have addressed the comments. Please take a look.


Each row tracks the version at which it was last modified.
When a row is created, `last_updated_at_version` equals `created_at_version`.
When a row is updated, a new row is created with both `created_at_version` and `last_updated_at_version` set to the current version, and the old row is marked deleted.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Seems like the old row only marked deleted, not modify the last_updated_at_version?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

yes, if we enable the stable row ID feature, when updating, the old row is only marked deleted, and the last_updated_at_version will be tracked in the new fragment for the same row id.

@wjones127 wjones127 merged commit 30d2e02 into lance-format:main Dec 15, 2025
4 checks passed
jackye1995 pushed a commit to jackye1995/lance that referenced this pull request Jan 21, 2026
There are some misunderstood for users about the `row ID` in the doc.
See:
lance-format#4935 (comment)

This PR tries to correct and improve it.

---------

Co-authored-by: Will Jones <willjones127@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants