Skip to content

[MINOR][PYTHON][DOCS] Clarify PySpark installation options#56822

Open
Israelobuk wants to merge 1 commit into
apache:masterfrom
Israelobuk:clarify-pyspark-install-options
Open

[MINOR][PYTHON][DOCS] Clarify PySpark installation options#56822
Israelobuk wants to merge 1 commit into
apache:masterfrom
Israelobuk:clarify-pyspark-install-options

Conversation

@Israelobuk

Copy link
Copy Markdown

What changes were proposed in this pull request?

This PR adds a short note to the PySpark installation documentation clarifying the difference between pyspark, pyspark[connect], pyspark-connect, and pyspark-client.

Why are the changes needed?

The installation page documents these package options in separate sections, but users may not immediately understand which package to choose. This note gives a concise summary of the intended use case for each option.

Does this PR introduce any user-facing change?

No. This is a documentation-only change and does not change runtime behavior.

How was this patch tested?

Ran:

git diff --check

Was this patch authored or co-authored using generative AI tooling?

No

Comment on lines +86 to +92
.. note::

Use ``pyspark`` or ``pyspark[connect]`` for a full PySpark installation.
Use ``pyspark-connect`` when you want Spark Connect to be the default mode.
Use ``pyspark-client`` when you only need the pure Python Spark Connect client
for connecting to a remote Spark server.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for this note as clarification.

nit: do you think move this after Python Spark Connect Client section, which is line 116, is more clear?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Honestly, I agree with that.

@uros-b uros-b left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @Israelobuk and @Yicong-Huang!

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.

3 participants