You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@flink.apache.org by tw...@apache.org on 2021/05/31 10:25:06 UTC
[flink] branch release-1.13 updated: [hotfix][docs] Improve soft
deprecation message for DataSet users
This is an automated email from the ASF dual-hosted git repository.
twalthr pushed a commit to branch release-1.13
in repository https://gitbox.apache.org/repos/asf/flink.git
The following commit(s) were added to refs/heads/release-1.13 by this push:
new 617fd07 [hotfix][docs] Improve soft deprecation message for DataSet users
617fd07 is described below
commit 617fd071cf1bc7b3e38ae1b998c6578a0bfb66fe
Author: Timo Walther <tw...@apache.org>
AuthorDate: Mon May 31 12:17:13 2021 +0200
[hotfix][docs] Improve soft deprecation message for DataSet users
---
docs/content.zh/docs/dev/dataset/overview.md | 14 ++++++++++++--
docs/content/docs/dev/dataset/overview.md | 14 ++++++++++++--
2 files changed, 24 insertions(+), 4 deletions(-)
diff --git a/docs/content.zh/docs/dev/dataset/overview.md b/docs/content.zh/docs/dev/dataset/overview.md
index 8faee27..6b51e8e 100644
--- a/docs/content.zh/docs/dev/dataset/overview.md
+++ b/docs/content.zh/docs/dev/dataset/overview.md
@@ -33,8 +33,18 @@ Please refer to the DataStream API overview for an introduction to the basic con
In order to create your own Flink DataSet program, we encourage you to start with the anatomy of a Flink Program and gradually add your own transformations. The remaining sections act as references for additional operations and advanced features.
-{{< hint info >}}
-Starting with Flink 1.12 the DataSet has been soft deprecated. We recommend that you use the DataStream API with `BATCH` execution mode. The linked section also outlines cases where it makes sense to use the DataSet API but those cases will become rarer as development progresses and the DataSet API will eventually be removed. Please also see FLIP-131 for background information on this decision.
+{{< hint warning >}}
+Starting with Flink 1.12 the DataSet API has been soft deprecated.
+
+We recommend that you use the [Table API and SQL]({{< ref "docs/dev/table/overview" >}}) to run efficient
+batch pipelines in a fully unified API. Table API is well integrated with common batch connectors and
+catalogs.
+
+Alternatively, you can also use the DataStream API with `BATCH` [execution mode]({{< ref "docs/dev/datastream/execution_mode" >}}).
+The linked section also outlines cases where it makes sense to use the DataSet API but those cases will
+become rarer as development progresses and the DataSet API will eventually be removed. Please also
+see [FLIP-131](https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=158866741) for
+background information on this decision.
{{< /hint >}}
## Example Program
diff --git a/docs/content/docs/dev/dataset/overview.md b/docs/content/docs/dev/dataset/overview.md
index 97ecb48..bbd33b6 100644
--- a/docs/content/docs/dev/dataset/overview.md
+++ b/docs/content/docs/dev/dataset/overview.md
@@ -33,8 +33,18 @@ Please refer to the DataStream API overview for an introduction to the basic con
In order to create your own Flink DataSet program, we encourage you to start with the anatomy of a Flink Program and gradually add your own transformations. The remaining sections act as references for additional operations and advanced features.
-{{< hint info >}}
-Starting with Flink 1.12 the DataSet has been soft deprecated. We recommend that you use the DataStream API with `BATCH` execution mode. The linked section also outlines cases where it makes sense to use the DataSet API but those cases will become rarer as development progresses and the DataSet API will eventually be removed. Please also see FLIP-131 for background information on this decision.
+{{< hint warning >}}
+Starting with Flink 1.12 the DataSet API has been soft deprecated.
+
+We recommend that you use the [Table API and SQL]({{< ref "docs/dev/table/overview" >}}) to run efficient
+batch pipelines in a fully unified API. Table API is well integrated with common batch connectors and
+catalogs.
+
+Alternatively, you can also use the DataStream API with `BATCH` [execution mode]({{< ref "docs/dev/datastream/execution_mode" >}}).
+The linked section also outlines cases where it makes sense to use the DataSet API but those cases will
+become rarer as development progresses and the DataSet API will eventually be removed. Please also
+see [FLIP-131](https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=158866741) for
+background information on this decision.
{{< /hint >}}
## Example Program