Skip to content

spec: use dedicated response for DML operations#70

Merged
jackye1995 merged 2 commits into
lance-format:mainfrom
jackye1995:fix-apis
May 22, 2025
Merged

spec: use dedicated response for DML operations#70
jackye1995 merged 2 commits into
lance-format:mainfrom
jackye1995:fix-apis

Conversation

@jackye1995

@jackye1995 jackye1995 commented May 20, 2025

Copy link
Copy Markdown
Collaborator

Based on similar discussions going on in Iceberg, DML operations might return different response compared to the DQL operations, e.g. CreateNamespace could return a transaction ID indicating the current running transaction, instead of returning the created namespace. In order to prevent forward incompatible changes, we provide a response to every DML operations, instead of returning null or using the Get operation response.

@github-actions github-actions Bot added enhancement New feature or request python Python features java Java features spec Restful openapi spec rust Rust features labels May 20, 2025
Comment thread spec/rest.yaml
additionalProperties:
type: string

CreateNamespaceResponse:

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.

Instead of making Create return Get response, we now have a dedicated create response. This is inspired by recent discussions in IRC that Create might need to return a transaction handle and the response would be different from a Get. Similarly, Alter and Drop should also have dedicated responses.

Comment thread spec/rest.yaml
@jackye1995 jackye1995 requested a review from yanghua May 20, 2025 07:27
Comment thread spec/impl/hive.md Outdated
Comment thread spec/impl/rest.md Outdated
@jackye1995 jackye1995 changed the title spec: move impls to subfolder and fix various operations spec: use dedicated response for DML operations May 21, 2025
@jackye1995 jackye1995 requested a review from yanghua May 21, 2025 03:44
@yanghua

yanghua commented May 21, 2025

Copy link
Copy Markdown
Contributor

This PR needs to be rebased.

@jackye1995 jackye1995 merged commit 99d76f7 into lance-format:main May 22, 2025
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request java Java features python Python features rust Rust features spec Restful openapi spec

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants