apache/iceberg

Docs: Clarify Spark branch write precedence over WAP branch

オープン

#15,916 opened on 2026/04/09

 (5 件のコメント) (0 件のリアクション) (0 人の担当者)Java (1,915 件のフォーク)batch import
docsgood first issueimprovement

Repository metrics

Stars
 (5,146 個のスター)
PR merge metrics
 (PR metrics pending)

説明

Feature Request / Improvement

After https://github.com/apache/iceberg/pull/15288, Spark Writing to Branches doc (docs/docs/spark-writes.md) no longer matches that in codes.

   * <p>The target branch can be specified via table identifier, write option, or in SQL:
   *
   * <ul>
   *   <li>The identifier and option branches can't conflict. If both are set, they must match.
   *   <li>Identifier and option branches take priority over the session WAP branch.
   *   <li>If neither the option nor the identifier branch is set and WAP is enabled for this table,
   *       use the WAP branch from the session SQL config.
   * </ul>
   *
   * <p>Note: WAP ID and WAP branch cannot be set at the same time.
   *
   * <p>Note: The target branch may be created during the write operation if it does not exist.

Query engine

Spark

Willingness to contribute

  • I can contribute this improvement/feature independently
  • I would be willing to contribute this improvement/feature with guidance from the Iceberg community
  • I cannot contribute this improvement/feature at this time

コントリビューターガイド