Skip to content

Conversation

@yanghua
Copy link
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

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
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.

@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
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.

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
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
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