Skip to content

docs/pyspark4.x: fix spark-submit GCS config for Spark 4.2#186

Merged
iobruno merged 2 commits into
masterfrom
fix/spark-submit-4.2
Jul 19, 2026
Merged

docs/pyspark4.x: fix spark-submit GCS config for Spark 4.2#186
iobruno merged 2 commits into
masterfrom
fix/spark-submit-4.2

Conversation

@iobruno

@iobruno iobruno commented Jul 19, 2026

Copy link
Copy Markdown
Owner

Summary

  • Document the fs.gs.block.size fix needed when running spark-submit against the Spark 4.2 standalone cluster: Hadoop 3.5.0's core-default.xml defaults fs.gs.block.size=64m, which gcs-connector <=4.0.4/3.1.18 fails to parse via Configuration.getLong(), causing a NumberFormatException on any gs:// read. Add the --conf spark.hadoop.fs.gs.block.size=67108864 workaround to the recommended command, with a note pointing to the upstream fix (GoogleCloudDataproc/hadoop-connectors@2dd981a, PR #1731) that hasn't shipped in a release yet.

  • Add Spark 4.2.x / Hadoop 3.5.0 rows to the GCS compatibility matrix, which previously only documented Spark 4.0.x / Hadoop 3.4.1.

Test plan

  • Reproduced the NumberFormatException with the documented spark-submit command against the Spark 4.2 standalone cluster.
  • Confirmed spark-submit with --conf spark.hadoop.fs.gs.block.size=67108864 added resolves the error and the job completes.
  • Verified Hadoop version bundled in the Spark 4.2 image (hadoop-client-api-3.5.0.jar) via docker exec.

🤖 Generated with Claude Code

iobruno and others added 2 commits July 18, 2026 21:19
…park 4.2

Hadoop 3.5.0's core-default.xml sets fs.gs.block.size=64m, which gcs-connector
<=4.0.4/3.1.18 fails to parse via Configuration.getLong(), causing a
NumberFormatException on any gs:// read. Document the --conf workaround and
the upstream fix (GoogleCloudDataproc/hadoop-connectors@2dd981a, PR #1731).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…ty matrix

Spark 4.2's Docker image bundles Hadoop 3.5.0 (hadoop-client-api-3.5.0.jar),
not the 3.4.1 already documented for Spark 4.0.x. Add matrix rows for it and
flag the fs.gs.block.size issue affecting both gcs-connector 4.0.x and 3.1.x
on that combo.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@iobruno
iobruno merged commit b4df0cb into master Jul 19, 2026
1 check passed
@iobruno
iobruno deleted the fix/spark-submit-4.2 branch July 19, 2026 00:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant