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

OpenAPI: Add planning-mode to loadTable response #11156

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

rahil-c
Copy link
Contributor

@rahil-c rahil-c commented Sep 18, 2024

Recently in the iceberg community we landed a new set of scan planning apis within the rest spec #9695.

The following spec change in this pr aims to provide a way for client to know when to call the new scan planning apis. Within a rest catalog, services may choose to support scan planning for all tables or for a subset of tables. In this case we think it would be best to make the change in the loadTable response to indicate if scan planning is supported for the table.

cc @rdblue @danielcweeks @jackye1995 @amogh-jahagirdar

@@ -3138,6 +3149,8 @@ components:
description: May be null if the table is staged as part of a transaction
metadata:
$ref: '#/components/schemas/TableMetadata'
planning-mode:
$ref: '#/components/schemas/PlanningMode'
config:
type: object
Copy link
Contributor

Choose a reason for hiding this comment

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

Looks like from the sync meeting, we are saying the planning mode should be in config, something like:

config:
  type: object
  properties:
     planning-mode:
       $ref: '#/components/schemas/PlanningMode'
  additionalProperties:
    type: string

Is this the right understanding?

PlanningMode:
description: Indicates to clients if a service supports server-side planning for a given table.
type: string
enum: ["unsupported", "supported", "required"]
Copy link
Contributor

Choose a reason for hiding this comment

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

default unsupported?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants