You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iceberg.apache.org by si...@apache.org on 2026/03/13 16:24:22 UTC

(iceberg) branch main updated: Spec: Add scan-planning-mode to LoadTableResult config documentation (#14867)

This is an automated email from the ASF dual-hosted git repository.

singhpk234 pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iceberg.git


The following commit(s) were added to refs/heads/main by this push:
     new 6e64fb5ba4 Spec: Add scan-planning-mode to LoadTableResult config documentation (#14867)
6e64fb5ba4 is described below

commit 6e64fb5ba4ea18c55115358b0676308a42f93bd6
Author: Prashant Singh <35...@users.noreply.github.com>
AuthorDate: Fri Mar 13 09:24:15 2026 -0700

    Spec: Add scan-planning-mode to LoadTableResult config documentation (#14867)
    
    Co-authored-by: Prashant Singh <pr...@snowflake.com>
---
 open-api/rest-catalog-open-api.py   | 3 +++
 open-api/rest-catalog-open-api.yaml | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/open-api/rest-catalog-open-api.py b/open-api/rest-catalog-open-api.py
index 411881cb31..018aae73cf 100644
--- a/open-api/rest-catalog-open-api.py
+++ b/open-api/rest-catalog-open-api.py
@@ -1468,6 +1468,9 @@ class LoadTableResult(BaseModel):
     ## General Configurations
 
     - `token`: Authorization bearer token to use for table requests if OAuth2 security is enabled
+    - `scan-planning-mode`: Communicates to clients the supported planning mode. Clients should use this value to fail fast if the supported scanning mode is not available on the client. Valid values:
+      - `client`: Clients MUST use client-side scan planning
+      - `server`: Clients MUST use server-side scan planning via the `planTableScan` endpoint
 
     ## AWS Configurations
 
diff --git a/open-api/rest-catalog-open-api.yaml b/open-api/rest-catalog-open-api.yaml
index fff71128e5..ee00970425 100644
--- a/open-api/rest-catalog-open-api.yaml
+++ b/open-api/rest-catalog-open-api.yaml
@@ -3468,6 +3468,9 @@ components:
         ## General Configurations
 
         - `token`: Authorization bearer token to use for table requests if OAuth2 security is enabled
+        - `scan-planning-mode`: Communicates to clients the supported planning mode. Clients should use this value to fail fast if the supported scanning mode is not available on the client. Valid values:
+          - `client`: Clients MUST use client-side scan planning
+          - `server`: Clients MUST use server-side scan planning via the `planTableScan` endpoint
 
         ## AWS Configurations