[
https://issues.apache.org/jira/browse/FLINK-3640?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15235273#comment-15235273
]
ASF GitHub Bot commented on FLINK-3640:
---------------------------------------
Github user fhueske commented on a diff in the pull request:
https://github.com/apache/flink/pull/1867#discussion_r59223134
--- Diff: docs/apis/batch/libs/table.md ---
@@ -30,13 +30,21 @@ specific language governing permissions and limitations
under the License.
-->
-**The Table API: an experimental feature**
+Flink's Table API is a a SQL-like expression language embedded in Java and
Scala.
+Instead of manipulating a `DataSet` or `DataStream`, you can create and
work with the `Table` relational abstraction.
+Tables have a schema and allow running relational operations on them,
including selection, aggregation, and joins.
+A `Table` can be created from a `DataSet` or a `DataStream` and then
queried either using the Table API Operators or using SQL queries.
+Once a `Table` is converted back to a `DataSet` or `DataStream`, the
defined relational plan is optimized using [Apache
Calcite](https://calcite.apache.org/)
+and transformed into a `DataSet` or `DataStream` execution plan.
-Flink provides an API that allows specifying operations using SQL-like
expressions. Instead of
-manipulating a `DataSet` you can work with a `Table` on which relational
operations can
-be performed.
+* This will be replaced by the TOC
+{:toc}
-The following dependency must be added to your project in order to use the
Table API:
+Using the Table API and SQL
+----------------------------
+
+The Table API and SQL are part of the *libraries* Maven project.
--- End diff --
*libraries* Maven project -> *flink-libraries* Maven module
> Add support for SQL queries in DataSet programs
> -----------------------------------------------
>
> Key: FLINK-3640
> URL: https://issues.apache.org/jira/browse/FLINK-3640
> Project: Flink
> Issue Type: New Feature
> Components: Table API
> Affects Versions: 1.1.0
> Reporter: Vasia Kalavri
> Assignee: Vasia Kalavri
>
> This issue covers the task of supporting SQL queries embedded in DataSet
> programs. In this mode, the input and output of a SQL query is a Table. For
> this issue, we need to make the following additions to the Table API:
> - add a {{tEnv.sql(query: String): Table}} method for converting a query
> result into a Table
> - integrate Calcite's SQL parser into the batch Table API translation process.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
