Github user fhueske commented on a diff in the pull request:
https://github.com/apache/flink/pull/1867#discussion_r59222873
--- 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.
--- End diff --
Table API Operators -> Table API operators
---
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 infrastruct...@apache.org or file a JIRA ticket
with INFRA.
---
