Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

docs: fix stale and missing native write details in iceberg-writes.md and iceberg.md

Chiusa Adatta ai principianti
  • Qualcosa non va?
#6,147 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
75/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
rust, scala, spark
Ambito
documentation

Direzione di ricerca

L'issue punta a righe specifiche in docs/source/user-guide/latest/iceberg-writes.md e iceberg.md. Iniziate leggendo quei file per comprendere il testo attuale. Controllate le pull request referenziate (#5840, #6114) e la suite di test CometIcebergWriteActionSuite per il contesto su cosa deve essere aggiornato. Verificate il comportamento della configurazione spark.comet.exec.localTableScan.enabled. L'obiettivo è correggere le inesattezze elencate e aggiungere i dettagli mancanti.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

area:Iceberg area:writer documentation requires-triage
What is the problem the feature request solves?

The Iceberg user guide has errors and gaps about native writes:

  • docs/source/user-guide/latest/iceberg-writes.md:273-276 says float/double partition directories use Rust's shortest representation (f=1 where iceberg-java writes f=1.0). Since #5840 they use Java's Double.toString rules and match iceberg-java.
  • iceberg-writes.md:316-319 says the parity suite compares committed manifests byte-for-byte. CometIcebergWriteActionSuite compares aggregated readable_metrics (min/max, counts), not manifest bytes.
  • iceberg-writes.md does not say that writes whose input is a local relation, such as INSERT ... VALUES and df.writeTo(...).append() on a local DataFrame, need spark.comet.exec.localTableScan.enabled (default false). Without it they silently use iceberg-java even with both write flags on.
  • iceberg-writes.md does not list #6114 (dictionary page kept for high-cardinality columns) among the accepted divergences.
  • docs/source/user-guide/latest/iceberg.md:184 lists "Iceberg writes (reads are accelerated, writes use Spark)" as unsupported. Native writes exist behind spark.comet.iceberg.write.enabled; that page should point to iceberg-writes.md.
Describe the potential solution

Fix the four points above. The "experimental, disabled by default" wording will need another pass when the defaults change (#5644).

Additional context

Found in an audit of the native Iceberg write path before enabling it by default. Part of #5649.

Lingua principale
Scala
Stelle
1.3k
Fork
387
Merge medio
2g 4h
PR unite (30g)
404

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di apache/datafusion-comet

Tutte le issue di apache/datafusion-comet

Issue simili

Altre issue su Scala

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.