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/01/10 06:09:39 UTC
[GitHub] [flink] CrazyTomatoOo opened a new pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
CrazyTomatoOo opened a new pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822
<!--
*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 Travis CI to do that following [this guide](https://flink.apache.org/contributing/contribute-code.html#open-a-pull-request).
- 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
Translate "Concepts & Common API" page of Table.
## Brief change log
Translation work has been finished without code annotation.
## 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, 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 applicable
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382661785
##########
File path: docs/dev/table/common.zh.md
##########
@@ -723,27 +702,27 @@ table_env.sql_update(
{% top %}
-### Mixing Table API and SQL
+### 混用 Table API 和 SQL
-Table API and SQL queries can be easily mixed because both return `Table` objects:
+Table API 和 SQL 查询的混用非常简单因为它们都返回 `Table` 对象：
-* A Table API query can be defined on the `Table` object returned by a SQL query.
-* A SQL query can be defined on the result of a Table API query by [registering the resulting Table](#register-a-table) in the `TableEnvironment` and referencing it in the `FROM` clause of the SQL query.
+* 可以在 SQL 查询返回的 `Table` 对象上定义 Table API 查询。
+* 通过在 `TableEnvironment` 中注册[结果表](#register-a-table)并在 SQL 查询的 `FROM` 子句中引用它，可以在 Table API 查询的结果上定义 SQL 查询。
Review comment:
seems not very fluent, can you improve this?
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382666789
##########
File path: docs/dev/table/common.zh.md
##########
@@ -827,70 +806,70 @@ result.insert_into("CsvSinkTable")
{% top %}
-Translate and Execute a Query
+解析与执行查询
-----------------------------
-The behavior of translating and executing a query is different for the two planners.
+两种计划器解析和执行查询的方式是不同的。
<div class="codetabs" markdown="1">
<div data-lang="Old planner" markdown="1">
-Table API and SQL queries are translated into [DataStream]({{ site.baseurl }}/dev/datastream_api.html) or [DataSet]({{ site.baseurl }}/dev/batch) programs depending on whether their input is a streaming or batch input. A query is internally represented as a logical query plan and is translated in two phases:
+Table API 和 SQL 查询会被解析成 [流处理]({{ site.baseurl }}/zh/dev/datastream_api.html)或者[批处理]({{ site.baseurl }}/zh/dev/batch)程序， 这取决于它们的输入数据源是流式的还是批式的。查询在内部表示为逻辑查询计划，并被解析成两个阶段：
-1. Optimization of the logical plan
-2. Translation into a DataStream or DataSet program
+1. 优化逻辑执行计划
+2. 解析成流处理或批处理程序
-A Table API or SQL query is translated when:
+Table API 或者 SQL 查询在下列情况下会被解析：
-* a `Table` is emitted to a `TableSink`, i.e., when `Table.insertInto()` is called.
-* a SQL update query is specified, i.e., when `TableEnvironment.sqlUpdate()` is called.
-* a `Table` is converted into a `DataStream` or `DataSet` (see [Integration with DataStream and DataSet API](#integration-with-datastream-and-dataset-api)).
+* `表`被发送给 `TableSink`，即当调用 `Table.insertInto()` 时。
+* SQL 更新语句执行时，即，当调用 `TableEnvironment.sqlUpdate()` 时。
+* `表`被转换成`流数据`或者`批数据`时（参阅[与 DataStream 和 DataSet API 结合](#integration-with-datastream-and-dataset-api)）。
-Once translated, a Table API or SQL query is handled like a regular DataStream or DataSet program and is executed when `StreamExecutionEnvironment.execute()` or `ExecutionEnvironment.execute()` is called.
+解析完成后，Table API 或者 SQL 查询会被当做普通的流处理或批处理程序对待并且会在调用 `StreamExecutionEnvironment.execute()` 或 `ExecutionEnvironment.execute()` 的时候被执行。
</div>
<div data-lang="Blink planner" markdown="1">
-Table API and SQL queries are translated into [DataStream]({{ site.baseurl }}/dev/datastream_api.html) programs whether their input is streaming or batch. A query is internally represented as a logical query plan and is translated in two phases:
+Table API 和 SQL 查询会被转换成[流处理]({{ site.baseurl }}/zh/dev/datastream_api.html)程序不论它们的输入数据源是流式的还是批式的。查询在内部表示为逻辑查询计划，并被解析成两个阶段：
Review comment:
Table API 和 SQL 查询会被转换成[流处理]({{ site.baseurl }}/zh/dev/datastream_api.html)程序不论它们的输入数据源是流式的还是批式的
->
不论输入数据源是流式的还是批式的，Table API 和 SQL 查询都会被转换成[流处理]({{ site.baseurl }}/zh/dev/datastream_api.html)程序。
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] CrazyTomatoOo commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
CrazyTomatoOo commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-590038177
@wuchong Sure
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382641381
##########
File path: docs/dev/table/common.zh.md
##########
@@ -584,11 +563,11 @@ revenue = orders \
### SQL
-Flink's SQL integration is based on [Apache Calcite](https://calcite.apache.org), which implements the SQL standard. SQL queries are specified as regular Strings.
+Flink SQL 是基于实现了SQL标准的 [Apache Calcite](https://Calcite.Apache.org) 的。SQL 查询由常规字符串指定。
Review comment:
Calcite.Apache -> calcite.apache
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/143846846",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/144680093",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150619256",
"triggerID" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"triggerType" : "PUSH"
}, {
"hash" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"status" : "CANCELED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/151356564",
"triggerID" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"triggerType" : "PUSH"
}, {
"hash" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"status" : "FAILURE",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5822",
"triggerID" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"triggerType" : "PUSH"
}, {
"hash" : "c884666aa63cd9edff365c9d55778a75a8d33ed4",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "c884666aa63cd9edff365c9d55778a75a8d33ed4",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 94c9a0247c9dcb9b467ba2629a98677a69679a2b Travis: [CANCELED](https://travis-ci.com/flink-ci/flink/builds/151356564) Azure: [FAILURE](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5822)
* c884666aa63cd9edff365c9d55778a75a8d33ed4 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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382631733
##########
File path: docs/dev/table/common.zh.md
##########
@@ -288,53 +287,36 @@ b_b_t_env = BatchTableEnvironment.create(environment_settings=b_b_settings)
</div>
</div>
-**Note:** If there is only one planner jar in `/lib` directory, you can use `useAnyPlanner` (`use_any_planner` for python) to create specific `EnvironmentSettings`.
+**注释：** 如果`/lib`目录中只有一中计划器的 jar 包，则可以使用`useAnyPlanner`（python 使用 `use any_u_planner`）创建 `EnvironmentSettings`。
{% top %}
-Create Tables in the Catalog
+在 Catalog 中创建表
-------------------------------
-A `TableEnvironment` maintains a map of catalogs of tables which are created with an identifier. Each
-identifier consists of 3 parts: catalog name, database name and object name. If a catalog or database is not
-specified, the current default value will be used (see examples in the [Table identifier expanding](#table-identifier-expanding) section).
+`TableEnvironment` 维护着一个由标识符（identifier）创建的表 catalog 的映射。标识符由三个部分组成：catalog 名称、数据库名称以及对象名称。如果 catalog 或者数据库没有指明，就会使用当前默认值（参见[表标识符扩展](#table-identifier-expanding)章节中的例子）。
-Tables can be either virtual (`VIEWS`) or regular (`TABLES`). `VIEWS` can be created from an
-existing `Table` object, usually the result of a Table API or SQL query. `TABLES` describe
-external data, such as a file, database table, or message queue.
+表可以使虚拟的（`视图（VIEW）`）也可以是常规的（`表（TABLES）`）。`视图`可以从已经存在的``表中创建，一般是 Tbale API 或者 SQL 的查询结果。`表`记录外部数据，例如文件、数据库表或者消息队列。
Review comment:
`` -> `Table`
Tbale API -> Table API
`表`记录 -> 表表示 ？
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382627502
##########
File path: docs/dev/table/common.zh.md
##########
@@ -123,30 +123,29 @@ table_env.execute("python_job")
</div>
</div>
-**Note:** Table API and SQL queries can be easily integrated with and embedded into DataStream or DataSet programs. Have a look at the [Integration with DataStream and DataSet API](#integration-with-datastream-and-dataset-api) section to learn how DataStreams and DataSets can be converted into Tables and vice versa.
+**注释：** Table API 和 SQL 查询可以很容易地集成并嵌入到流处理或批处理程序中。 请参阅[与 DataStream 和 DataSet API 结合](#integration-with-datastream-and-dataset-api) 章节了解如何将数据流和数据集与表之间的相互转化。
{% top %}
-Create a TableEnvironment
+创建 TableEnvironment
-------------------------
-The `TableEnvironment` is a central concept of the Table API and SQL integration. It is responsible for:
+`TableEnvironment` 是 Table API 和 SQL 的核心概念。它负责:
-* Registering a `Table` in the internal catalog
-* Registering catalogs
-* Loading pluggable modules
-* Executing SQL queries
-* Registering a user-defined (scalar, table, or aggregation) function
-* Converting a `DataStream` or `DataSet` into a `Table`
-* Holding a reference to an `ExecutionEnvironment` or `StreamExecutionEnvironment`
+* 在内部的 catalog 中注册`表`
+* 注册外部的 catalog
+* 执行 SQL 查询
+* 注册自定义函数 （scalar、table 或 aggregation）
+* 将`流数据集`或`批数据集`转换成`表`
+* 引用 `ExecutionEnvironment` 或 `StreamExecutionEnvironment`
-A `Table` is always bound to a specific `TableEnvironment`. It is not possible to combine tables of different TableEnvironments in the same query, e.g., to join or union them.
+`表`总是与确定的 `TableEnvironment` 绑定。不能在同一条查询中使用不同 TableEnvironment 中的表，例如，对它们进行 join 或 union 操作。
-A `TableEnvironment` is created by calling the static `BatchTableEnvironment.create()` or `StreamTableEnvironment.create()` method with a `StreamExecutionEnvironment` or an `ExecutionEnvironment` and an optional `TableConfig`. The `TableConfig` can be used to configure the `TableEnvironment` or to customize the query optimization and translation process (see [Query Optimization](#query-optimization)).
+`TableEnvironment` 可以通过静态方法 `BatchTableEnvironment.create()` 或者 `StreamTableEnvironment.create()` 在 `StreamExecutionEnvironment` 或者 `ExecutionEnvironment` 中创建，`TableConfig` 是可选项。`TableConfig`可用于配置`TableEnvironment`或自定义查询优化和转换过程(参见 [查询优化](#query-optimization))。
Review comment:
`custom` can be translated like `定制` ?
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382575510
##########
File path: docs/dev/table/common.zh.md
##########
@@ -123,30 +123,29 @@ table_env.execute("python_job")
</div>
</div>
-**Note:** Table API and SQL queries can be easily integrated with and embedded into DataStream or DataSet programs. Have a look at the [Integration with DataStream and DataSet API](#integration-with-datastream-and-dataset-api) section to learn how DataStreams and DataSets can be converted into Tables and vice versa.
+**注释：** Table API 和 SQL 查询可以很容易地集成并嵌入到流处理或批处理程序中。 请参阅[与 DataStream 和 DataSet API 结合](#integration-with-datastream-and-dataset-api) 章节了解如何将数据流和数据集与表之间的相互转化。
Review comment:
“注释” -> 注意
same as before，keep `DataSet` and `DataStream`, even `Table` as untranslated ?
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:SUCCESS URL:https://travis-ci.com/flink-ci/flink/builds/143846846 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:SUCCESS URL:https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
Hash:0951428e2212abfe79d25d03dd8441a0ecd374d8 Status:PENDING URL:https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389 TriggerType:PUSH TriggerID:0951428e2212abfe79d25d03dd8441a0ecd374d8
Hash:0951428e2212abfe79d25d03dd8441a0ecd374d8 Status:FAILURE URL:https://travis-ci.com/flink-ci/flink/builds/144680093 TriggerType:PUSH TriggerID:0951428e2212abfe79d25d03dd8441a0ecd374d8
-->
## CI report:
* 6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/143846846) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246)
* 0951428e2212abfe79d25d03dd8441a0ecd374d8 Travis: [FAILURE](https://travis-ci.com/flink-ci/flink/builds/144680093) Azure: [PENDING](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389)
<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
With regards,
Apache Git Services
[GitHub] [flink] wuchong commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
wuchong commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-593438903
I will review and merge it later.
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:PENDING URL:https://travis-ci.com/flink-ci/flink/builds/143846846 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:PENDING URL:https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
-->
## CI report:
* 6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Travis: [PENDING](https://travis-ci.com/flink-ci/flink/builds/143846846) Azure: [PENDING](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246)
<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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382628940
##########
File path: docs/dev/table/common.zh.md
##########
@@ -288,53 +287,36 @@ b_b_t_env = BatchTableEnvironment.create(environment_settings=b_b_settings)
</div>
</div>
-**Note:** If there is only one planner jar in `/lib` directory, you can use `useAnyPlanner` (`use_any_planner` for python) to create specific `EnvironmentSettings`.
+**注释：** 如果`/lib`目录中只有一中计划器的 jar 包，则可以使用`useAnyPlanner`（python 使用 `use any_u_planner`）创建 `EnvironmentSettings`。
Review comment:
注释 -> 注意
一中 -> 一种
use any_u_planner -> use_any_planner
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382636229
##########
File path: docs/dev/table/common.zh.md
##########
@@ -503,18 +482,18 @@ tableEnv.createTemporaryView("other_catalog.other_database.exampleView", table)
</div>
-Query a Table
+查询表
-------------
### Table API
-The Table API is a language-integrated query API for Scala and Java. In contrast to SQL, queries are not specified as Strings but are composed step-by-step in the host language.
+Table API 是关于 Scala 和 Java 的集成语言式查询 API。与 SQL 相反，Table API 的查询不是由字符串指定，而是在宿主语言中逐步构成。
Review comment:
逐步构成 -> 逐步构建
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] CrazyTomatoOo commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
CrazyTomatoOo commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-593396632
@libenchao，I'm not sure if it's the right way to resolve the conflict. It's my first time. Please check it out. Thanks！
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382671421
##########
File path: docs/dev/table/common.zh.md
##########
@@ -1091,17 +1070,17 @@ val dsTuple: DataSet[(String, Int)] = tableEnv.toDataSet[(String, Int)](table)
{% top %}
-### Mapping of Data Types to Table Schema
+### 数据类型到 Table Schema 的映射
-Flink's DataStream and DataSet APIs support very diverse types. Composite types such as Tuples (built-in Scala and Flink Java tuples), POJOs, Scala case classes, and Flink's Row type allow for nested data structures with multiple fields that can be accessed in table expressions. Other types are treated as atomic types. In the following, we describe how the Table API converts these types into an internal row representation and show examples of converting a `DataStream` into a `Table`.
+Flink 的 DataStream 和 DataSet APIs 支持多样的数据类型。例如 Tuple（Scala 内置以及Flink Java tuple）、POJO 类型、Scala case class 类型以及 Flink 的 Row 类型等允许嵌套且有多个可在表的表达式中访问的字段的复合数据类型。其他类型被视为原子类型。 Composite types such as Tuples (built-in Scala and Flink Java tuples), POJOs, Scala case classes, and Flink's Row type allow for nested data structures with multiple fields that can be accessed in table expressions. 下面，我们讨论 Table API 如何将这些数据类型类型转换为内部 row 表示形式，并提供将流数据集转换成表的样例。
-The mapping of a data type to a table schema can happen in two ways: **based on the field positions** or **based on the field names**.
+数据类型到 table schema 的映射有两种方式：**基于字段位置**或**基于字段名称**。
-**Position-based Mapping**
+**基于位置映射**
-Position-based mapping can be used to give fields a more meaningful name while keeping the field order. This mapping is available for composite data types *with a defined field order* as well as atomic types. Composite data types such as tuples, rows, and case classes have such a field order. However, fields of a POJO must be mapped based on the field names (see next section). Fields can be projected out but can't be renamed using an alias `as`.
+基于位置的映射可在保持字段顺序的同时为字段提供更有意义的名称。这种映射方式可用于*具有确定的字段顺序*的复合数据类型以及原子类型。如 tuple、row 以及 case class 这些复合数据类型都有这样的字段顺序。然而，POJO 类型的字段则必须通过名称映射（参见下一章）。可以将字段投影出来，但不能使用`as`重命名。
-When defining a position-based mapping, the specified names must not exist in the input data type, otherwise the API will assume that the mapping should happen based on the field names. If no field names are specified, the default field names and field order of the composite type are used or `f0` for atomic types.
+定义基于位置的映射时，输入数据类型中一定不能存在指定的名称，否则 API 会假定应该基于字段名称进行映射。如果未指定任何字段名称，则使用默认的字段名称和复合数据类型的字段顺序，或者使用 “ f0” 表示原子类型。
Review comment:
“ f0” -> `f0`
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382640348
##########
File path: docs/dev/table/common.zh.md
##########
@@ -503,18 +482,18 @@ tableEnv.createTemporaryView("other_catalog.other_database.exampleView", table)
</div>
-Query a Table
+查询表
-------------
### Table API
-The Table API is a language-integrated query API for Scala and Java. In contrast to SQL, queries are not specified as Strings but are composed step-by-step in the host language.
+Table API 是关于 Scala 和 Java 的集成语言式查询 API。与 SQL 相反，Table API 的查询不是由字符串指定，而是在宿主语言中逐步构成。
-The API is based on the `Table` class which represents a table (streaming or batch) and offers methods to apply relational operations. These methods return a new `Table` object, which represents the result of applying the relational operation on the input `Table`. Some relational operations are composed of multiple method calls such as `table.groupBy(...).select()`, where `groupBy(...)` specifies a grouping of `table`, and `select(...)` the projection on the grouping of `table`.
+Table API 是基于 `Table` 类的，该类类代表表（流或批处理），并提供使用关系操作的方法。这些方法返回一个新的 Table 对象，该对象表示对输入 Table 进行关系操作的结果。 一些关系操作由多个方法调用组成，例如 `table.groupBy(...).select()`，其中 `groupBy(...)` 指定 `table` 的分组，而 `select(...)` 在 `table` 分组上的投影。
Review comment:
该类类代表表 -> 该类表示一个表
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/143846846",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "FAILURE",
"url" : "https://travis-ci.com/flink-ci/flink/builds/144680093",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 0951428e2212abfe79d25d03dd8441a0ecd374d8 Travis: [FAILURE](https://travis-ci.com/flink-ci/flink/builds/144680093) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389)
<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
With regards,
Apache Git Services
[GitHub] [flink] wuchong closed pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
wuchong closed pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382676916
##########
File path: docs/internals/stream_checkpointing.zh.md
##########
@@ -23,151 +23,117 @@ specific language governing permissions and limitations
under the License.
-->
-This document describes Flink's fault tolerance mechanism for streaming data flows.
+本文将介绍 Flink 流数据处理的容错机制（fault tolerance mechanism）。
Review comment:
seems that this page is not in this issue， maybe you need to open another pr for this.
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/143846846",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "FAILURE",
"url" : "https://travis-ci.com/flink-ci/flink/builds/144680093",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 0951428e2212abfe79d25d03dd8441a0ecd374d8 Travis: [FAILURE](https://travis-ci.com/flink-ci/flink/builds/144680093) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389)
* f1029c9c099774862058a0d6bfd8ffab5b08a874 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
With regards,
Apache Git Services
[GitHub] [flink] CrazyTomatoOo edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
CrazyTomatoOo edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-591323902
Hi @libenchao, I have revised the doc, what should I do now?
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:SUCCESS URL:https://travis-ci.com/flink-ci/flink/builds/143846846 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:SUCCESS URL:https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
Hash:0951428e2212abfe79d25d03dd8441a0ecd374d8 Status:UNKNOWN URL:TBD TriggerType:PUSH TriggerID:0951428e2212abfe79d25d03dd8441a0ecd374d8
-->
## CI report:
* 6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/143846846) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246)
* 0951428e2212abfe79d25d03dd8441a0ecd374d8 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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382673794
##########
File path: docs/dev/table/common.zh.md
##########
@@ -1406,54 +1385,54 @@ val table: Table = tableEnv.fromDataStream(stream, 'name as 'myName)
{% top %}
-Query Optimization
+查询优化
------------------
<div class="codetabs" markdown="1">
<div data-lang="Old planner" markdown="1">
-Apache Flink leverages Apache Calcite to optimize and translate queries. The optimization currently performed include projection and filter push-down, subquery decorrelation, and other kinds of query rewriting. Old planner does not yet optimize the order of joins, but executes them in the same order as defined in the query (order of Tables in the `FROM` clause and/or order of join predicates in the `WHERE` clause).
+Apache Flink 利用 Apache Calcite 来优化和解析查询。当前执行的优化包括投影和过滤器下推，子查询去相关以及其他类型的查询重写。原版计划程序尚未优化 join 的顺序，而是按照查询中定义的顺序执行它们（FROM 子句中的表顺序和/或 WHERE 子句中的 join 谓词顺序）。
Review comment:
how about “子查询消除”？
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382631908
##########
File path: docs/dev/table/common.zh.md
##########
@@ -288,53 +287,36 @@ b_b_t_env = BatchTableEnvironment.create(environment_settings=b_b_settings)
</div>
</div>
-**Note:** If there is only one planner jar in `/lib` directory, you can use `useAnyPlanner` (`use_any_planner` for python) to create specific `EnvironmentSettings`.
+**注释：** 如果`/lib`目录中只有一中计划器的 jar 包，则可以使用`useAnyPlanner`（python 使用 `use any_u_planner`）创建 `EnvironmentSettings`。
{% top %}
-Create Tables in the Catalog
+在 Catalog 中创建表
-------------------------------
-A `TableEnvironment` maintains a map of catalogs of tables which are created with an identifier. Each
-identifier consists of 3 parts: catalog name, database name and object name. If a catalog or database is not
-specified, the current default value will be used (see examples in the [Table identifier expanding](#table-identifier-expanding) section).
+`TableEnvironment` 维护着一个由标识符（identifier）创建的表 catalog 的映射。标识符由三个部分组成：catalog 名称、数据库名称以及对象名称。如果 catalog 或者数据库没有指明，就会使用当前默认值（参见[表标识符扩展](#table-identifier-expanding)章节中的例子）。
-Tables can be either virtual (`VIEWS`) or regular (`TABLES`). `VIEWS` can be created from an
-existing `Table` object, usually the result of a Table API or SQL query. `TABLES` describe
-external data, such as a file, database table, or message queue.
+表可以使虚拟的（`视图（VIEW）`）也可以是常规的（`表（TABLES）`）。`视图`可以从已经存在的``表中创建，一般是 Tbale API 或者 SQL 的查询结果。`表`记录外部数据，例如文件、数据库表或者消息队列。
-### Temporary vs Permanent tables.
+### 零时表（Temporary Table）和永久表（Permanent Table）
Review comment:
零时表 -> 临时表
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382670534
##########
File path: docs/dev/table/common.zh.md
##########
@@ -1091,17 +1070,17 @@ val dsTuple: DataSet[(String, Int)] = tableEnv.toDataSet[(String, Int)](table)
{% top %}
-### Mapping of Data Types to Table Schema
+### 数据类型到 Table Schema 的映射
-Flink's DataStream and DataSet APIs support very diverse types. Composite types such as Tuples (built-in Scala and Flink Java tuples), POJOs, Scala case classes, and Flink's Row type allow for nested data structures with multiple fields that can be accessed in table expressions. Other types are treated as atomic types. In the following, we describe how the Table API converts these types into an internal row representation and show examples of converting a `DataStream` into a `Table`.
+Flink 的 DataStream 和 DataSet APIs 支持多样的数据类型。例如 Tuple（Scala 内置以及Flink Java tuple）、POJO 类型、Scala case class 类型以及 Flink 的 Row 类型等允许嵌套且有多个可在表的表达式中访问的字段的复合数据类型。其他类型被视为原子类型。 Composite types such as Tuples (built-in Scala and Flink Java tuples), POJOs, Scala case classes, and Flink's Row type allow for nested data structures with multiple fields that can be accessed in table expressions. 下面，我们讨论 Table API 如何将这些数据类型类型转换为内部 row 表示形式，并提供将流数据集转换成表的样例。
Review comment:
forgets to remove original english doc.
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] CrazyTomatoOo commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
CrazyTomatoOo commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-591323902
Hi @libenchao, I have revise the doc, what should I do now?
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:SUCCESS URL:https://travis-ci.com/flink-ci/flink/builds/143846846 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:SUCCESS URL:https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
-->
## CI report:
* 6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/143846846) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246)
<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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:SUCCESS URL:https://travis-ci.com/flink-ci/flink/builds/143846846 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:SUCCESS URL:https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
Hash:0951428e2212abfe79d25d03dd8441a0ecd374d8 Status:PENDING URL:https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389 TriggerType:PUSH TriggerID:0951428e2212abfe79d25d03dd8441a0ecd374d8
Hash:0951428e2212abfe79d25d03dd8441a0ecd374d8 Status:PENDING URL:https://travis-ci.com/flink-ci/flink/builds/144680093 TriggerType:PUSH TriggerID:0951428e2212abfe79d25d03dd8441a0ecd374d8
-->
## CI report:
* 6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/143846846) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246)
* 0951428e2212abfe79d25d03dd8441a0ecd374d8 Travis: [PENDING](https://travis-ci.com/flink-ci/flink/builds/144680093) Azure: [PENDING](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389)
<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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r386396321
##########
File path: docs/dev/table/common.zh.md
##########
@@ -1232,9 +1208,9 @@ val table: Table = tableEnv.fromDataStream(stream, 'myLong)
</div>
</div>
-#### Tuples (Scala and Java) and Case Classes (Scala only)
+#### Tuple类型（Scala 和 Java）和 Case Class类型（仅 Scala）
-Flink supports Scala's built-in tuples and provides its own tuple classes for Java. DataStreams and DataSets of both kinds of tuples can be converted into tables. Fields can be renamed by providing names for all fields (mapping based on position). If no field names are specified, the default field names are used. If the original field names (`f0`, `f1`, ... for Flink Tuples and `_1`, `_2`, ... for Scala Tuples) are referenced, the API assumes that the mapping is name-based instead of position-based. Name-based mapping allows for reordering fields and projection with alias (`as`).
+Flink 支持 Scala 的内置 tuple 类型并给 Java 提供自己的 tuple 类型。两种 tuple 的DataStream和DataSet都能被转换成表。可以通过提供所有字段名称来重命名字段（基于位置映射）。如果没有指明任何字段名称，则会使用默认的字段名称。如果引用了原始字段名称（对于 Flink tuple 为`f0`、`f1` ... ...，对于 Scala tuple 为`_1`、`_2` ... ...），则 API 会假定映射是基于名称的而不是基于位置的。基于名称的映射可以通过 `as` 对字段和投影进行重新排序。
Review comment:
add space around `DataStream` `DataSet`
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572889561
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 6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b (Fri Jan 10 06:11:33 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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/143846846",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/144680093",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"status" : "SUCCESS",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150619256",
"triggerID" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"triggerType" : "PUSH"
}, {
"hash" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* f1029c9c099774862058a0d6bfd8ffab5b08a874 Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/150619256)
* 94c9a0247c9dcb9b467ba2629a98677a69679a2b 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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382634283
##########
File path: docs/dev/table/common.zh.md
##########
@@ -288,53 +287,36 @@ b_b_t_env = BatchTableEnvironment.create(environment_settings=b_b_settings)
</div>
</div>
-**Note:** If there is only one planner jar in `/lib` directory, you can use `useAnyPlanner` (`use_any_planner` for python) to create specific `EnvironmentSettings`.
+**注释：** 如果`/lib`目录中只有一中计划器的 jar 包，则可以使用`useAnyPlanner`（python 使用 `use any_u_planner`）创建 `EnvironmentSettings`。
{% top %}
-Create Tables in the Catalog
+在 Catalog 中创建表
-------------------------------
-A `TableEnvironment` maintains a map of catalogs of tables which are created with an identifier. Each
-identifier consists of 3 parts: catalog name, database name and object name. If a catalog or database is not
-specified, the current default value will be used (see examples in the [Table identifier expanding](#table-identifier-expanding) section).
+`TableEnvironment` 维护着一个由标识符（identifier）创建的表 catalog 的映射。标识符由三个部分组成：catalog 名称、数据库名称以及对象名称。如果 catalog 或者数据库没有指明，就会使用当前默认值（参见[表标识符扩展](#table-identifier-expanding)章节中的例子）。
-Tables can be either virtual (`VIEWS`) or regular (`TABLES`). `VIEWS` can be created from an
-existing `Table` object, usually the result of a Table API or SQL query. `TABLES` describe
-external data, such as a file, database table, or message queue.
+表可以使虚拟的（`视图（VIEW）`）也可以是常规的（`表（TABLES）`）。`视图`可以从已经存在的``表中创建，一般是 Tbale API 或者 SQL 的查询结果。`表`记录外部数据，例如文件、数据库表或者消息队列。
-### Temporary vs Permanent tables.
+### 零时表（Temporary Table）和永久表（Permanent Table）
-Tables may either be temporary, and tied to the lifecycle of a single Flink session, or permanent,
-and visible across multiple Flink sessions and clusters.
+表可以是临时的，并与单个 Flink 会话（session）的生命周期相关，也可以是永久的，并且在多个 Flink 会话和群集（cluster）中可见。
-Permanent tables require a [catalog]({{ site.baseurl }}/dev/table/catalogs.html) (such as Hive Metastore)
-to maintain metadata about the table. Once a permanent table is created, it is visible to any Flink
-session that is connected to the catalog and will continue to exist until the table is explicitly
-dropped.
+永久表需要 [catalog]({{ site.baseurl }}/zh/dev/table/catalogs.html)（例如 Hive Metastore）以维护表的元数据。一旦永久表被创建，它将对任何连接到 catalog 的 Flink 会话可见且持续存在，直至表明确删除。
-On the other hand, temporary tables are always stored in memory and only exist for the duration of
-the Flink session they are created within. These tables are not visible to other sessions. They are
-not bound to any catalog or database but can be created in the namespace of one. Temporary tables
-are not dropped if their corresponding database is removed.
+另一方面，零时表通常保存于内存中并且仅在创建它们的 Flink 会话持续期间存在。这些表对于其它会话是不可见的。它们不与任何 catalog 或者数据库绑定但可以在一个命名空间（namespace）中创建。即使它们对应的数据库被删除，零时表也不会被删除。
-#### Shadowing
+#### 屏蔽（Shadowing）
-It is possible to register a temporary table with the same identifier as an existing permanent
-table. The temporary table shadows the permanent one and makes the permanent table inaccessible as
-long as the temporary one exists. All queries with that identifier will be executed against the
-temporary table.
+可以使用与已存在的永久表相同的标识符去注册零时表。零时表会屏蔽永久表，并且只要零时表存在，永久表就无法访问。所有使用该标识符的查询都将作用于零时表。
-This might be useful for experimentation. It allows running exactly the same query first against a
-temporary table that e.g. has just a subset of data, or the data is obfuscated. Once verified that
-the query is correct it can be run against the real production table.
+这可能对测试（experimentation）有用。它允许先对一个临时表进行完全相同的查询，例如只有一个子集的数据，或者数据是模糊的。一旦验证了查询的正确性，就可以对实际的生产表进行查询。
Review comment:
a little wierd for "数据是模糊的"
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/143846846",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/144680093",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150619256",
"triggerID" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"triggerType" : "PUSH"
}, {
"hash" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"status" : "CANCELED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/151356564",
"triggerID" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"triggerType" : "PUSH"
}, {
"hash" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"status" : "PENDING",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5822",
"triggerID" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"triggerType" : "PUSH"
}, {
"hash" : "c884666aa63cd9edff365c9d55778a75a8d33ed4",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "c884666aa63cd9edff365c9d55778a75a8d33ed4",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 94c9a0247c9dcb9b467ba2629a98677a69679a2b Travis: [CANCELED](https://travis-ci.com/flink-ci/flink/builds/151356564) Azure: [PENDING](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5822)
* c884666aa63cd9edff365c9d55778a75a8d33ed4 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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382571517
##########
File path: docs/dev/table/common.zh.md
##########
@@ -22,28 +22,28 @@ specific language governing permissions and limitations
under the License.
-->
-The Table API and SQL are integrated in a joint API. The central concept of this API is a `Table` which serves as input and output of queries. This document shows the common structure of programs with Table API and SQL queries, how to register a `Table`, how to query a `Table`, and how to emit a `Table`.
+Table API 和 SQL 集成在同一套 API 中。这套 API 的核心概念是`表（Table）`，用作查询的输入和输出。本文介绍了 Table API 和 SQL 查询程序的通用结构、如何注册`表`、如何查询`表`以及如何发出`表`。
* This will be replaced by the TOC
{:toc}
-Main Differences Between the Two Planners
+两种计划器（Planner）的主要区别
-----------------------------------------
-1. Blink treats batch jobs as a special case of streaming. As such, the conversion between Table and DataSet is also not supported, and batch jobs will not be translated into `DateSet` programs but translated into `DataStream` programs, the same as the streaming jobs.
-2. The Blink planner does not support `BatchTableSource`, use bounded `StreamTableSource` instead of it.
-3. The Blink planner only support the brand new `Catalog` and does not support `ExternalCatalog` which is deprecated.
-4. The implementations of `FilterableTableSource` for the old planner and the Blink planner are incompatible. The old planner will push down `PlannerExpression`s into `FilterableTableSource`, while the Blink planner will push down `Expression`s.
-5. String based key-value config options (Please see the documentation about [Configuration]({{ site.baseurl }}/dev/table/config.html) for details) are only used for the Blink planner.
-6. The implementation(`CalciteConfig`) of `PlannerConfig` in two planners is different.
-7. The Blink planner will optimize multiple-sinks into one DAG (supported only on `TableEnvironment`, not on `StreamTableEnvironment`). The old planner will always optimize each sink into a new DAG, where all DAGs are independent of each other.
-8. The old planner does not support catalog statistics now, while the Blink planner does.
+1. Blink 将批处理作业视作流处理的一种特例。严格来说，表和批数据之间的转换并不受支持，并且批处理作业也不会转换成`批处理`程序而是转换成流处理程序，`流处理`作业也一样。
+2. Blink 计划器不支持 `BatchTableSource`，而是使用有界的 `StreamTableSource` 来替代。
+3. Blink 计划器仅支持全新的 `Catalog` 并且不支持被弃用的 `ExternalCatalog`。
+4. 原版计划器和 Blink 计划器中 `FilterableTableSource` 的实现是不兼容的。原版计划器会将 `PlannerExpression` 下推至 `FilterableTableSource`，而 Blink 计划器则是将 `Expression` 下推。
Review comment:
I'm a little hesitate to translate 'old planner' to '原版计划器'， however I cannot find a better word to express this.
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382632936
##########
File path: docs/dev/table/common.zh.md
##########
@@ -288,53 +287,36 @@ b_b_t_env = BatchTableEnvironment.create(environment_settings=b_b_settings)
</div>
</div>
-**Note:** If there is only one planner jar in `/lib` directory, you can use `useAnyPlanner` (`use_any_planner` for python) to create specific `EnvironmentSettings`.
+**注释：** 如果`/lib`目录中只有一中计划器的 jar 包，则可以使用`useAnyPlanner`（python 使用 `use any_u_planner`）创建 `EnvironmentSettings`。
{% top %}
-Create Tables in the Catalog
+在 Catalog 中创建表
-------------------------------
-A `TableEnvironment` maintains a map of catalogs of tables which are created with an identifier. Each
-identifier consists of 3 parts: catalog name, database name and object name. If a catalog or database is not
-specified, the current default value will be used (see examples in the [Table identifier expanding](#table-identifier-expanding) section).
+`TableEnvironment` 维护着一个由标识符（identifier）创建的表 catalog 的映射。标识符由三个部分组成：catalog 名称、数据库名称以及对象名称。如果 catalog 或者数据库没有指明，就会使用当前默认值（参见[表标识符扩展](#table-identifier-expanding)章节中的例子）。
-Tables can be either virtual (`VIEWS`) or regular (`TABLES`). `VIEWS` can be created from an
-existing `Table` object, usually the result of a Table API or SQL query. `TABLES` describe
-external data, such as a file, database table, or message queue.
+表可以使虚拟的（`视图（VIEW）`）也可以是常规的（`表（TABLES）`）。`视图`可以从已经存在的``表中创建，一般是 Tbale API 或者 SQL 的查询结果。`表`记录外部数据，例如文件、数据库表或者消息队列。
-### Temporary vs Permanent tables.
+### 零时表（Temporary Table）和永久表（Permanent Table）
-Tables may either be temporary, and tied to the lifecycle of a single Flink session, or permanent,
-and visible across multiple Flink sessions and clusters.
+表可以是临时的，并与单个 Flink 会话（session）的生命周期相关，也可以是永久的，并且在多个 Flink 会话和群集（cluster）中可见。
-Permanent tables require a [catalog]({{ site.baseurl }}/dev/table/catalogs.html) (such as Hive Metastore)
-to maintain metadata about the table. Once a permanent table is created, it is visible to any Flink
-session that is connected to the catalog and will continue to exist until the table is explicitly
-dropped.
+永久表需要 [catalog]({{ site.baseurl }}/zh/dev/table/catalogs.html)（例如 Hive Metastore）以维护表的元数据。一旦永久表被创建，它将对任何连接到 catalog 的 Flink 会话可见且持续存在，直至表明确删除。
-On the other hand, temporary tables are always stored in memory and only exist for the duration of
-the Flink session they are created within. These tables are not visible to other sessions. They are
-not bound to any catalog or database but can be created in the namespace of one. Temporary tables
-are not dropped if their corresponding database is removed.
+另一方面，零时表通常保存于内存中并且仅在创建它们的 Flink 会话持续期间存在。这些表对于其它会话是不可见的。它们不与任何 catalog 或者数据库绑定但可以在一个命名空间（namespace）中创建。即使它们对应的数据库被删除，零时表也不会被删除。
Review comment:
零时表
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/143846846",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/144680093",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"status" : "SUCCESS",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150619256",
"triggerID" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* f1029c9c099774862058a0d6bfd8ffab5b08a874 Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/150619256)
<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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382675115
##########
File path: docs/dev/table/common.zh.md
##########
@@ -1406,54 +1385,54 @@ val table: Table = tableEnv.fromDataStream(stream, 'name as 'myName)
{% top %}
-Query Optimization
+查询优化
------------------
<div class="codetabs" markdown="1">
<div data-lang="Old planner" markdown="1">
-Apache Flink leverages Apache Calcite to optimize and translate queries. The optimization currently performed include projection and filter push-down, subquery decorrelation, and other kinds of query rewriting. Old planner does not yet optimize the order of joins, but executes them in the same order as defined in the query (order of Tables in the `FROM` clause and/or order of join predicates in the `WHERE` clause).
+Apache Flink 利用 Apache Calcite 来优化和解析查询。当前执行的优化包括投影和过滤器下推，子查询去相关以及其他类型的查询重写。原版计划程序尚未优化 join 的顺序，而是按照查询中定义的顺序执行它们（FROM 子句中的表顺序和/或 WHERE 子句中的 join 谓词顺序）。
-It is possible to tweak the set of optimization rules which are applied in different phases by providing a `CalciteConfig` object. This can be created via a builder by calling `CalciteConfig.createBuilder())` and is provided to the TableEnvironment by calling `tableEnv.getConfig.setPlannerConfig(calciteConfig)`.
+通过提供一个 `CalciteConfig` 对象，可以调整在不同阶段应用的优化规则集合。这个对象可以通过调用构造器 `CalciteConfig.createBuilder()` 创建，并通过调用 `tableEnv.getConfig.setPlannerConfig(calciteConfig)` 提供给 TableEnvironment。
</div>
<div data-lang="Blink planner" markdown="1">
-Apache Flink leverages and extends Apache Calcite to perform sophisticated query optimization.
-This includes a series of rule and cost-based optimizations such as:
+Apache Flink 使用并扩展了 Apache Calcite 来执行复杂的查询优化。
+这包括一系列基于规则和成本的优化，例如：
-* Subquery decorrelation based on Apache Calcite
-* Project pruning
-* Partition pruning
-* Filter push-down
-* Sub-plan deduplication to avoid duplicate computation
-* Special subquery rewriting, including two parts:
- * Converts IN and EXISTS into left semi-joins
- * Converts NOT IN and NOT EXISTS into left anti-join
-* Optional join reordering
- * Enabled via `table.optimizer.join-reorder-enabled`
+* 基于 Apache Calcite 的子查询解相关
+* 模型剪枝
Review comment:
how about translate pruning to ”剪裁“ instead of “剪枝" ？
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382636061
##########
File path: docs/dev/table/common.zh.md
##########
@@ -503,18 +482,18 @@ tableEnv.createTemporaryView("other_catalog.other_database.exampleView", table)
</div>
-Query a Table
+查询表
-------------
### Table API
-The Table API is a language-integrated query API for Scala and Java. In contrast to SQL, queries are not specified as Strings but are composed step-by-step in the host language.
+Table API 是关于 Scala 和 Java 的集成语言式查询 API。与 SQL 相反，Table API 的查询不是由字符串指定，而是在宿主语言中逐步构成。
Review comment:
see: https://github.com/apache/flink/pull/11127#discussion_r382408413
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382569937
##########
File path: docs/dev/table/common.zh.md
##########
@@ -22,28 +22,28 @@ specific language governing permissions and limitations
under the License.
-->
-The Table API and SQL are integrated in a joint API. The central concept of this API is a `Table` which serves as input and output of queries. This document shows the common structure of programs with Table API and SQL queries, how to register a `Table`, how to query a `Table`, and how to emit a `Table`.
+Table API 和 SQL 集成在同一套 API 中。这套 API 的核心概念是`表（Table）`，用作查询的输入和输出。本文介绍了 Table API 和 SQL 查询程序的通用结构、如何注册`表`、如何查询`表`以及如何发出`表`。
* This will be replaced by the TOC
{:toc}
-Main Differences Between the Two Planners
+两种计划器（Planner）的主要区别
-----------------------------------------
-1. Blink treats batch jobs as a special case of streaming. As such, the conversion between Table and DataSet is also not supported, and batch jobs will not be translated into `DateSet` programs but translated into `DataStream` programs, the same as the streaming jobs.
-2. The Blink planner does not support `BatchTableSource`, use bounded `StreamTableSource` instead of it.
-3. The Blink planner only support the brand new `Catalog` and does not support `ExternalCatalog` which is deprecated.
-4. The implementations of `FilterableTableSource` for the old planner and the Blink planner are incompatible. The old planner will push down `PlannerExpression`s into `FilterableTableSource`, while the Blink planner will push down `Expression`s.
-5. String based key-value config options (Please see the documentation about [Configuration]({{ site.baseurl }}/dev/table/config.html) for details) are only used for the Blink planner.
-6. The implementation(`CalciteConfig`) of `PlannerConfig` in two planners is different.
-7. The Blink planner will optimize multiple-sinks into one DAG (supported only on `TableEnvironment`, not on `StreamTableEnvironment`). The old planner will always optimize each sink into a new DAG, where all DAGs are independent of each other.
-8. The old planner does not support catalog statistics now, while the Blink planner does.
+1. Blink 将批处理作业视作流处理的一种特例。严格来说，表和批数据之间的转换并不受支持，并且批处理作业也不会转换成`批处理`程序而是转换成流处理程序，`流处理`作业也一样。
Review comment:
”严格来说，表和批数据之间的转换并不受支持“ -> "因此，并不支持 Table 和 DataSet 互相转换"。
IMO，we don't need to translate `DataSet` and `DataStream`.
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382574407
##########
File path: docs/dev/table/common.zh.md
##########
@@ -22,28 +22,28 @@ specific language governing permissions and limitations
under the License.
-->
-The Table API and SQL are integrated in a joint API. The central concept of this API is a `Table` which serves as input and output of queries. This document shows the common structure of programs with Table API and SQL queries, how to register a `Table`, how to query a `Table`, and how to emit a `Table`.
+Table API 和 SQL 集成在同一套 API 中。这套 API 的核心概念是`表（Table）`，用作查询的输入和输出。本文介绍了 Table API 和 SQL 查询程序的通用结构、如何注册`表`、如何查询`表`以及如何发出`表`。
* This will be replaced by the TOC
{:toc}
-Main Differences Between the Two Planners
+两种计划器（Planner）的主要区别
-----------------------------------------
-1. Blink treats batch jobs as a special case of streaming. As such, the conversion between Table and DataSet is also not supported, and batch jobs will not be translated into `DateSet` programs but translated into `DataStream` programs, the same as the streaming jobs.
-2. The Blink planner does not support `BatchTableSource`, use bounded `StreamTableSource` instead of it.
-3. The Blink planner only support the brand new `Catalog` and does not support `ExternalCatalog` which is deprecated.
-4. The implementations of `FilterableTableSource` for the old planner and the Blink planner are incompatible. The old planner will push down `PlannerExpression`s into `FilterableTableSource`, while the Blink planner will push down `Expression`s.
-5. String based key-value config options (Please see the documentation about [Configuration]({{ site.baseurl }}/dev/table/config.html) for details) are only used for the Blink planner.
-6. The implementation(`CalciteConfig`) of `PlannerConfig` in two planners is different.
-7. The Blink planner will optimize multiple-sinks into one DAG (supported only on `TableEnvironment`, not on `StreamTableEnvironment`). The old planner will always optimize each sink into a new DAG, where all DAGs are independent of each other.
-8. The old planner does not support catalog statistics now, while the Blink planner does.
+1. Blink 将批处理作业视作流处理的一种特例。严格来说，表和批数据之间的转换并不受支持，并且批处理作业也不会转换成`批处理`程序而是转换成流处理程序，`流处理`作业也一样。
+2. Blink 计划器不支持 `BatchTableSource`，而是使用有界的 `StreamTableSource` 来替代。
+3. Blink 计划器仅支持全新的 `Catalog` 并且不支持被弃用的 `ExternalCatalog`。
+4. 原版计划器和 Blink 计划器中 `FilterableTableSource` 的实现是不兼容的。原版计划器会将 `PlannerExpression` 下推至 `FilterableTableSource`，而 Blink 计划器则是将 `Expression` 下推。
+5. 基于字符串的键值配置选项仅在 Blink 计划器中使用。（详情参见 [配置]({{ site.baseurl }}/zh/dev/table/config.html) ）
+6. `PlannerConfig` 在两种计划器中的实现（`CalciteConfig`）是不同的。
+7. Blink 计划器会将多sink（multiple-sinks）优化成一张有向无环图（DAG）（仅支持 `TableEnvironment`，不支持 `StreamTableEnvironment`）。原版计划器总是将每个sink都优化成一个新的有向无环图，且所有图相互独立。
+8. 原版计划器目前不支持 catalog 统计，而 Blink 支持。
Review comment:
”catalog 统计“ -> "catalog 统计信息” or 统计数据？
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/143846846",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/144680093",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"status" : "SUCCESS",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150619256",
"triggerID" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"triggerType" : "PUSH"
}, {
"hash" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"status" : "PENDING",
"url" : "https://travis-ci.com/flink-ci/flink/builds/151356564",
"triggerID" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"triggerType" : "PUSH"
}, {
"hash" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"status" : "PENDING",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5822",
"triggerID" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"triggerType" : "PUSH"
}, {
"hash" : "c884666aa63cd9edff365c9d55778a75a8d33ed4",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "c884666aa63cd9edff365c9d55778a75a8d33ed4",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* f1029c9c099774862058a0d6bfd8ffab5b08a874 Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/150619256)
* 94c9a0247c9dcb9b467ba2629a98677a69679a2b Travis: [PENDING](https://travis-ci.com/flink-ci/flink/builds/151356564) Azure: [PENDING](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5822)
* c884666aa63cd9edff365c9d55778a75a8d33ed4 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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382632618
##########
File path: docs/dev/table/common.zh.md
##########
@@ -288,53 +287,36 @@ b_b_t_env = BatchTableEnvironment.create(environment_settings=b_b_settings)
</div>
</div>
-**Note:** If there is only one planner jar in `/lib` directory, you can use `useAnyPlanner` (`use_any_planner` for python) to create specific `EnvironmentSettings`.
+**注释：** 如果`/lib`目录中只有一中计划器的 jar 包，则可以使用`useAnyPlanner`（python 使用 `use any_u_planner`）创建 `EnvironmentSettings`。
{% top %}
-Create Tables in the Catalog
+在 Catalog 中创建表
-------------------------------
-A `TableEnvironment` maintains a map of catalogs of tables which are created with an identifier. Each
-identifier consists of 3 parts: catalog name, database name and object name. If a catalog or database is not
-specified, the current default value will be used (see examples in the [Table identifier expanding](#table-identifier-expanding) section).
+`TableEnvironment` 维护着一个由标识符（identifier）创建的表 catalog 的映射。标识符由三个部分组成：catalog 名称、数据库名称以及对象名称。如果 catalog 或者数据库没有指明，就会使用当前默认值（参见[表标识符扩展](#table-identifier-expanding)章节中的例子）。
-Tables can be either virtual (`VIEWS`) or regular (`TABLES`). `VIEWS` can be created from an
-existing `Table` object, usually the result of a Table API or SQL query. `TABLES` describe
-external data, such as a file, database table, or message queue.
+表可以使虚拟的（`视图（VIEW）`）也可以是常规的（`表（TABLES）`）。`视图`可以从已经存在的``表中创建，一般是 Tbale API 或者 SQL 的查询结果。`表`记录外部数据，例如文件、数据库表或者消息队列。
-### Temporary vs Permanent tables.
+### 零时表（Temporary Table）和永久表（Permanent Table）
-Tables may either be temporary, and tied to the lifecycle of a single Flink session, or permanent,
-and visible across multiple Flink sessions and clusters.
+表可以是临时的，并与单个 Flink 会话（session）的生命周期相关，也可以是永久的，并且在多个 Flink 会话和群集（cluster）中可见。
-Permanent tables require a [catalog]({{ site.baseurl }}/dev/table/catalogs.html) (such as Hive Metastore)
-to maintain metadata about the table. Once a permanent table is created, it is visible to any Flink
-session that is connected to the catalog and will continue to exist until the table is explicitly
-dropped.
+永久表需要 [catalog]({{ site.baseurl }}/zh/dev/table/catalogs.html)（例如 Hive Metastore）以维护表的元数据。一旦永久表被创建，它将对任何连接到 catalog 的 Flink 会话可见且持续存在，直至表明确删除。
Review comment:
直至表明确删除 -> 直至被明确删除
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:SUCCESS URL:https://travis-ci.com/flink-ci/flink/builds/143846846 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:SUCCESS URL:https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246 TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
Hash:0951428e2212abfe79d25d03dd8441a0ecd374d8 Status:SUCCESS URL:https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389 TriggerType:PUSH TriggerID:0951428e2212abfe79d25d03dd8441a0ecd374d8
Hash:0951428e2212abfe79d25d03dd8441a0ecd374d8 Status:FAILURE URL:https://travis-ci.com/flink-ci/flink/builds/144680093 TriggerType:PUSH TriggerID:0951428e2212abfe79d25d03dd8441a0ecd374d8
-->
## CI report:
* 6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/143846846) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246)
* 0951428e2212abfe79d25d03dd8441a0ecd374d8 Travis: [FAILURE](https://travis-ci.com/flink-ci/flink/builds/144680093) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389)
<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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-591371573
@CrazyTomatoOo Thanks for the updating. It seems that your pr is conflicted with master, could you rebase your pr towards master to resolve the conflict?
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382663375
##########
File path: docs/dev/table/common.zh.md
##########
@@ -723,27 +702,27 @@ table_env.sql_update(
{% top %}
-### Mixing Table API and SQL
+### 混用 Table API 和 SQL
-Table API and SQL queries can be easily mixed because both return `Table` objects:
+Table API 和 SQL 查询的混用非常简单因为它们都返回 `Table` 对象：
-* A Table API query can be defined on the `Table` object returned by a SQL query.
-* A SQL query can be defined on the result of a Table API query by [registering the resulting Table](#register-a-table) in the `TableEnvironment` and referencing it in the `FROM` clause of the SQL query.
+* 可以在 SQL 查询返回的 `Table` 对象上定义 Table API 查询。
+* 通过在 `TableEnvironment` 中注册[结果表](#register-a-table)并在 SQL 查询的 `FROM` 子句中引用它，可以在 Table API 查询的结果上定义 SQL 查询。
{% top %}
-Emit a Table
+发出表
------------
-A `Table` is emitted by writing it to a `TableSink`. A `TableSink` is a generic interface to support a wide variety of file formats (e.g. CSV, Apache Parquet, Apache Avro), storage systems (e.g., JDBC, Apache HBase, Apache Cassandra, Elasticsearch), or messaging systems (e.g., Apache Kafka, RabbitMQ).
+`表`通过写入 `TableSink` 发出。`TableSink` 是一个通用接口，用于支持多种文件格式（如 CSV、Apache Parquet、Apache Avro）、存储系统（如 JDBC、Apache HBase、Apache Cassandra、Elasticsearch）或消息传递系统（如 Apache Kafka、RabbitMQ）。
Review comment:
发出 -> 输出
消息传递 -> 消息队列
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/143846846",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/144680093",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"status" : "SUCCESS",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150619256",
"triggerID" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"triggerType" : "PUSH"
}, {
"hash" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"status" : "PENDING",
"url" : "https://travis-ci.com/flink-ci/flink/builds/151356564",
"triggerID" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"triggerType" : "PUSH"
}, {
"hash" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"status" : "PENDING",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5822",
"triggerID" : "94c9a0247c9dcb9b467ba2629a98677a69679a2b",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* f1029c9c099774862058a0d6bfd8ffab5b08a874 Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/150619256)
* 94c9a0247c9dcb9b467ba2629a98677a69679a2b Travis: [PENDING](https://travis-ci.com/flink-ci/flink/builds/151356564) Azure: [PENDING](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5822)
<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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/143846846",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "FAILURE",
"url" : "https://travis-ci.com/flink-ci/flink/builds/144680093",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"status" : "PENDING",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150619256",
"triggerID" : "f1029c9c099774862058a0d6bfd8ffab5b08a874",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 0951428e2212abfe79d25d03dd8441a0ecd374d8 Travis: [FAILURE](https://travis-ci.com/flink-ci/flink/builds/144680093) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389)
* f1029c9c099774862058a0d6bfd8ffab5b08a874 Travis: [PENDING](https://travis-ci.com/flink-ci/flink/builds/150619256)
<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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382676097
##########
File path: docs/dev/table/common.zh.md
##########
@@ -1406,54 +1385,54 @@ val table: Table = tableEnv.fromDataStream(stream, 'name as 'myName)
{% top %}
-Query Optimization
+查询优化
------------------
<div class="codetabs" markdown="1">
<div data-lang="Old planner" markdown="1">
-Apache Flink leverages Apache Calcite to optimize and translate queries. The optimization currently performed include projection and filter push-down, subquery decorrelation, and other kinds of query rewriting. Old planner does not yet optimize the order of joins, but executes them in the same order as defined in the query (order of Tables in the `FROM` clause and/or order of join predicates in the `WHERE` clause).
+Apache Flink 利用 Apache Calcite 来优化和解析查询。当前执行的优化包括投影和过滤器下推，子查询去相关以及其他类型的查询重写。原版计划程序尚未优化 join 的顺序，而是按照查询中定义的顺序执行它们（FROM 子句中的表顺序和/或 WHERE 子句中的 join 谓词顺序）。
-It is possible to tweak the set of optimization rules which are applied in different phases by providing a `CalciteConfig` object. This can be created via a builder by calling `CalciteConfig.createBuilder())` and is provided to the TableEnvironment by calling `tableEnv.getConfig.setPlannerConfig(calciteConfig)`.
+通过提供一个 `CalciteConfig` 对象，可以调整在不同阶段应用的优化规则集合。这个对象可以通过调用构造器 `CalciteConfig.createBuilder()` 创建，并通过调用 `tableEnv.getConfig.setPlannerConfig(calciteConfig)` 提供给 TableEnvironment。
</div>
<div data-lang="Blink planner" markdown="1">
-Apache Flink leverages and extends Apache Calcite to perform sophisticated query optimization.
-This includes a series of rule and cost-based optimizations such as:
+Apache Flink 使用并扩展了 Apache Calcite 来执行复杂的查询优化。
+这包括一系列基于规则和成本的优化，例如：
-* Subquery decorrelation based on Apache Calcite
-* Project pruning
-* Partition pruning
-* Filter push-down
-* Sub-plan deduplication to avoid duplicate computation
-* Special subquery rewriting, including two parts:
- * Converts IN and EXISTS into left semi-joins
- * Converts NOT IN and NOT EXISTS into left anti-join
-* Optional join reordering
- * Enabled via `table.optimizer.join-reorder-enabled`
+* 基于 Apache Calcite 的子查询解相关
+* 模型剪枝
+* 分区剪枝
+* 过滤器下推
+* 子计划消除重复数据以避免重复计算
+* 特殊子查询重写，包括两部分：
+ * 将 IN 和 EXISTS 转换为 left semi-joins
+ * 将 NOT IN 和 NOT EXISTS 转换为 left anti-join
+* 可选 join 重新排序
+ * 通过 `table.optimizer.join-reorder-enabled` 启用
-**Note:** IN/EXISTS/NOT IN/NOT EXISTS are currently only supported in conjunctive conditions in subquery rewriting.
+**注释：** 当前仅在子查询重写的结合条件下支持 IN / EXISTS / NOT IN / NOT EXISTS。
-The optimizer makes intelligent decisions, based not only on the plan but also rich statistics available from the data sources and fine-grain costs for each operator such as io, cpu, network, and memory.
+优化器不仅基于计划，而且还基于可从数据源获得的丰富统计信息以及每个算子（例如 io，cpu，网络和内存）的细粒度成本来做出明智的决策。
-Advanced users may provide custom optimizations via a `CalciteConfig` object that can be provided to the table environment by calling `TableEnvironment#getConfig#setPlannerConfig`.
+高级用户可以通过 `CalciteConfig` 对象提供自定义优化，可以通过调用 `TableEnvironment＃getConfig＃setPlannerConfig` 将其提供给 TableEnvironment。
</div>
</div>
-### Explaining a Table
+### 解释表
-The Table API provides a mechanism to explain the logical and optimized query plans to compute a `Table`.
-This is done through the `TableEnvironment.explain(table)` method or `TableEnvironment.explain()` method. `explain(table)` returns the plan of a given `Table`. `explain()` returns the result of a multiple-sinks plan and is mainly used for the Blink planner. It returns a String describing three plans:
+Table API 提供了一种机制来解释计算`表`的逻辑和优化查询计划。
+这是通过 `TableEnvironment.explain(table)` 或者 `TableEnvironment.explain()` 完成的。`explain(table)` 返回给定`表`的计划。 `explain()` 返回多 sink 计划的结果并且主要用于 Blink 计划器。它返回一个描述三中计划的字符串：
Review comment:
三中计划 -> 三种计划
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] wuchong commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
wuchong commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-589505461
@CrazyTomatoOo could you resolve the conflict if you have time?
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382630228
##########
File path: docs/dev/table/common.zh.md
##########
@@ -288,53 +287,36 @@ b_b_t_env = BatchTableEnvironment.create(environment_settings=b_b_settings)
</div>
</div>
-**Note:** If there is only one planner jar in `/lib` directory, you can use `useAnyPlanner` (`use_any_planner` for python) to create specific `EnvironmentSettings`.
+**注释：** 如果`/lib`目录中只有一中计划器的 jar 包，则可以使用`useAnyPlanner`（python 使用 `use any_u_planner`）创建 `EnvironmentSettings`。
{% top %}
-Create Tables in the Catalog
+在 Catalog 中创建表
-------------------------------
-A `TableEnvironment` maintains a map of catalogs of tables which are created with an identifier. Each
-identifier consists of 3 parts: catalog name, database name and object name. If a catalog or database is not
-specified, the current default value will be used (see examples in the [Table identifier expanding](#table-identifier-expanding) section).
+`TableEnvironment` 维护着一个由标识符（identifier）创建的表 catalog 的映射。标识符由三个部分组成：catalog 名称、数据库名称以及对象名称。如果 catalog 或者数据库没有指明，就会使用当前默认值（参见[表标识符扩展](#table-identifier-expanding)章节中的例子）。
Review comment:
`TableEnvironment` 维护着一个由标识符（identifier）创建的表 catalog 的映射 ->
`TableEnvironment` 维护着一个用标识符（identifier）创建的表到 catalog 的映射
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] wuchong commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
wuchong commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-589505409
Hi @libenchao , could you help to review this?
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382566507
##########
File path: docs/dev/table/common.zh.md
##########
@@ -22,28 +22,28 @@ specific language governing permissions and limitations
under the License.
-->
-The Table API and SQL are integrated in a joint API. The central concept of this API is a `Table` which serves as input and output of queries. This document shows the common structure of programs with Table API and SQL queries, how to register a `Table`, how to query a `Table`, and how to emit a `Table`.
+Table API 和 SQL 集成在同一套 API 中。这套 API 的核心概念是`表（Table）`，用作查询的输入和输出。本文介绍了 Table API 和 SQL 查询程序的通用结构、如何注册`表`、如何查询`表`以及如何发出`表`。
Review comment:
"发出表" sounds a little wierd, how about ”输出表“ ？
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382672367
##########
File path: docs/dev/table/common.zh.md
##########
@@ -1191,9 +1170,9 @@ val table: Table = tableEnv.fromDataStream(stream, '_2 as 'myInt, '_1 as 'myLong
</div>
</div>
-#### Atomic Types
+#### 原子类型
-Flink treats primitives (`Integer`, `Double`, `String`) or generic types (types that cannot be analyzed and decomposed) as atomic types. A `DataStream` or `DataSet` of an atomic type is converted into a `Table` with a single attribute. The type of the attribute is inferred from the atomic type and the name of the attribute can be specified.
+Flink 将原始数据类型（`Integer`、`Double`、`String`）或者通用数据类型（不可再拆分的数据类型）视为原子类型。原子类型的`流数据集`或者`批数据集`会被转换成只有一条属性的`表`。属性的数据类型可以由原子类型推断出，还可以重新命名属性。
Review comment:
prefer “基础类型” to “原始类型”
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382627761
##########
File path: docs/dev/table/common.zh.md
##########
@@ -123,30 +123,29 @@ table_env.execute("python_job")
</div>
</div>
-**Note:** Table API and SQL queries can be easily integrated with and embedded into DataStream or DataSet programs. Have a look at the [Integration with DataStream and DataSet API](#integration-with-datastream-and-dataset-api) section to learn how DataStreams and DataSets can be converted into Tables and vice versa.
+**注释：** Table API 和 SQL 查询可以很容易地集成并嵌入到流处理或批处理程序中。 请参阅[与 DataStream 和 DataSet API 结合](#integration-with-datastream-and-dataset-api) 章节了解如何将数据流和数据集与表之间的相互转化。
{% top %}
-Create a TableEnvironment
+创建 TableEnvironment
-------------------------
-The `TableEnvironment` is a central concept of the Table API and SQL integration. It is responsible for:
+`TableEnvironment` 是 Table API 和 SQL 的核心概念。它负责:
-* Registering a `Table` in the internal catalog
-* Registering catalogs
-* Loading pluggable modules
-* Executing SQL queries
-* Registering a user-defined (scalar, table, or aggregation) function
-* Converting a `DataStream` or `DataSet` into a `Table`
-* Holding a reference to an `ExecutionEnvironment` or `StreamExecutionEnvironment`
+* 在内部的 catalog 中注册`表`
+* 注册外部的 catalog
+* 执行 SQL 查询
+* 注册自定义函数 （scalar、table 或 aggregation）
+* 将`流数据集`或`批数据集`转换成`表`
+* 引用 `ExecutionEnvironment` 或 `StreamExecutionEnvironment`
-A `Table` is always bound to a specific `TableEnvironment`. It is not possible to combine tables of different TableEnvironments in the same query, e.g., to join or union them.
+`表`总是与确定的 `TableEnvironment` 绑定。不能在同一条查询中使用不同 TableEnvironment 中的表，例如，对它们进行 join 或 union 操作。
-A `TableEnvironment` is created by calling the static `BatchTableEnvironment.create()` or `StreamTableEnvironment.create()` method with a `StreamExecutionEnvironment` or an `ExecutionEnvironment` and an optional `TableConfig`. The `TableConfig` can be used to configure the `TableEnvironment` or to customize the query optimization and translation process (see [Query Optimization](#query-optimization)).
+`TableEnvironment` 可以通过静态方法 `BatchTableEnvironment.create()` 或者 `StreamTableEnvironment.create()` 在 `StreamExecutionEnvironment` 或者 `ExecutionEnvironment` 中创建，`TableConfig` 是可选项。`TableConfig`可用于配置`TableEnvironment`或自定义查询优化和转换过程(参见 [查询优化](#query-optimization))。
-Make sure to choose the specific planner `BatchTableEnvironment`/`StreamTableEnvironment` that matches your programming language.
+请确保选择与你的编程语言匹配的确定的计划器`BatchTableEnvironment`/`StreamTableEnvironment`。
Review comment:
确定的 -> 特定的
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382665518
##########
File path: docs/dev/table/common.zh.md
##########
@@ -827,70 +806,70 @@ result.insert_into("CsvSinkTable")
{% top %}
-Translate and Execute a Query
+解析与执行查询
Review comment:
how about “翻译” ？
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382625212
##########
File path: docs/dev/table/common.zh.md
##########
@@ -123,30 +123,29 @@ table_env.execute("python_job")
</div>
</div>
-**Note:** Table API and SQL queries can be easily integrated with and embedded into DataStream or DataSet programs. Have a look at the [Integration with DataStream and DataSet API](#integration-with-datastream-and-dataset-api) section to learn how DataStreams and DataSets can be converted into Tables and vice versa.
+**注释：** Table API 和 SQL 查询可以很容易地集成并嵌入到流处理或批处理程序中。 请参阅[与 DataStream 和 DataSet API 结合](#integration-with-datastream-and-dataset-api) 章节了解如何将数据流和数据集与表之间的相互转化。
{% top %}
-Create a TableEnvironment
+创建 TableEnvironment
-------------------------
-The `TableEnvironment` is a central concept of the Table API and SQL integration. It is responsible for:
+`TableEnvironment` 是 Table API 和 SQL 的核心概念。它负责:
-* Registering a `Table` in the internal catalog
-* Registering catalogs
-* Loading pluggable modules
-* Executing SQL queries
-* Registering a user-defined (scalar, table, or aggregation) function
-* Converting a `DataStream` or `DataSet` into a `Table`
-* Holding a reference to an `ExecutionEnvironment` or `StreamExecutionEnvironment`
+* 在内部的 catalog 中注册`表`
+* 注册外部的 catalog
+* 执行 SQL 查询
+* 注册自定义函数 （scalar、table 或 aggregation）
+* 将`流数据集`或`批数据集`转换成`表`
+* 引用 `ExecutionEnvironment` 或 `StreamExecutionEnvironment`
-A `Table` is always bound to a specific `TableEnvironment`. It is not possible to combine tables of different TableEnvironments in the same query, e.g., to join or union them.
+`表`总是与确定的 `TableEnvironment` 绑定。不能在同一条查询中使用不同 TableEnvironment 中的表，例如，对它们进行 join 或 union 操作。
Review comment:
确定的 `TableEnvironment` -> 特定的`TableEnvironment` or 某个特定的 `TableEnvironment`
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382633331
##########
File path: docs/dev/table/common.zh.md
##########
@@ -288,53 +287,36 @@ b_b_t_env = BatchTableEnvironment.create(environment_settings=b_b_settings)
</div>
</div>
-**Note:** If there is only one planner jar in `/lib` directory, you can use `useAnyPlanner` (`use_any_planner` for python) to create specific `EnvironmentSettings`.
+**注释：** 如果`/lib`目录中只有一中计划器的 jar 包，则可以使用`useAnyPlanner`（python 使用 `use any_u_planner`）创建 `EnvironmentSettings`。
{% top %}
-Create Tables in the Catalog
+在 Catalog 中创建表
-------------------------------
-A `TableEnvironment` maintains a map of catalogs of tables which are created with an identifier. Each
-identifier consists of 3 parts: catalog name, database name and object name. If a catalog or database is not
-specified, the current default value will be used (see examples in the [Table identifier expanding](#table-identifier-expanding) section).
+`TableEnvironment` 维护着一个由标识符（identifier）创建的表 catalog 的映射。标识符由三个部分组成：catalog 名称、数据库名称以及对象名称。如果 catalog 或者数据库没有指明，就会使用当前默认值（参见[表标识符扩展](#table-identifier-expanding)章节中的例子）。
-Tables can be either virtual (`VIEWS`) or regular (`TABLES`). `VIEWS` can be created from an
-existing `Table` object, usually the result of a Table API or SQL query. `TABLES` describe
-external data, such as a file, database table, or message queue.
+表可以使虚拟的（`视图（VIEW）`）也可以是常规的（`表（TABLES）`）。`视图`可以从已经存在的``表中创建，一般是 Tbale API 或者 SQL 的查询结果。`表`记录外部数据，例如文件、数据库表或者消息队列。
-### Temporary vs Permanent tables.
+### 零时表（Temporary Table）和永久表（Permanent Table）
-Tables may either be temporary, and tied to the lifecycle of a single Flink session, or permanent,
-and visible across multiple Flink sessions and clusters.
+表可以是临时的，并与单个 Flink 会话（session）的生命周期相关，也可以是永久的，并且在多个 Flink 会话和群集（cluster）中可见。
-Permanent tables require a [catalog]({{ site.baseurl }}/dev/table/catalogs.html) (such as Hive Metastore)
-to maintain metadata about the table. Once a permanent table is created, it is visible to any Flink
-session that is connected to the catalog and will continue to exist until the table is explicitly
-dropped.
+永久表需要 [catalog]({{ site.baseurl }}/zh/dev/table/catalogs.html)（例如 Hive Metastore）以维护表的元数据。一旦永久表被创建，它将对任何连接到 catalog 的 Flink 会话可见且持续存在，直至表明确删除。
-On the other hand, temporary tables are always stored in memory and only exist for the duration of
-the Flink session they are created within. These tables are not visible to other sessions. They are
-not bound to any catalog or database but can be created in the namespace of one. Temporary tables
-are not dropped if their corresponding database is removed.
+另一方面，零时表通常保存于内存中并且仅在创建它们的 Flink 会话持续期间存在。这些表对于其它会话是不可见的。它们不与任何 catalog 或者数据库绑定但可以在一个命名空间（namespace）中创建。即使它们对应的数据库被删除，零时表也不会被删除。
Review comment:
+n for the next sections.
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
Hash:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Status:UNKNOWN URL:TBD TriggerType:PUSH TriggerID:6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b
-->
## CI report:
* 6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b 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
With regards,
Apache Git Services
[GitHub] [flink] flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-572897310
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "SUCCESS",
"url" : "https://travis-ci.com/flink-ci/flink/builds/143846846",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246",
"triggerID" : "6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
}, {
"hash" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"status" : "FAILURE",
"url" : "https://travis-ci.com/flink-ci/flink/builds/144680093",
"triggerID" : "0951428e2212abfe79d25d03dd8441a0ecd374d8",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 6a9eb6f6b70dc406a0c2285da4b02b17a18e4c7b Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/143846846) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4246)
* 0951428e2212abfe79d25d03dd8441a0ecd374d8 Travis: [FAILURE](https://travis-ci.com/flink-ci/flink/builds/144680093) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=4389)
<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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382662708
##########
File path: docs/dev/table/common.zh.md
##########
@@ -723,27 +702,27 @@ table_env.sql_update(
{% top %}
-### Mixing Table API and SQL
+### 混用 Table API 和 SQL
-Table API and SQL queries can be easily mixed because both return `Table` objects:
+Table API 和 SQL 查询的混用非常简单因为它们都返回 `Table` 对象：
-* A Table API query can be defined on the `Table` object returned by a SQL query.
-* A SQL query can be defined on the result of a Table API query by [registering the resulting Table](#register-a-table) in the `TableEnvironment` and referencing it in the `FROM` clause of the SQL query.
+* 可以在 SQL 查询返回的 `Table` 对象上定义 Table API 查询。
+* 通过在 `TableEnvironment` 中注册[结果表](#register-a-table)并在 SQL 查询的 `FROM` 子句中引用它，可以在 Table API 查询的结果上定义 SQL 查询。
{% top %}
-Emit a Table
+发出表
Review comment:
how about "输出表" ?
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382674428
##########
File path: docs/dev/table/common.zh.md
##########
@@ -1406,54 +1385,54 @@ val table: Table = tableEnv.fromDataStream(stream, 'name as 'myName)
{% top %}
-Query Optimization
+查询优化
------------------
<div class="codetabs" markdown="1">
<div data-lang="Old planner" markdown="1">
-Apache Flink leverages Apache Calcite to optimize and translate queries. The optimization currently performed include projection and filter push-down, subquery decorrelation, and other kinds of query rewriting. Old planner does not yet optimize the order of joins, but executes them in the same order as defined in the query (order of Tables in the `FROM` clause and/or order of join predicates in the `WHERE` clause).
+Apache Flink 利用 Apache Calcite 来优化和解析查询。当前执行的优化包括投影和过滤器下推，子查询去相关以及其他类型的查询重写。原版计划程序尚未优化 join 的顺序，而是按照查询中定义的顺序执行它们（FROM 子句中的表顺序和/或 WHERE 子句中的 join 谓词顺序）。
-It is possible to tweak the set of optimization rules which are applied in different phases by providing a `CalciteConfig` object. This can be created via a builder by calling `CalciteConfig.createBuilder())` and is provided to the TableEnvironment by calling `tableEnv.getConfig.setPlannerConfig(calciteConfig)`.
+通过提供一个 `CalciteConfig` 对象，可以调整在不同阶段应用的优化规则集合。这个对象可以通过调用构造器 `CalciteConfig.createBuilder()` 创建，并通过调用 `tableEnv.getConfig.setPlannerConfig(calciteConfig)` 提供给 TableEnvironment。
</div>
<div data-lang="Blink planner" markdown="1">
-Apache Flink leverages and extends Apache Calcite to perform sophisticated query optimization.
-This includes a series of rule and cost-based optimizations such as:
+Apache Flink 使用并扩展了 Apache Calcite 来执行复杂的查询优化。
+这包括一系列基于规则和成本的优化，例如：
-* Subquery decorrelation based on Apache Calcite
-* Project pruning
-* Partition pruning
-* Filter push-down
-* Sub-plan deduplication to avoid duplicate computation
-* Special subquery rewriting, including two parts:
- * Converts IN and EXISTS into left semi-joins
- * Converts NOT IN and NOT EXISTS into left anti-join
-* Optional join reordering
- * Enabled via `table.optimizer.join-reorder-enabled`
+* 基于 Apache Calcite 的子查询解相关
+* 模型剪枝
Review comment:
how about 投影剪裁?
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] CrazyTomatoOo commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
CrazyTomatoOo commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-590038158
@libenchao thanks for your advise, I will revise it as soon as possible.
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] CrazyTomatoOo commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
CrazyTomatoOo commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-593414085
@libenchao, finished.
----------------------------------------------------------------
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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on issue #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#issuecomment-593431166
LGTM. +1 for merging. @CrazyTomatoOo let's wait for a committer to 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
With regards,
Apache Git Services
[GitHub] [flink] libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
Posted by GitBox <gi...@apache.org>.
libenchao commented on a change in pull request #10822: [FLINK-15081][docs-zh]Translate "Concepts & Common API" page of Table…
URL: https://github.com/apache/flink/pull/10822#discussion_r382575969
##########
File path: docs/dev/table/common.zh.md
##########
@@ -123,30 +123,29 @@ table_env.execute("python_job")
</div>
</div>
-**Note:** Table API and SQL queries can be easily integrated with and embedded into DataStream or DataSet programs. Have a look at the [Integration with DataStream and DataSet API](#integration-with-datastream-and-dataset-api) section to learn how DataStreams and DataSets can be converted into Tables and vice versa.
+**注释：** Table API 和 SQL 查询可以很容易地集成并嵌入到流处理或批处理程序中。 请参阅[与 DataStream 和 DataSet API 结合](#integration-with-datastream-and-dataset-api) 章节了解如何将数据流和数据集与表之间的相互转化。
{% top %}
-Create a TableEnvironment
+创建 TableEnvironment
-------------------------
-The `TableEnvironment` is a central concept of the Table API and SQL integration. It is responsible for:
+`TableEnvironment` 是 Table API 和 SQL 的核心概念。它负责:
-* Registering a `Table` in the internal catalog
-* Registering catalogs
-* Loading pluggable modules
Review comment:
`Loading pluggable modules` is missing.
----------------------------------------------------------------
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
With regards,
Apache Git Services