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
---
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.
---
