nchammas commented on code in PR #57452: URL: https://github.com/apache/spark/pull/57452#discussion_r3804530542
########## python/README.md: ########## @@ -1,33 +1,36 @@ # Apache Spark Spark is a unified analytics engine for large-scale data processing. It provides -high-level APIs in Scala, Java, Python, and R, and an optimized engine that +high-level APIs in Scala, Java, Python, and R (deprecated), and an optimized engine that supports general computation graphs for data analysis. It also supports a rich set of higher-level tools including Spark SQL for SQL and DataFrames, pandas API on Spark for pandas workloads, MLlib for machine learning, GraphX for graph processing, and Structured Streaming for stream processing. -<https://spark.apache.org/> +PySpark is the Python distribution of Spark. -## Online Documentation +Project home page: https://spark.apache.org/ -You can find the latest Spark documentation, including a programming -guide, on the [project web page](https://spark.apache.org/documentation.html) +Main documentation: https://spark.apache.org/docs/latest/ +PySpark documentation: https://spark.apache.org/docs/latest/api/python/index.html -## Python Packaging +## PySpark on PyPI -This README file only contains basic information related to pip installed PySpark. -This packaging is currently experimental and may change in future versions (although we will do our best to keep compatibility). -Using PySpark requires the Spark JARs, and if you are building this from source please see the builder instructions at -["Building Spark"](https://spark.apache.org/docs/latest/building-spark.html). +There are a few PySpark packages published by the Apache Spark project to PyPI: -The Python packaging for Spark is not intended to replace all of the other use cases. This Python packaged version of Spark is suitable for interacting with an existing cluster (be it Spark standalone, YARN) - but does not contain the tools required to set up your own standalone Spark cluster. You can download the full version of Spark from the [Apache Spark downloads page](https://spark.apache.org/downloads.html). +- `pyspark`: Classic PySpark, includes Spark assembly JARs +- `pyspark-connect`: Classic PySpark with Spark Connect configured as the default, includes `pyspark` +- `pyspark-client`: Pure Python Spark Connect client, no JARs or JRE needed +For more information, see the [installation guide][install]. If you're building PySpark from source, see [Building Spark][build] and [pyproject.toml][py]. -**NOTE:** If you are using this with a Spark standalone cluster you must ensure that the version (including minor version) matches or you may experience odd errors. +[install]: https://spark.apache.org/docs/latest/api/python/getting_started/install.html +[build]: https://spark.apache.org/docs/latest/building-spark.html +[py]: https://github.com/apache/spark/blob/master/pyproject.toml -## Python Requirements +## Python vs. "Full" Distribution of Spark Review Comment: @zhengruifeng - Does this explanation resolve your concern? -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
