You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@flink.apache.org by GitBox <gi...@apache.org> on 2020/10/27 03:45:00 UTC

[GitHub] [flink] xiaoHoly opened a new pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

xiaoHoly opened a new pull request #13801:
URL: https://github.com/apache/flink/pull/13801


   <!--
   *Thank you very much for contributing to Apache Flink - we are happy that you want to help us improve Flink. To help the community review your contribution in the best possible way, please go through the checklist below, which will get the contribution into a shape in which it can be best reviewed.*
   
   *Please understand that we do not do this to make contributions to Flink a hassle. In order to uphold a high standard of quality for code contributions, while at the same time managing a large number of contributions, we need contributors to prepare the contributions well, and give reviewers enough contextual information for the review. Please also understand that contributions that do not follow this guide will take longer to review and thus typically be picked up with lower priority by the community.*
   
   ## Contribution Checklist
   
     - Make sure that the pull request corresponds to a [JIRA issue](https://issues.apache.org/jira/projects/FLINK/issues). Exceptions are made for typos in JavaDoc or documentation files, which need no JIRA issue.
     
     - Name the pull request in the form "[FLINK-XXXX] [component] Title of the pull request", where *FLINK-XXXX* should be replaced by the actual issue number. Skip *component* if you are unsure about which is the best component.
     Typo fixes that have no associated JIRA issue should be named following this pattern: `[hotfix] [docs] Fix typo in event time introduction` or `[hotfix] [javadocs] Expand JavaDoc for PuncuatedWatermarkGenerator`.
   
     - Fill out the template below to describe the changes contributed by the pull request. That will give reviewers the context they need to do the review.
     
     - Make sure that the change passes the automated tests, i.e., `mvn clean verify` passes. You can set up Azure Pipelines CI to do that following [this guide](https://cwiki.apache.org/confluence/display/FLINK/Azure+Pipelines#AzurePipelines-Tutorial:SettingupAzurePipelinesforaforkoftheFlinkrepository).
   
     - Each pull request should address only one issue, not mix up code from multiple issues.
     
     - Each commit in the pull request has a meaningful commit message (including the JIRA id)
   
     - Once all items of the checklist are addressed, remove the above text and this checklist, leaving only the filled out template below.
   
   
   **(The sections below can be removed for hotfixes of typos)**
   -->
   
   ## What is the purpose of the change
   
   I will translate document avro-confluent.md under formats into document avro-confluent.zh.md.
   We should update the Chinese documentation with the changes introduced in FLINK-18802
   
   
   ## Brief change log
   
   -translate  flink/docs/dev/table/connectors/formats/avro-confluent.zh.md
   
   
   ## Verifying this change
   
   
   
   This change is a trivial rework / code cleanup without any test coverage.
   
   
   ## Does this pull request potentially affect one of the following parts:
   
     - Dependencies (does it add or upgrade a dependency): (no)
     - The public API, i.e., is any changed class annotated with `@Public(Evolving)`: (no)
     - The serializers: (no)
     - The runtime per-record code paths (performance sensitive): (no)
     - Anything that affects deployment or recovery: JobManager (and its components), Checkpointing, Kubernetes/Yarn/Mesos, ZooKeeper: (no)
     - The S3 file system connector: (no)
   
   ## Documentation
   
     - Does this pull request introduce a new feature? (no)
     - If yes, how is the feature documented? (no)
   


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] xiaoHoly commented on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
xiaoHoly commented on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717047861


   this week ,i will translate this doc. please help me to review and merge 


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] xiaoHoly commented on a change in pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
xiaoHoly commented on a change in pull request #13801:
URL: https://github.com/apache/flink/pull/13801#discussion_r513155682



##########
File path: docs/dev/table/connectors/formats/avro-confluent.zh.md
##########
@@ -29,27 +29,27 @@ under the License.
 * This will be replaced by the TOC
 {:toc}
 
-The Avro Schema Registry (``avro-confluent``) format allows you to read records that were serialized by the ``io.confluent.kafka.serializers.KafkaAvroSerializer`` and to write records that can in turn be read by the ``io.confluent.kafka.serializers.KafkaAvroDeserializer``. 
+Avro Schema Registry (``avro-confluent``) 格式能让你读取被 ``io.confluent.kafka.serializers.KafkaAvroSerializer``序列化的记录并可以写入成 ``io.confluent.kafka.serializers.KafkaAvroDeserializer``反序列化的记录。
 
-When reading (deserializing) a record with this format the Avro writer schema is fetched from the configured Confluent Schema Registry based on the schema version id encoded in the record while the reader schema is inferred from table schema. 
+当以这种格式读取(反序列化)记录时,将根据记录中编码的 schema 版本 id 从配置的 Confluent Schema Registry 中获取 Avro writer schema ,而从 table schema 中推断出 reader schema。
 
-When writing (serializing) a record with this format the Avro schema is inferred from the table schema and used to retrieve a schema id to be encoded with the data. The lookup is performed with in the configured Confluent Schema Registry under the [subject](https://docs.confluent.io/current/schema-registry/index.html#schemas-subjects-and-topics) given in `avro-confluent.schema-registry.subject`.
+当以这种格式写入(序列化)记录时,Avro schema 是从 table schema 中推断出来的,并用于检索要与数据一起编码的 schema id。检索是在 Confluent Schema Registry 配置中的 `avro-confluent.schema-registry.subject` 中指定的[subject](https://docs.confluent.io/current/schema-registry/index.html#schemas-subjects-and-topics)下执行的。

Review comment:
       thanks,i will update my code with your comments




----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] flinkbot edited a comment on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717137219


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "triggerType" : "PUSH"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375",
       "triggerID" : "717185521",
       "triggerType" : "MANUAL"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375",
       "triggerID" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "triggerType" : "PUSH"
     }, {
       "hash" : "",
       "status" : "DELETED",
       "url" : "TBD",
       "triggerID" : "717185521",
       "triggerType" : "MANUAL"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375",
       "triggerID" : "717643243",
       "triggerType" : "MANUAL"
     } ]
   }-->
   ## CI report:
   
   * 46da3ab5c72c4442611d94e7c34aa35fb34b5aa5 UNKNOWN
   * 4d511a01a26b4a0ad0ea7423887cdd37d163a0e7 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375) 
   
   <details>
   <summary>Bot commands</summary>
     The @flinkbot bot supports the following commands:
   
    - `@flinkbot run travis` re-run the last Travis build
    - `@flinkbot run azure` re-run the last Azure build
   </details>


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] flinkbot edited a comment on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717137219


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "triggerType" : "PUSH"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375",
       "triggerID" : "717185521",
       "triggerType" : "MANUAL"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375",
       "triggerID" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "triggerType" : "PUSH"
     }, {
       "hash" : "",
       "status" : "DELETED",
       "url" : "TBD",
       "triggerID" : "717185521",
       "triggerType" : "MANUAL"
     } ]
   }-->
   ## CI report:
   
   * 46da3ab5c72c4442611d94e7c34aa35fb34b5aa5 UNKNOWN
   * 4d511a01a26b4a0ad0ea7423887cdd37d163a0e7 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375) 
   
   <details>
   <summary>Bot commands</summary>
     The @flinkbot bot supports the following commands:
   
    - `@flinkbot run travis` re-run the last Travis build
    - `@flinkbot run azure` re-run the last Azure build
   </details>


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] dawidwys commented on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
dawidwys commented on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717178918


   Unfortunately I don't know Chinese.
   
   Maybe @wuchong or @klion26 could help with it, or ping someone who can.


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] flinkbot edited a comment on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717137219


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "triggerType" : "PUSH"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "717185521",
       "triggerType" : "MANUAL"
     }, {
       "hash" : "",
       "status" : "CANCELED",
       "url" : "TBD",
       "triggerID" : "717185521",
       "triggerType" : "MANUAL"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 46da3ab5c72c4442611d94e7c34aa35fb34b5aa5 UNKNOWN
   *  Unknown: [CANCELED](TBD) 
   * 4d511a01a26b4a0ad0ea7423887cdd37d163a0e7 UNKNOWN
   
   <details>
   <summary>Bot commands</summary>
     The @flinkbot bot supports the following commands:
   
    - `@flinkbot run travis` re-run the last Travis build
    - `@flinkbot run azure` re-run the last Azure build
   </details>


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] xiaoHoly commented on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
xiaoHoly commented on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717185521


   > * `@flinkbot run travis` re-run the last Travis build
   
   @flinkbot run azure re-run the last Azure build
   


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] flinkbot edited a comment on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717137219


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "triggerType" : "PUSH"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375",
       "triggerID" : "717185521",
       "triggerType" : "MANUAL"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375",
       "triggerID" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "triggerType" : "PUSH"
     }, {
       "hash" : "",
       "status" : "DELETED",
       "url" : "TBD",
       "triggerID" : "717185521",
       "triggerType" : "MANUAL"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "717643243",
       "triggerType" : "MANUAL"
     } ]
   }-->
   ## CI report:
   
   * 46da3ab5c72c4442611d94e7c34aa35fb34b5aa5 UNKNOWN
   * 4d511a01a26b4a0ad0ea7423887cdd37d163a0e7 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375) 
   
   <details>
   <summary>Bot commands</summary>
     The @flinkbot bot supports the following commands:
   
    - `@flinkbot run travis` re-run the last Travis build
    - `@flinkbot run azure` re-run the last Azure build
   </details>


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] xiaoHoly commented on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
xiaoHoly commented on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717643243


   > * `@flinkbot run travis` re-run the last Travis build
   @flinkbot run travis re-run the last Travis build
   


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] xiaoHoly commented on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
xiaoHoly commented on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717181889


   > Unfortunately I don't know Chinese.
   > 
   > Maybe @wuchong or @klion26 could help with it, or ping someone who can.
   
   Well, thank you very much.


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] xiaoHoly commented on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
xiaoHoly commented on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717180958


   @wuchong hi,Jark,I have finished my translation. Can you help me review my code? It may take you some time. Thank you


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] wuchong merged pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
wuchong merged pull request #13801:
URL: https://github.com/apache/flink/pull/13801


   


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] wuchong commented on a change in pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
wuchong commented on a change in pull request #13801:
URL: https://github.com/apache/flink/pull/13801#discussion_r513141770



##########
File path: docs/dev/table/connectors/formats/avro-confluent.zh.md
##########
@@ -72,50 +72,50 @@ CREATE TABLE user_behavior (
 </div>
 </div>
 
-Format Options
+Format 参数
 ----------------
 
 <table class="table table-bordered">
     <thead>
       <tr>
-        <th class="text-left" style="width: 25%">Option</th>
-        <th class="text-center" style="width: 8%">Required</th>
-        <th class="text-center" style="width: 7%">Default</th>
-        <th class="text-center" style="width: 10%">Type</th>
-        <th class="text-center" style="width: 50%">Description</th>
+        <th class="text-left" style="width: 25%">参数</th>
+        <th class="text-center" style="width: 8%">是否必选</th>
+        <th class="text-center" style="width: 7%">默认值</th>
+        <th class="text-center" style="width: 10%">类型</th>
+        <th class="text-center" style="width: 50%">描述</th>
       </tr>
     </thead>
     <tbody>
     <tr>
       <td><h5>format</h5></td>
-      <td>required</td>
+      <td>必选</td>
       <td style="word-wrap: break-word;">(none)</td>
       <td>String</td>
-      <td>Specify what format to use, here should be <code>'avro-confluent'</code>.</td>
+      <td>指定要使用的格式,这里应该是 <code>'avro-confluent'</code>.</td>
     </tr>
     <tr>
       <td><h5>avro-confluent.schema-registry.url</h5></td>
-      <td>required</td>
+      <td>必选</td>
       <td style="word-wrap: break-word;">(none)</td>
       <td>String</td>
-      <td>The URL of the Confluent Schema Registry to fetch/register schemas</td>
+      <td>用于获取/注册 schemas 的 Confluent Schema Registry 的URL </td>
     </tr>
     <tr>
       <td><h5>avro-confluent.schema-registry.subject</h5></td>
-      <td>required by sink</td>
+      <td>sink 必选</td>
       <td style="word-wrap: break-word;">(none)</td>
       <td>String</td>
-      <td>The Confluent Schema Registry subject under which to register the schema used by this format during serialization</td>
+      <td>Confluent Schema Registry主题,用于在序列化期间注册此格式使用的 schema </td>
     </tr>
     </tbody>
 </table>
 
-Data Type Mapping
+数据类型映射
 ----------------
 
-Currently, Apache Flink always uses the table schema to derive the Avro reader schema during deserialization and Avro writer schema during serialization. Explicitly defining an Avro schema is not supported yet.
-See the [Apache Avro Format]({% link dev/table/connectors/formats/avro.zh.md%}#data-type-mapping) for the mapping between Avro and Flink DataTypes. 
+目前 Apache Flink 都是从 table schema 去推断反序列化期间的 Avro reader schema 和序列化期间的 Avro writer schema。显式地定义 Avro schema 暂不支持。
+[Apache Avro Format]({% link dev/table/connectors/formats/avro.zh.md%}#data-type-mapping)中描述了flink数据和Avro数据的对应关系。 

Review comment:
       ```suggestion
   [Apache Avro Format]({% link dev/table/connectors/formats/avro.zh.md%}#data-type-mapping)中描述了 Flink 数据类型和 Avro 类型的对应关系。 
   ```

##########
File path: docs/dev/table/connectors/formats/avro-confluent.zh.md
##########
@@ -72,50 +72,50 @@ CREATE TABLE user_behavior (
 </div>
 </div>
 
-Format Options
+Format 参数
 ----------------
 
 <table class="table table-bordered">
     <thead>
       <tr>
-        <th class="text-left" style="width: 25%">Option</th>
-        <th class="text-center" style="width: 8%">Required</th>
-        <th class="text-center" style="width: 7%">Default</th>
-        <th class="text-center" style="width: 10%">Type</th>
-        <th class="text-center" style="width: 50%">Description</th>
+        <th class="text-left" style="width: 25%">参数</th>
+        <th class="text-center" style="width: 8%">是否必选</th>
+        <th class="text-center" style="width: 7%">默认值</th>
+        <th class="text-center" style="width: 10%">类型</th>
+        <th class="text-center" style="width: 50%">描述</th>
       </tr>
     </thead>
     <tbody>
     <tr>
       <td><h5>format</h5></td>
-      <td>required</td>
+      <td>必选</td>
       <td style="word-wrap: break-word;">(none)</td>
       <td>String</td>
-      <td>Specify what format to use, here should be <code>'avro-confluent'</code>.</td>
+      <td>指定要使用的格式,这里应该是 <code>'avro-confluent'</code>.</td>
     </tr>
     <tr>
       <td><h5>avro-confluent.schema-registry.url</h5></td>
-      <td>required</td>
+      <td>必选</td>
       <td style="word-wrap: break-word;">(none)</td>
       <td>String</td>
-      <td>The URL of the Confluent Schema Registry to fetch/register schemas</td>
+      <td>用于获取/注册 schemas 的 Confluent Schema Registry 的URL </td>
     </tr>
     <tr>
       <td><h5>avro-confluent.schema-registry.subject</h5></td>
-      <td>required by sink</td>
+      <td>sink 必选</td>
       <td style="word-wrap: break-word;">(none)</td>
       <td>String</td>
-      <td>The Confluent Schema Registry subject under which to register the schema used by this format during serialization</td>
+      <td>Confluent Schema Registry主题,用于在序列化期间注册此格式使用的 schema </td>
     </tr>
     </tbody>
 </table>
 
-Data Type Mapping
+数据类型映射
 ----------------
 
-Currently, Apache Flink always uses the table schema to derive the Avro reader schema during deserialization and Avro writer schema during serialization. Explicitly defining an Avro schema is not supported yet.
-See the [Apache Avro Format]({% link dev/table/connectors/formats/avro.zh.md%}#data-type-mapping) for the mapping between Avro and Flink DataTypes. 
+目前 Apache Flink 都是从 table schema 去推断反序列化期间的 Avro reader schema 和序列化期间的 Avro writer schema。显式地定义 Avro schema 暂不支持。
+[Apache Avro Format]({% link dev/table/connectors/formats/avro.zh.md%}#data-type-mapping)中描述了flink数据和Avro数据的对应关系。 
 
-In addition to the types listed there, Flink supports reading/writing nullable types. Flink maps nullable types to Avro `union(something, null)`, where `something` is the Avro type converted from Flink type.
+除了此处列出的类型之外,Flink 还支持读取/写入可为空的类型。 Flink 将可为空的类型映射到 Avro `union(something, null)`, 其中 `something` 是从 Flink 类型转换的 Avro 类型。

Review comment:
       ```suggestion
   除了此处列出的类型之外,Flink 还支持读取/写入可为空(nullable)的类型。 Flink 将可为空的类型映射到 Avro `union(something, null)`, 其中 `something` 是从 Flink 类型转换的 Avro 类型。
   ```

##########
File path: docs/dev/table/connectors/formats/avro-confluent.zh.md
##########
@@ -29,27 +29,27 @@ under the License.
 * This will be replaced by the TOC
 {:toc}
 
-The Avro Schema Registry (``avro-confluent``) format allows you to read records that were serialized by the ``io.confluent.kafka.serializers.KafkaAvroSerializer`` and to write records that can in turn be read by the ``io.confluent.kafka.serializers.KafkaAvroDeserializer``. 
+Avro Schema Registry (``avro-confluent``) 格式能让你读取被 ``io.confluent.kafka.serializers.KafkaAvroSerializer``序列化的记录并可以写入成 ``io.confluent.kafka.serializers.KafkaAvroDeserializer``反序列化的记录。

Review comment:
       ```suggestion
   Avro Schema Registry (``avro-confluent``) 格式能让你读取被 ``io.confluent.kafka.serializers.KafkaAvroSerializer``序列化的记录,以及可以写入成能被 ``io.confluent.kafka.serializers.KafkaAvroDeserializer``反序列化的记录。
   ```

##########
File path: docs/dev/table/connectors/formats/avro-confluent.zh.md
##########
@@ -29,27 +29,27 @@ under the License.
 * This will be replaced by the TOC
 {:toc}
 
-The Avro Schema Registry (``avro-confluent``) format allows you to read records that were serialized by the ``io.confluent.kafka.serializers.KafkaAvroSerializer`` and to write records that can in turn be read by the ``io.confluent.kafka.serializers.KafkaAvroDeserializer``. 
+Avro Schema Registry (``avro-confluent``) 格式能让你读取被 ``io.confluent.kafka.serializers.KafkaAvroSerializer``序列化的记录并可以写入成 ``io.confluent.kafka.serializers.KafkaAvroDeserializer``反序列化的记录。
 
-When reading (deserializing) a record with this format the Avro writer schema is fetched from the configured Confluent Schema Registry based on the schema version id encoded in the record while the reader schema is inferred from table schema. 
+当以这种格式读取(反序列化)记录时,将根据记录中编码的 schema 版本 id 从配置的 Confluent Schema Registry 中获取 Avro writer schema ,而从 table schema 中推断出 reader schema。
 
-When writing (serializing) a record with this format the Avro schema is inferred from the table schema and used to retrieve a schema id to be encoded with the data. The lookup is performed with in the configured Confluent Schema Registry under the [subject](https://docs.confluent.io/current/schema-registry/index.html#schemas-subjects-and-topics) given in `avro-confluent.schema-registry.subject`.
+当以这种格式写入(序列化)记录时,Avro schema 是从 table schema 中推断出来的,并用于检索要与数据一起编码的 schema id。检索是在 Confluent Schema Registry 配置中的 `avro-confluent.schema-registry.subject` 中指定的[subject](https://docs.confluent.io/current/schema-registry/index.html#schemas-subjects-and-topics)下执行的。

Review comment:
       ```suggestion
   当以这种格式写入(序列化)记录时,Avro schema 是从 table schema 中推断出来的,并会用来检索要与数据一起编码的 schema id。我们会在配置的 Confluent Schema Registry 中,配置的 [subject](https://docs.confluent.io/current/schema-registry/index.html#schemas-subjects-and-topics) 下,检索 schema id。subject 通过 `avro-confluent.schema-registry.subject` 参数来制定。
   ```




----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] flinkbot edited a comment on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717137219


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "triggerType" : "PUSH"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375",
       "triggerID" : "717185521",
       "triggerType" : "MANUAL"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375",
       "triggerID" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "triggerType" : "PUSH"
     }, {
       "hash" : "",
       "status" : "DELETED",
       "url" : "TBD",
       "triggerID" : "717185521",
       "triggerType" : "MANUAL"
     }, {
       "hash" : "4d511a01a26b4a0ad0ea7423887cdd37d163a0e7",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375",
       "triggerID" : "717643243",
       "triggerType" : "MANUAL"
     }, {
       "hash" : "e6acf864a3aba7fae30e1e079a2b003d59e84e47",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "e6acf864a3aba7fae30e1e079a2b003d59e84e47",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 46da3ab5c72c4442611d94e7c34aa35fb34b5aa5 UNKNOWN
   * 4d511a01a26b4a0ad0ea7423887cdd37d163a0e7 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=8375) 
   * e6acf864a3aba7fae30e1e079a2b003d59e84e47 UNKNOWN
   
   <details>
   <summary>Bot commands</summary>
     The @flinkbot bot supports the following commands:
   
    - `@flinkbot run travis` re-run the last Travis build
    - `@flinkbot run azure` re-run the last Azure build
   </details>


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] flinkbot commented on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
flinkbot commented on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-716960915


   Thanks a lot for your contribution to the Apache Flink project. I'm the @flinkbot. I help the community
   to review your pull request. We will use this comment to track the progress of the review.
   
   
   ## Automated Checks
   Last check on commit 08c397aefda24ff450869e60acfadff81859e669 (Tue Oct 27 03:46:54 UTC 2020)
   
    ✅no warnings
   
   <sub>Mention the bot in a comment to re-run the automated checks.</sub>
   ## Review Progress
   
   * ❓ 1. The [description] looks good.
   * ❓ 2. There is [consensus] that the contribution should go into to Flink.
   * ❓ 3. Needs [attention] from.
   * ❓ 4. The change fits into the overall [architecture].
   * ❓ 5. Overall code [quality] is good.
   
   Please see the [Pull Request Review Guide](https://flink.apache.org/contributing/reviewing-prs.html) for a full explanation of the review process.<details>
    The Bot is tracking the review progress through labels. Labels are applied according to the order of the review items. For consensus, approval by a Flink committer of PMC member is required <summary>Bot commands</summary>
     The @flinkbot bot supports the following commands:
   
    - `@flinkbot approve description` to approve one or more aspects (aspects: `description`, `consensus`, `architecture` and `quality`)
    - `@flinkbot approve all` to approve all aspects
    - `@flinkbot approve-until architecture` to approve everything until `architecture`
    - `@flinkbot attention @username1 [@username2 ..]` to require somebody's attention
    - `@flinkbot disapprove architecture` to remove an approval you gave earlier
   </details>


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] xiaoHoly commented on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
xiaoHoly commented on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717175769


   @dawidwys ,hi,Dawid Wysakowicz. I have finished my translation. Can you help me review my code?


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [flink] flinkbot commented on pull request #13801: [FLINK-19213][docs-zh] Update the Chinese documentation

Posted by GitBox <gi...@apache.org>.
flinkbot commented on pull request #13801:
URL: https://github.com/apache/flink/pull/13801#issuecomment-717137219


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "46da3ab5c72c4442611d94e7c34aa35fb34b5aa5",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 46da3ab5c72c4442611d94e7c34aa35fb34b5aa5 UNKNOWN
   
   <details>
   <summary>Bot commands</summary>
     The @flinkbot bot supports the following commands:
   
    - `@flinkbot run travis` re-run the last Travis build
    - `@flinkbot run azure` re-run the last Azure build
   </details>


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org