apache / apache/iceberg

Docs: Delta Lake migration Output table names a result that does not exist

Open Beginner friendly
#17,266 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Java
Stars
9.2k
Forks
3.5k
Avg merge
2d 16h
Merged PRs (30d)
129

Description

**Apache Iceberg version**

main @ 5f3d3c560

**Query engine**

None — the affected action is the engine-agnostic `delta-lake` Java API.

**Please describe the bug**

The Output table in `docs/docs/delta-lake-migration.md` (line 87) documents the result of the `snapshotDeltaLakeTable` action as `imported_files_count`. No such name exists in the `delta-lake` module.

`SnapshotDeltaLakeTable.Result` (`delta-lake/src/main/java/org/apache/iceberg/delta/SnapshotDeltaLakeTable.java` lines 85-91) declares exactly one method: `long snapshotDataFilesCount()`.

`imported_files_count` is the output column of the Spark `snapshot` SQL procedure, defined in `SnapshotTableProcedure`. The delta row is character-identical to `docs/docs/spark-procedures.md` line 618, so it was copied from the Spark page. It has never matched the delta-lake API — the module's original commit already declared `snapshotDataFilesCount()` only.

**Steps to reproduce**

1. Read the Output table on the Delta Lake migration page.
2. Run the Examples snippet on the same page and call the documented name on the returned `Result`.

Expected: the documented name resolves. Actual: only `snapshotDataFilesCount()` exists, so no such member can be found.

**Additional context**

The page documents the Java API only — it contains no SQL procedure call, and the Usage table lists Java configuration methods. Fix is one line: rename the output to `snapshotDataFilesCount`. The `Type` column (`long`) already matches the declaration.

Contributor guide

Open the contributing guide

Research direction

Open docs/docs/delta-lake-migration.md around line 87 and compare its Output table with delta-lake/src/main/java/org/apache/iceberg/delta/SnapshotDeltaLakeTable.java around lines 85-91. Confirm the page documents the engine-agnostic Java API, then check the documentation validation workflow. Done means the documented result name matches SnapshotDeltaLakeTable.Result.snapshotDataFilesCount() and the existing type remains long.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
92/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.