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/08/24 15:51:13 UTC

[GitHub] [flink] shuiqiangchen opened a new pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in P…

shuiqiangchen opened a new pull request #13232:
URL: https://github.com/apache/flink/pull/13232


   <!--
   *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
   
   Add documentation for Configurations in Python DataStream API.
   
   ## Brief change log
   
   - Added a new page named dependency_management.md under dev/python/datastream
   
   ## Verifying this change
   
   This pull request added documentations for existing Python DataStream API, which has no need for test case 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? ( not documented)
   


----------------------------------------------------------------
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 #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078",
       "triggerID" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "triggerType" : "PUSH"
     }, {
       "hash" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6127",
       "triggerID" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "triggerType" : "PUSH"
     }, {
       "hash" : "07120d57281f4e781521884831c2e9b3e3039d7e",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6250",
       "triggerID" : "07120d57281f4e781521884831c2e9b3e3039d7e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "66807617ce2bfb3ff840909bc155bb2d09fd517c",
       "status" : "PENDING",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6425",
       "triggerID" : "66807617ce2bfb3ff840909bc155bb2d09fd517c",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 07120d57281f4e781521884831c2e9b3e3039d7e Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6250) 
   * 66807617ce2bfb3ff840909bc155bb2d09fd517c Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6425) 
   
   <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 #13232: [FLINK-18951][python][docs] Add documentation for Configurations in P…

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825) 
   
   <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] dianfu commented on pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   @shuiqiangchen As StreamExecutionEnvironment#add_jars has been merged. Could you rebase the PR and add documentation on how to specify Java dependencies in Python DataStream jobs?


----------------------------------------------------------------
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 #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "status" : "PENDING",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078",
       "triggerID" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825) 
   * 99c5a7392b35bef45802cee74c59667e64e8f239 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078) 
   
   <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] shuiqiangchen commented on pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   @HuangXingBo Thank you for your comments, I have updated the PR according to your suggestions, please have a look.


----------------------------------------------------------------
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 #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078",
       "triggerID" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "triggerType" : "PUSH"
     }, {
       "hash" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6127",
       "triggerID" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "triggerType" : "PUSH"
     }, {
       "hash" : "07120d57281f4e781521884831c2e9b3e3039d7e",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "07120d57281f4e781521884831c2e9b3e3039d7e",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 492cf7e87bfb8ac6f3fafc73617345b1de1eefe5 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6127) 
   * 07120d57281f4e781521884831c2e9b3e3039d7e 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 edited a comment on pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078",
       "triggerID" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 99c5a7392b35bef45802cee74c59667e64e8f239 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078) 
   
   <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] HuangXingBo commented on a change in pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in P…

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



##########
File path: docs/dev/python/user-guide/table/dependency_management.zh.md
##########
@@ -61,49 +61,49 @@ table_env.add_python_file(file_path)
     <tr>
       <td><strong>set_python_requirements(requirements_file_path, requirements_cache_dir=None)</strong></td>
       <td>
-        <p>Specifies a requirements.txt file which defines the third-party dependencies. These dependencies will be installed to a temporary directory and added to the PYTHONPATH of the python UDF worker. For the dependencies which could not be accessed in the cluster, a directory which contains the installation packages of these dependencies could be specified using the parameter "requirements_cached_dir". It will be uploaded to the cluster to support offline installation.</p>
+        <p>配置一个 requirements.txt 文件用于指定 Python 第三方依赖,这些依赖会被安装到一个临时目录并添加到 Python Worker 的 PYTHONPATH 中。对于在集群中无法访问的外部依赖,用户可以通过 "requirements_cached_dir" 参数指定一个包含这些依赖安装包的目录,这个目录文件会被上传到集群并实现离线安装。</p>
 {% highlight python %}
-# commands executed in shell
+# shell 命令
 echo numpy==1.16.5 > requirements.txt
 pip download -d cached_dir -r requirements.txt --no-binary :all:
 
-# python code
+# Python 代码
 table_env.set_python_requirements("requirements.txt", "cached_dir")
 {% endhighlight %}
-        <p>Please make sure the installation packages matches the platform of the cluster and the python version used. These packages will be installed using pip, so also make sure the version of Pip (version >= 7.1.0) and the version of SetupTools (version >= 37.0.0).</p>
+        <p>请确保这些依赖安装包和集群运行环境以及 Python 版本相匹配。此外,这些依赖将通过 Pip 安装, 请确保 Pip的版本(version >= 7.1.0) 和 Setup Tools 的版本(version >= 37.0.0)和依赖安装包兼容。</p>

Review comment:
       SetupTools -> `Setuptools`




----------------------------------------------------------------
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] shuiqiangchen commented on pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   Hi @HuangXingBo , highly appreciate for your suggestions, I have updated the PR, please have a look at it.


----------------------------------------------------------------
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 #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078",
       "triggerID" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "triggerType" : "PUSH"
     }, {
       "hash" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "status" : "PENDING",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6127",
       "triggerID" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 99c5a7392b35bef45802cee74c59667e64e8f239 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078) 
   * 492cf7e87bfb8ac6f3fafc73617345b1de1eefe5 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6127) 
   
   <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] HuangXingBo commented on pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   @shuiqiangchen Thanks a lot for the update. LGTM


----------------------------------------------------------------
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] dianfu commented on a change in pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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



##########
File path: docs/dev/python/datastream-api-users-guide/dependency_management.md
##########
@@ -0,0 +1,113 @@
+---
+title: "Dependency Management"
+nav-parent_id: python_datastream_api
+nav-pos: 40
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Java Dependency
+
+If third-party Java dependencies are used, you can specify the dependencies with the following Python DataStream APIs or 
+through [command line arguments]({% link ops/cli.md %}#usage) directly when submitting the job.
+
+{% highlight python %}
+# Use the add_jars() to add local jars and the jars will be uploaded to the cluster.
+# NOTE: Only local file URLs (start with "file://") are supported.
+stream_execution_environment.add_jars("file:///my/jar/path/connector.jar", ...)
+
+# Use the add_classpaths() to add the dependent jars URL into the classpath. And the URL will also be added to the classpath of the cluster.
+# NOTE: The Paths must specify a protocol (e.g. file://) and users should ensure that the URLs are accessible on both the client and the cluster.
+stream_execution_environment.add_classpaths("file:///my/jar/path/connector.jar", ...)
+{% endhighlight %}
+**Note** These APIs can be called multiple times.
+
+# Python Dependency
+
+If third-party Python dependencies are used, Users can specify the dependencies with the following Python DataStream 

Review comment:
       ```suggestion
   If third-party Python dependencies are used, you can specify the dependencies with the following Python DataStream 
   ```

##########
File path: docs/dev/python/datastream-api-users-guide/dependency_management.md
##########
@@ -0,0 +1,113 @@
+---
+title: "Dependency Management"
+nav-parent_id: python_datastream_api
+nav-pos: 40
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Java Dependency
+
+If third-party Java dependencies are used, you can specify the dependencies with the following Python DataStream APIs or 
+through [command line arguments]({% link ops/cli.md %}#usage) directly when submitting the job.
+
+{% highlight python %}
+# Use the add_jars() to add local jars and the jars will be uploaded to the cluster.
+# NOTE: Only local file URLs (start with "file://") are supported.
+stream_execution_environment.add_jars("file:///my/jar/path/connector.jar", ...)
+
+# Use the add_classpaths() to add the dependent jars URL into the classpath. And the URL will also be added to the classpath of the cluster.
+# NOTE: The Paths must specify a protocol (e.g. file://) and users should ensure that the URLs are accessible on both the client and the cluster.
+stream_execution_environment.add_classpaths("file:///my/jar/path/connector.jar", ...)
+{% endhighlight %}
+**Note** These APIs can be called multiple times.

Review comment:
       ```suggestion
   **Note:** These APIs can be called multiple times.
   ```




----------------------------------------------------------------
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] HuangXingBo commented on a change in pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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



##########
File path: docs/dev/python/user-guide/table/dependency_management.zh.md
##########
@@ -61,49 +61,49 @@ table_env.add_python_file(file_path)
     <tr>
       <td><strong>set_python_requirements(requirements_file_path, requirements_cache_dir=None)</strong></td>
       <td>
-        <p>Specifies a requirements.txt file which defines the third-party dependencies. These dependencies will be installed to a temporary directory and added to the PYTHONPATH of the python UDF worker. For the dependencies which could not be accessed in the cluster, a directory which contains the installation packages of these dependencies could be specified using the parameter "requirements_cached_dir". It will be uploaded to the cluster to support offline installation.</p>
+        <p>配置一个 requirements.txt 文件用于指定 Python 第三方依赖,这些依赖会被安装到一个临时目录并添加到 Python Worker 的 PYTHONPATH 中。对于在集群中无法访问的外部依赖,用户可以通过 "requirements_cached_dir" 参数指定一个包含这些依赖安装包的目录,这个目录文件会被上传到集群并实现离线安装。</p>
 {% highlight python %}
-# commands executed in shell
+# 执行下面的 shell 命令
 echo numpy==1.16.5 > requirements.txt
 pip download -d cached_dir -r requirements.txt --no-binary :all:
 
-# python code
+# python 代码
 table_env.set_python_requirements("requirements.txt", "cached_dir")
 {% endhighlight %}
-        <p>Please make sure the installation packages matches the platform of the cluster and the python version used. These packages will be installed using pip, so also make sure the version of Pip (version >= 7.1.0) and the version of SetupTools (version >= 37.0.0).</p>
+        <p>请确保这些依赖安装包和集群运行环境以及 Python 版本相匹配。此外,这些依赖将通过 Pip 安装, 请确保 Pip的版本(version >= 7.1.0) 和 Setuptools 的版本(version >= 37.0.0)和依赖安装包兼容。</p>

Review comment:
       ```suggestion
           <p>请确保这些依赖安装包和集群运行环境所使用的的 Python 版本相匹配。此外,这些依赖将通过 Pip 安装, 请确保 Pip的版本(version >= 7.1.0) 和 Setuptools 的版本(version >= 37.0.0)符合要求。</p>
   ```




----------------------------------------------------------------
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] shuiqiangchen commented on pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   @dianfu Thank you for your reminding, I have added the java dependency management part for Python DataStream API docs.


----------------------------------------------------------------
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 #13232: [FLINK-18951][python][docs] Add documentation for Configurations in P…

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e 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 edited a comment on pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078",
       "triggerID" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "triggerType" : "PUSH"
     }, {
       "hash" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6127",
       "triggerID" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "triggerType" : "PUSH"
     }, {
       "hash" : "07120d57281f4e781521884831c2e9b3e3039d7e",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6250",
       "triggerID" : "07120d57281f4e781521884831c2e9b3e3039d7e",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 07120d57281f4e781521884831c2e9b3e3039d7e Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6250) 
   
   <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 #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078",
       "triggerID" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "triggerType" : "PUSH"
     }, {
       "hash" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6127",
       "triggerID" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 492cf7e87bfb8ac6f3fafc73617345b1de1eefe5 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6127) 
   
   <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] dianfu closed pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

Posted by GitBox <gi...@apache.org>.
dianfu closed pull request #13232:
URL: https://github.com/apache/flink/pull/13232


   


----------------------------------------------------------------
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 #13232: [FLINK-18951][python][docs] Add documentation for Configurations in P…

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "PENDING",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825) 
   
   <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 #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078",
       "triggerID" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "triggerType" : "PUSH"
     }, {
       "hash" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 99c5a7392b35bef45802cee74c59667e64e8f239 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078) 
   * 492cf7e87bfb8ac6f3fafc73617345b1de1eefe5 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] HuangXingBo commented on a change in pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in P…

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



##########
File path: docs/dev/python/user-guide/datastream/dependency_management.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Dependency Management"
+nav-parent_id: python_datastream_api
+nav-pos: 40
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Python Dependency
+
+If third-party Python dependencies are used, Users can specify the dependencies with the following Python DataStream 
+APIs or through [command line arguments]({% link ops/cli.md %}#usage) directly when submitting the job.
+
+<table class="table table-bordered">
+  <thead>
+    <tr>
+      <th class="text-left" style="width: 20%">APIs</th>
+      <th class="text-left">Description</th>
+    </tr>
+  </thead>
+
+  <tbody>
+    <tr>
+      <td><strong>add_python_file(file_path)</strong></td>
+      <td>
+        <p>Adds python file dependencies which could be python files, python packages or local directories. They will be added to the PYTHONPATH of the python UDF worker.</p>
+{% highlight python %}
+stream_execution_environment.add_python_file(file_path)
+{% endhighlight %}
+      </td>
+    </tr>
+    <tr>
+      <td><strong>set_python_requirements(requirements_file_path, requirements_cache_dir=None)</strong></td>
+      <td>
+        <p>Specifies a requirements.txt file which defines the third-party dependencies. These dependencies will be installed to a temporary directory and added to the PYTHONPATH of the python UDF worker. For the dependencies which could not be accessed in the cluster, a directory which contains the installation packages of these dependencies could be specified using the parameter "requirements_cached_dir". It will be uploaded to the cluster to support offline installation.</p>
+{% highlight python %}
+# commands executed in shell
+echo numpy==1.16.5 > requirements.txt
+pip download -d cached_dir -r requirements.txt --no-binary :all:
+
+# python code
+stream_execution_environment.set_python_requirements("requirements.txt", "cached_dir")
+{% endhighlight %}
+        <p>Please make sure the installation packages matches the platform of the cluster and the python version used. These packages will be installed using pip, so also make sure the version of Pip (version >= 7.1.0) and the version of SetupTools (version >= 37.0.0).</p>

Review comment:
       SetupTools -> `Setuptools`
   
   

##########
File path: docs/dev/python/user-guide/table/dependency_management.zh.md
##########
@@ -61,49 +61,49 @@ table_env.add_python_file(file_path)
     <tr>
       <td><strong>set_python_requirements(requirements_file_path, requirements_cache_dir=None)</strong></td>
       <td>
-        <p>Specifies a requirements.txt file which defines the third-party dependencies. These dependencies will be installed to a temporary directory and added to the PYTHONPATH of the python UDF worker. For the dependencies which could not be accessed in the cluster, a directory which contains the installation packages of these dependencies could be specified using the parameter "requirements_cached_dir". It will be uploaded to the cluster to support offline installation.</p>
+        <p>配置一个 requirements.txt 文件用于指定 Python 第三方依赖,这些依赖会被安装到一个临时目录并添加到 Python Worker 的 PYTHONPATH 中。对于在集群中无法访问的外部依赖,用户可以通过 "requirements_cached_dir" 参数指定一个包含这些依赖安装包的目录,这个目录文件会被上传到集群并实现离线安装。</p>
 {% highlight python %}
-# commands executed in shell
+# shell 命令

Review comment:
       执行下面的shell命令

##########
File path: docs/dev/python/user-guide/table/dependency_management.zh.md
##########
@@ -61,49 +61,49 @@ table_env.add_python_file(file_path)
     <tr>
       <td><strong>set_python_requirements(requirements_file_path, requirements_cache_dir=None)</strong></td>
       <td>
-        <p>Specifies a requirements.txt file which defines the third-party dependencies. These dependencies will be installed to a temporary directory and added to the PYTHONPATH of the python UDF worker. For the dependencies which could not be accessed in the cluster, a directory which contains the installation packages of these dependencies could be specified using the parameter "requirements_cached_dir". It will be uploaded to the cluster to support offline installation.</p>
+        <p>配置一个 requirements.txt 文件用于指定 Python 第三方依赖,这些依赖会被安装到一个临时目录并添加到 Python Worker 的 PYTHONPATH 中。对于在集群中无法访问的外部依赖,用户可以通过 "requirements_cached_dir" 参数指定一个包含这些依赖安装包的目录,这个目录文件会被上传到集群并实现离线安装。</p>
 {% highlight python %}
-# commands executed in shell
+# shell 命令
 echo numpy==1.16.5 > requirements.txt
 pip download -d cached_dir -r requirements.txt --no-binary :all:
 
-# python code
+# Python 代码

Review comment:
       Python 代码 -> python 代码

##########
File path: docs/dev/python/user-guide/datastream/dependency_management.zh.md
##########
@@ -0,0 +1,96 @@
+---
+title: "依赖管理"
+nav-parent_id: python_datastream_api
+nav-pos: 40
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Python 依赖管理
+如果 Python DataStream 程序中应用到了 Python 第三方依赖,用户可以使用以下 API 配置依赖信息,或在提交作业时直接通过[命令行参数]({% link ops/cli.zh.md %}#usage)配置。
+
+<table class="table table-bordered">
+  <thead>
+    <tr>
+      <th class="text-left" style="width: 20%">APIs</th>
+      <th class="text-left">Description</th>
+    </tr>
+  </thead>
+
+  <tbody>
+    <tr>
+      <td><strong>add_python_file(file_path)</strong></td>
+      <td>
+        <p>添加 Python 文件依赖,可以是 Python文件、Python 包或本地文件目录。它们最终会被添加到 Python Worker 的 PYTHONPATH 中,从而让 Python 函数能够正确访问读取。</p>
+{% highlight python %}
+stream_execution_environment.add_python_file(file_path)
+{% endhighlight %}
+      </td>
+    </tr>
+    <tr>
+      <td><strong>set_python_requirements(requirements_file_path, requirements_cache_dir=None)</strong></td>
+      <td>
+        <p>配置一个 requirements.txt 文件用于指定 Python 第三方依赖,这些依赖会被安装到一个临时目录并添加到 Python Worker 的 PYTHONPATH 中。对于在集群中无法访问的外部依赖,用户可以通过 "requirements_cached_dir" 参数指定一个包含这些依赖安装包的目录,这个目录文件会被上传到集群并实现离线安装。</p>
+{% highlight python %}
+# shell 命令
+echo numpy==1.16.5 > requirements.txt
+pip download -d cached_dir -r requirements.txt --no-binary :all:
+
+# Python 代码
+stream_execution_environment.set_python_requirements("requirements.txt", "cached_dir")
+{% endhighlight %}
+        <p>请确保这些依赖安装包和集群运行环境以及 Python 版本相匹配。此外,这些依赖将通过 Pip 安装, 请确保 Pip的版本(version >= 7.1.0) 和 Setup Tools 的版本(version >= 37.0.0)和依赖安装包兼容。</p>

Review comment:
       SetupTools -> `Setuptools`

##########
File path: docs/dev/python/user-guide/table/dependency_management.zh.md
##########
@@ -61,49 +61,49 @@ table_env.add_python_file(file_path)
     <tr>
       <td><strong>set_python_requirements(requirements_file_path, requirements_cache_dir=None)</strong></td>
       <td>
-        <p>Specifies a requirements.txt file which defines the third-party dependencies. These dependencies will be installed to a temporary directory and added to the PYTHONPATH of the python UDF worker. For the dependencies which could not be accessed in the cluster, a directory which contains the installation packages of these dependencies could be specified using the parameter "requirements_cached_dir". It will be uploaded to the cluster to support offline installation.</p>
+        <p>配置一个 requirements.txt 文件用于指定 Python 第三方依赖,这些依赖会被安装到一个临时目录并添加到 Python Worker 的 PYTHONPATH 中。对于在集群中无法访问的外部依赖,用户可以通过 "requirements_cached_dir" 参数指定一个包含这些依赖安装包的目录,这个目录文件会被上传到集群并实现离线安装。</p>
 {% highlight python %}
-# commands executed in shell
+# shell 命令
 echo numpy==1.16.5 > requirements.txt
 pip download -d cached_dir -r requirements.txt --no-binary :all:
 
-# python code
+# Python 代码
 table_env.set_python_requirements("requirements.txt", "cached_dir")
 {% endhighlight %}
-        <p>Please make sure the installation packages matches the platform of the cluster and the python version used. These packages will be installed using pip, so also make sure the version of Pip (version >= 7.1.0) and the version of SetupTools (version >= 37.0.0).</p>
+        <p>请确保这些依赖安装包和集群运行环境以及 Python 版本相匹配。此外,这些依赖将通过 Pip 安装, 请确保 Pip的版本(version >= 7.1.0) 和 Setup Tools 的版本(version >= 37.0.0)和依赖安装包兼容。</p>

Review comment:
       SetupTools -> Setuptools




----------------------------------------------------------------
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 #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078",
       "triggerID" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "triggerType" : "PUSH"
     }, {
       "hash" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6127",
       "triggerID" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "triggerType" : "PUSH"
     }, {
       "hash" : "07120d57281f4e781521884831c2e9b3e3039d7e",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6250",
       "triggerID" : "07120d57281f4e781521884831c2e9b3e3039d7e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "66807617ce2bfb3ff840909bc155bb2d09fd517c",
       "status" : "UNKNOWN",
       "url" : "TBD",
       "triggerID" : "66807617ce2bfb3ff840909bc155bb2d09fd517c",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 07120d57281f4e781521884831c2e9b3e3039d7e Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6250) 
   * 66807617ce2bfb3ff840909bc155bb2d09fd517c 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 edited a comment on pull request #13232: [FLINK-18951][python][docs] Add documentation for Configurations in Python DataStream API.

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


   <!--
   Meta data
   {
     "version" : 1,
     "metaDataEntries" : [ {
       "hash" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=5825",
       "triggerID" : "dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e",
       "triggerType" : "PUSH"
     }, {
       "hash" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "status" : "DELETED",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6078",
       "triggerID" : "99c5a7392b35bef45802cee74c59667e64e8f239",
       "triggerType" : "PUSH"
     }, {
       "hash" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "status" : "SUCCESS",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6127",
       "triggerID" : "492cf7e87bfb8ac6f3fafc73617345b1de1eefe5",
       "triggerType" : "PUSH"
     }, {
       "hash" : "07120d57281f4e781521884831c2e9b3e3039d7e",
       "status" : "PENDING",
       "url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6250",
       "triggerID" : "07120d57281f4e781521884831c2e9b3e3039d7e",
       "triggerType" : "PUSH"
     } ]
   }-->
   ## CI report:
   
   * 492cf7e87bfb8ac6f3fafc73617345b1de1eefe5 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6127) 
   * 07120d57281f4e781521884831c2e9b3e3039d7e Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=6250) 
   
   <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 #13232: [FLINK-18951][python][docs] Add documentation for Configurations in P…

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


   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 dd7743539c7ed5c45d93fc8b3c12e2db8b7af65e (Mon Aug 24 15:53:25 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