(iceberg) branch main updated: Update documentation on Spark migrate procedure (#15874)

[hu...@apache.org]

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

huaxingao 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 9586899fab Update documentation on Spark migrate procedure (#15874)
9586899fab is described below

commit 9586899fab3cc15fc0d0a5c9060b98ff632974e6
Author: Wing Yew Poon <wy...@cloudera.com>
AuthorDate: Fri Apr 10 13:45:54 2026 -0700

    Update documentation on Spark migrate procedure (#15874)
    
    ... in light of https://github.com/apache/iceberg/pull/15429.
---
 docs/docs/spark-procedures.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/docs/spark-procedures.md b/docs/docs/spark-procedures.md
index 45e55a9365..8e594caa12 100644
--- a/docs/docs/spark-procedures.md
+++ b/docs/docs/spark-procedures.md
@@ -637,6 +637,7 @@ Replace a table with an Iceberg table, loaded with the source's data files.
 Table schema, partitioning, properties, and location will be copied from the source table.
 
 Migrate will fail if any table partition uses an unsupported format. Supported formats are Avro, Parquet, and ORC.
+Migrate will also fail if the table is bucketed, as the bucketing will not be preserved.
 Existing data files are added to the Iceberg table's metadata and can be read using a name-to-id mapping created from the original table schema.
 
 To leave the original table intact while testing, use [`snapshot`](#snapshot) to create new temporary table that shares source data files and schema.