Github user yhuai commented on a diff in the pull request:
https://github.com/apache/spark/pull/13592#discussion_r67773057
--- Diff: docs/sql-programming-guide.md ---
@@ -12,130 +12,130 @@ title: Spark SQL and DataFrames
Spark SQL is a Spark module for structured data processing. Unlike the
basic Spark RDD API, the interfaces provided
by Spark SQL provide Spark with more information about the structure of
both the data and the computation being performed. Internally,
Spark SQL uses this extra information to perform extra optimizations.
There are several ways to
-interact with Spark SQL including SQL, the DataFrames API and the Datasets
API. When computing a result
+interact with Spark SQL including SQL and the Datasets API. When computing
a result
the same execution engine is used, independent of which API/language you
are using to express the
-computation. This unification means that developers can easily switch back
and forth between the
-various APIs based on which provides the most natural way to express a
given transformation.
+computation. This unification means that developers can easily switch back
and forth between
+different APIs based on which provides the most natural way to express a
given transformation.
All of the examples on this page use sample data included in the Spark
distribution and can be run in
the `spark-shell`, `pyspark` shell, or `sparkR` shell.
## SQL
-One use of Spark SQL is to execute SQL queries written using either a
basic SQL syntax or HiveQL.
+One use of Spark SQL is to execute SQL queries.
Spark SQL can also be used to read data from an existing Hive
installation. For more on how to
configure this feature, please refer to the [Hive Tables](#hive-tables)
section. When running
-SQL from within another programming language the results will be returned
as a [DataFrame](#DataFrames).
+SQL from within another programming language the results will be returned
as a [Dataset\[Row\]](#datasets).
You can also interact with the SQL interface using the
[command-line](#running-the-spark-sql-cli)
or over [JDBC/ODBC](#running-the-thrift-jdbcodbc-server).
-## DataFrames
+## Datasets and DataFrames
-A DataFrame is a distributed collection of data organized into named
columns. It is conceptually
-equivalent to a table in a relational database or a data frame in
R/Python, but with richer
-optimizations under the hood. DataFrames can be constructed from a wide
array of [sources](#data-sources) such
-as: structured data files, tables in Hive, external databases, or existing
RDDs.
+A Dataset is a new interface added in Spark 1.6 that tries to provide the
benefits of RDDs (strong
+typing, ability to use powerful lambda functions) with the benefits of
Spark SQL's optimized
+execution engine. A Dataset can be [constructed](#creating-datasets) from
JVM objects and then
+manipulated using functional transformations (map, flatMap, filter, etc.).
-The DataFrame API is available in
[Scala](api/scala/index.html#org.apache.spark.sql.DataFrame),
-[Java](api/java/index.html?org/apache/spark/sql/DataFrame.html),
-[Python](api/python/pyspark.sql.html#pyspark.sql.DataFrame), and
[R](api/R/index.html).
+The Dataset API is the successor of the DataFrame API, which was
introduced in Spark 1.3. In Spark
--- End diff --
`the successor of the DataFrame API` sounds weird.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
