This is an automated email from the ASF dual-hosted git repository. jark pushed a commit to branch release-1.12 in repository https://gitbox.apache.org/repos/asf/flink.git
The following commit(s) were added to refs/heads/release-1.12 by this push: new 2a9c0b0 [FLINK-20998][docs][table] The 'flink-raw.jar' mentioned in docs doesn't exist and add prettier maven xml dependencies 2a9c0b0 is described below commit 2a9c0b00a2b15d0363b41f66d9f595d9402f3b9a Author: Svend Vanderveken <1214071+sv3...@users.noreply.github.com> AuthorDate: Fri Jan 22 06:51:32 2021 +0100 [FLINK-20998][docs][table] The 'flink-raw.jar' mentioned in docs doesn't exist and add prettier maven xml dependencies This closes #14723 --- docs/_data/sql-connectors.yml | 2 +- docs/_includes/sql-connector-download-table.html | 29 ++++++++++++++++++++---- docs/dev/table/connectors/formats/raw.md | 8 +------ docs/dev/table/connectors/formats/raw.zh.md | 8 +------ 4 files changed, 28 insertions(+), 19 deletions(-) diff --git a/docs/_data/sql-connectors.yml b/docs/_data/sql-connectors.yml index 86ed5de..46a9425 100644 --- a/docs/_data/sql-connectors.yml +++ b/docs/_data/sql-connectors.yml @@ -98,7 +98,7 @@ json: raw: name: RAW - maven: flink-raw + maven: category: format built-in: true diff --git a/docs/_includes/sql-connector-download-table.html b/docs/_includes/sql-connector-download-table.html index 56cc78e..981bca0 100644 --- a/docs/_includes/sql-connector-download-table.html +++ b/docs/_includes/sql-connector-download-table.html @@ -27,7 +27,7 @@ and SQL Client with SQL JAR bundles.</p> {% endcomment %} {% if include.connector.versions == nil %} -<table> +<table class="table table-bordered"> <thead> <tr> <th style="text-align: left">Maven dependency</th> @@ -36,7 +36,17 @@ and SQL Client with SQL JAR bundles.</p> </thead> <tbody> <tr> - <td style="text-align: left"><code class="highlighter-rouge">{{ include.connector.maven | liquify }}</code></td> + + <td style="text-align: left"> + <code class="highlighter-rouge"> + <dependency><br/> + <groupId>org.apache.flink</groupId><br/> + <artifactId>{{ include.connector.maven | liquify }}</artifactId><br/> + <version>{{site.version}}</version><br/> + </dependency> + </code> + </td> + {% if include.connector.built-in %} <td style="text-align: left">Built-in</td> {% elsif site.is_stable %} @@ -52,7 +62,7 @@ and SQL Client with SQL JAR bundles.</p> </tbody> </table> {% else %} -<table> +<table class="table table-bordered"> <thead> <tr> <th style="text-align: left">{{ include.connector.name }} version</th> @@ -64,7 +74,18 @@ and SQL Client with SQL JAR bundles.</p> {% for version in include.connector.versions %} <tr> <td style="text-align: left">{{ version.version | liquify }}</td> - <td style="text-align: left"><code class="highlighter-rouge">{{ version.maven | liquify }}</code></td> + <td style="text-align: left"> + <code class="highlighter-rouge"> + + <dependency><br/> + <groupId>org.apache.flink</groupId><br/> + <artifactId>{{ version.maven | liquify }}</artifactId><br/> + <version>{{site.version}}</version><br/> + </dependency> + + </code> + + </td> {% if include.connector.built-in %} <td style="text-align: left">Built-in</td> {% elsif include.connector.no-sql-jar %} diff --git a/docs/dev/table/connectors/formats/raw.md b/docs/dev/table/connectors/formats/raw.md index a2a7bab..f60f399 100644 --- a/docs/dev/table/connectors/formats/raw.md +++ b/docs/dev/table/connectors/formats/raw.md @@ -33,13 +33,7 @@ The Raw format allows to read and write raw (byte based) values as a single colu Note: this format encodes `null` values as `null` of `byte[]` type. This may have limitation when used in `upsert-kafka`, because `upsert-kafka` treats `null` values as a tombstone message (DELETE on the key). Therefore, we recommend avoiding using `upsert-kafka` connector and the `raw` format as a `value.format` if the field can have a `null` value. -Dependencies ------------- - -{% assign connector = site.data.sql-connectors['raw'] %} -{% include sql-connector-download-table.html - connector=connector -%} +The Raw connector is built-in into the Blink planner, no additional dependencies are required. Example ---------------- diff --git a/docs/dev/table/connectors/formats/raw.zh.md b/docs/dev/table/connectors/formats/raw.zh.md index 9892996..4ebba48 100644 --- a/docs/dev/table/connectors/formats/raw.zh.md +++ b/docs/dev/table/connectors/formats/raw.zh.md @@ -33,13 +33,7 @@ Raw format 允许读写原始(基于字节)值作为单个列。 注意: 这种格式将 `null` 值编码成 `byte[]` 类型的 `null`。这样在 `upsert-kafka` 中使用时可能会有限制,因为 `upsert-kafka` 将 `null` 值视为 墓碑消息(在键上删除)。因此,如果该字段可能具有 `null` 值,我们建议避免使用 `upsert-kafka` 连接器和 `raw` format 作为 `value.format`。 -依赖 ------------- - -{% assign connector = site.data.sql-connectors['raw'] %} -{% include sql-connector-download-table.html - connector=connector -%} +Raw format 连接器是内置的。 示例 ----------------