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/02/23 05:22:01 UTC
[GitHub] [flink] gauss1314 opened a new pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
gauss1314 opened a new pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190
## What is the purpose of the change
This pull request translates "Data Type" page of "Table API & SQL" into Chinese.
## Verifying this change
This change is a trivial rework / code cleanup without any test coverage.
## Does this pull request potentially affect one of the following parts:
- Dependencies (does it add or upgrade a dependency): (no)
- The public API, i.e., is any changed class annotated with `@Public(Evolving)`: (no)
- The serializers: (no)
- The runtime per-record code paths (performance sensitive): (no)
- Anything that affects deployment or recovery: JobManager (and its components), Checkpointing, Kubernetes/Yarn/Mesos, ZooKeeper: (no)
- The S3 file system connector: (no)
## Documentation
- Does this pull request introduce a new feature? (no)
- If yes, how is the feature documented? (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] flinkbot edited a comment on issue #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590057584
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "PENDING",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150192641",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* bd237945580c716a1dfef091d6283cc3df43d1df Travis: [PENDING](https://travis-ci.com/flink-ci/flink/builds/150192641) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477)
<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] danny0405 commented on a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
danny0405 commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r383753317
##########
File path: docs/dev/table/types.zh.md
##########
@@ -22,62 +22,47 @@ specific language governing permissions and limitations
under the License.
-->
-Due to historical reasons, before Flink 1.9, Flink's Table & SQL API data types were
-tightly coupled to Flink's `TypeInformation`. `TypeInformation` is used in the DataStream
-and DataSet API and is sufficient to describe all information needed to serialize and
-deserialize JVM-based objects in a distributed setting.
+由于历史原因，在 Flink 1.9 之前，Flink Table & SQL API 的数据类型与 Flink 的 `TypeInformation` 耦合紧密。`TypeInformation` 在 DataStream 和 DataSet API 中被使用，并且大量地用于描述分布式环境中 JVM 对象的序列化和反序列化操作所需的全部信息。
-However, `TypeInformation` was not designed to represent logical types independent of
-an actual JVM class. In the past, it was difficult to map SQL standard types to this
-abstraction. Furthermore, some types were not SQL-compliant and introduced without a
-bigger picture in mind.
+然而,`TypeInformation` 并不是被设计为表示独立于 JVM 类型的逻辑类型。之前很难将 SQL 的标准类型和这种抽象逻辑类型之间建立映射。此外，有一些类型并不是兼容 SQL 的并且在没有更好的规划的时候被引进。
-Starting with Flink 1.9, the Table & SQL API will receive a new type system that serves as a long-term
-solution for API stability and standard compliance.
+从 Flink 1.9 开始，Table & SQL API 将接收一种新的类型系统，作为维护 API 稳定性和标准符合性的长期解决方案。
-Reworking the type system is a major effort that touches almost all user-facing interfaces. Therefore, its
-introduction spans multiple releases, and the community aims to finish this effort by Flink 1.10.
+重新设计类型系统是一项涉及几乎所有的面向用户接口的重大工作。因此，它的引入跨越多个版本，社区的目标是在 Flink 1.10 完成这项工作。
-Due to the simultaneous addition of a new planner for table programs (see [FLINK-11439](https://issues.apache.org/jira/browse/FLINK-11439)),
-not every combination of planner and data type is supported. Furthermore, planners might not support every
-data type with the desired precision or parameter.
+同时由于为 Table 编程添加了新的 Planner（见 [FLINK-11439](https://issues.apache.org/jira/browse/FLINK-11439)）, 因此并不支持新旧 Planner 和数据类型的全部组合。此外，这些 Planner 可能不会支持每一个数据类型所需的精度或参数。
-<span class="label label-danger">Attention</span> Please see the planner compatibility table and limitations
-section before using a data type.
+<span class="label label-danger">注意</span> 在使用数据类型之前请参阅 Planner 的兼容性表和局限性章节。
* This will be replaced by the TOC
{:toc}
-Data Type
+数据类型
---------
-A *data type* describes the logical type of a value in the table ecosystem. It can be used to declare input and/or
-output types of operations.
+*数据类型* 描述 Table 编程环境中的值的逻辑类型。它可以被用来声明操作的输入输出类型。
-Flink's data types are similar to the SQL standard's *data type* terminology but also contain information
-about the nullability of a value for efficient handling of scalar expressions.
+Flink 的数据类型和 SQL 标准的 *数据类型* 术语类似，但也包含有关可空值的信息，以便有效地处理标量表达式（Scalar Expressions）。
-Examples of data types are:
+数据类型的示例:
- `INT`
- `INT NOT NULL`
- `INTERVAL DAY TO SECOND(3)`
- `ROW<myField ARRAY<BOOLEAN>, myOtherField TIMESTAMP(3)>`
-A list of all pre-defined data types can be found [below](#list-of-data-types).
+全部的预定义数据类型见[下面](#数据类型列表)列表。
-### Data Types in the Table API
+### Table API 的数据类型
-Users of the JVM-based API work with instances of `org.apache.flink.table.types.DataType` within the Table API or when
-defining connectors, catalogs, or user-defined functions.
+JVM API 的用户可以在 Table API 中使用 `org.apache.flink.table.types.DataType` 的实例，以及定义连接器（Connector）、Catalog 或者用户自定义函数（User-Defined Function）。
-A `DataType` instance has two responsibilities:
-- **Declaration of a logical type** which does not imply a concrete physical representation for transmission
-or storage but defines the boundaries between JVM-based languages and the table ecosystem.
-- *Optional:* **Giving hints about the physical representation of data to the planner** which is useful at the edges to other APIs .
+一个 `DataType` 实例有两个作用：
+- **逻辑类型的声明**，它并不表示传输或存储的具体物理含义，但是定义了基于 JVM 的语言和 Table 编程环境之间的边界。
+- *可选的：* **向 Planner 提供有关数据的物理表示的提示**，这对于其他 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] danny0405 commented on a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
danny0405 commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r383755602
##########
File path: docs/dev/table/types.zh.md
##########
@@ -174,76 +149,71 @@ For the *Data Type Representation* column the table omits the prefix `org.apache
| `FLOAT()` | `FLOAT` | `FLOAT()` | |
| `DOUBLE()` | `DOUBLE` | `DOUBLE()` | |
| `ROW(...)` | `ROW<...>` | `ROW(...)` | |
-| `BIG_DEC()` | `DECIMAL` | [`DECIMAL()`] | Not a 1:1 mapping as precision and scale are ignored and Java's variable precision and scale are used. |
+| `BIG_DEC()` | `DECIMAL` | [`DECIMAL()`] | 不是 1:1 的映射，因为精度和小数位被忽略，Java 的可变精度和小数位被使用。 |
| `SQL_DATE()` | `SQL_DATE` | `DATE()`<br>`.bridgedTo(java.sql.Date.class)` | |
| `SQL_TIME()` | `SQL_TIME` | `TIME(0)`<br>`.bridgedTo(java.sql.Time.class)` | |
| `SQL_TIMESTAMP()` | `SQL_TIMESTAMP` | `TIMESTAMP(3)`<br>`.bridgedTo(java.sql.Timestamp.class)` | |
| `INTERVAL_MONTHS()` | `INTERVAL_MONTHS` | `INTERVAL(MONTH())`<br>`.bridgedTo(Integer.class)` | |
| `INTERVAL_MILLIS()` | `INTERVAL_MILLIS` | `INTERVAL(DataTypes.SECOND(3))`<br>`.bridgedTo(Long.class)` | |
-| `PRIMITIVE_ARRAY(...)` | `PRIMITIVE_ARRAY<...>` | `ARRAY(DATATYPE.notNull()`<br>`.bridgedTo(PRIMITIVE.class))` | Applies to all JVM primitive types except for `byte`. |
+| `PRIMITIVE_ARRAY(...)` | `PRIMITIVE_ARRAY<...>` | `ARRAY(DATATYPE.notNull()`<br>`.bridgedTo(PRIMITIVE.class))` | 应用于除 `byte` 外的全部 JVM 基本数据类型。 |
| `PRIMITIVE_ARRAY(BYTE())` | `PRIMITIVE_ARRAY<BYTE>` | `BYTES()` | |
| `OBJECT_ARRAY(...)` | `OBJECT_ARRAY<...>` | `ARRAY(`<br>`DATATYPE.bridgedTo(OBJECT.class))` | |
| `MULTISET(...)` | | `MULTISET(...)` | |
| `MAP(..., ...)` | `MAP<...,...>` | `MAP(...)` | |
-| other generic types | | `RAW(...)` | |
+| 其他通用类型 | | `RAW(...)` | |
-<span class="label label-danger">Attention</span> If there is a problem with the new type system. Users
-can fallback to type information defined in `org.apache.flink.table.api.Types` at any time.
+<span class="label label-danger">注意</span> 如果对于新的类型系统有任何疑问，用户可以在任何时候针对类型信息的定义 `org.apache.flink.table.api.Types` 进行反馈。
Review comment:
用户可以在任何时候针对类型信息的定义 -》用户可以随时切换到 `org.apache.flink.table.api.Types` 中定义的 type information。
----------------------------------------------------------------
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] danny0405 commented on a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
danny0405 commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r383747515
##########
File path: docs/dev/table/types.zh.md
##########
@@ -22,62 +22,47 @@ specific language governing permissions and limitations
under the License.
-->
-Due to historical reasons, before Flink 1.9, Flink's Table & SQL API data types were
-tightly coupled to Flink's `TypeInformation`. `TypeInformation` is used in the DataStream
-and DataSet API and is sufficient to describe all information needed to serialize and
-deserialize JVM-based objects in a distributed setting.
+由于历史原因，在 Flink 1.9 之前，Flink Table & SQL API 的数据类型与 Flink 的 `TypeInformation` 耦合紧密。`TypeInformation` 在 DataStream 和 DataSet API 中被使用，并且大量地用于描述分布式环境中 JVM 对象的序列化和反序列化操作所需的全部信息。
-However, `TypeInformation` was not designed to represent logical types independent of
-an actual JVM class. In the past, it was difficult to map SQL standard types to this
-abstraction. Furthermore, some types were not SQL-compliant and introduced without a
-bigger picture in mind.
+然而,`TypeInformation` 并不是被设计为表示独立于 JVM 类型的逻辑类型。之前很难将 SQL 的标准类型和这种抽象逻辑类型之间建立映射。此外，有一些类型并不是兼容 SQL 的并且在没有更好的规划的时候被引进。
Review comment:
- JVM 类型 -> JVM class
- SQL 的标准类型映射到 `TypeInformation` 抽象
----------------------------------------------------------------
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 #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590057584
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150192641",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "4eca602c7abec86fddbf098991740a9c050d7e4d",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "4eca602c7abec86fddbf098991740a9c050d7e4d",
"triggerType" : "PUSH"
}, {
"hash" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"status" : "SUCCESS",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150454263",
"triggerID" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"triggerType" : "PUSH"
}, {
"hash" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5565",
"triggerID" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 4eca602c7abec86fddbf098991740a9c050d7e4d UNKNOWN
* a4473ff63b42dea26f49615d58f056b5939e52cb Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/150454263) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5565)
<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 #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590057584
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "SUCCESS",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150192641",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "4eca602c7abec86fddbf098991740a9c050d7e4d",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "4eca602c7abec86fddbf098991740a9c050d7e4d",
"triggerType" : "PUSH"
}, {
"hash" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* bd237945580c716a1dfef091d6283cc3df43d1df Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/150192641) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477)
* 4eca602c7abec86fddbf098991740a9c050d7e4d UNKNOWN
* a4473ff63b42dea26f49615d58f056b5939e52cb 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] wuchong commented on a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
wuchong commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r388067901
##########
File path: docs/dev/table/types.zh.md
##########
@@ -22,62 +22,47 @@ specific language governing permissions and limitations
under the License.
-->
-Due to historical reasons, before Flink 1.9, Flink's Table & SQL API data types were
-tightly coupled to Flink's `TypeInformation`. `TypeInformation` is used in the DataStream
-and DataSet API and is sufficient to describe all information needed to serialize and
-deserialize JVM-based objects in a distributed setting.
+由于历史原因，在 Flink 1.9 之前，Flink Table & SQL API 的数据类型与 Flink 的 `TypeInformation` 耦合紧密。`TypeInformation` 在 DataStream 和 DataSet API 中被使用，并且足以用来用于描述分布式环境中 JVM 对象的序列化和反序列化操作所需的全部信息。
-However, `TypeInformation` was not designed to represent logical types independent of
-an actual JVM class. In the past, it was difficult to map SQL standard types to this
-abstraction. Furthermore, some types were not SQL-compliant and introduced without a
-bigger picture in mind.
+然而,`TypeInformation` 并不是被设计为表示独立于 JVM class 的逻辑类型。之前很难将 SQL 的标准类型映射到 `TypeInformation` 抽象。此外，有一些类型并不是兼容 SQL 的并且在没有更好的规划的时候被引进。
-Starting with Flink 1.9, the Table & SQL API will receive a new type system that serves as a long-term
-solution for API stability and standard compliance.
+从 Flink 1.9 开始，Table & SQL API 将接收一种新的类型系统作为长期解决方案，用来保持 API 稳定性和 SQL 标准的兼容性。
-Reworking the type system is a major effort that touches almost all user-facing interfaces. Therefore, its
-introduction spans multiple releases, and the community aims to finish this effort by Flink 1.10.
+重新设计类型系统是一项涉及几乎所有的面向用户接口的重大工作。因此，它的引入跨越多个版本，社区的目标是在 Flink 1.10 完成这项工作。
-Due to the simultaneous addition of a new planner for table programs (see [FLINK-11439](https://issues.apache.org/jira/browse/FLINK-11439)),
-not every combination of planner and data type is supported. Furthermore, planners might not support every
-data type with the desired precision or parameter.
+同时由于为 Table 编程添加了新的 Planner 详见（[FLINK-11439](https://issues.apache.org/jira/browse/FLINK-11439)）, 并不是每种 Planner 都支持所有的数据类型。此外,Planner 对于数据类型的精度和参数化支持也可能是不完整的。
-<span class="label label-danger">Attention</span> Please see the planner compatibility table and limitations
-section before using a data type.
+<span class="label label-danger">注意</span> 在使用数据类型之前请参阅 Planner 的兼容性表和局限性章节。
* This will be replaced by the TOC
{:toc}
-Data Type
+数据类型
---------
-A *data type* describes the logical type of a value in the table ecosystem. It can be used to declare input and/or
-output types of operations.
+*数据类型* 描述 Table 编程环境中的值的逻辑类型。它可以被用来声明操作的输入输出类型。
-Flink's data types are similar to the SQL standard's *data type* terminology but also contain information
-about the nullability of a value for efficient handling of scalar expressions.
+Flink 的数据类型和 SQL 标准的 *数据类型* 术语类似，但也包含了 nullability 信息，可以被用于 scala expression 的优化。
Review comment:
```suggestion
Flink 的数据类型和 SQL 标准的 *数据类型* 术语类似，但也包含了可空属性，可以被用于标量表达式（scalar expression）的优化。
```
----------------------------------------------------------------
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 a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
wuchong commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r388065541
##########
File path: docs/dev/table/types.zh.md
##########
@@ -22,62 +22,47 @@ specific language governing permissions and limitations
under the License.
-->
-Due to historical reasons, before Flink 1.9, Flink's Table & SQL API data types were
-tightly coupled to Flink's `TypeInformation`. `TypeInformation` is used in the DataStream
-and DataSet API and is sufficient to describe all information needed to serialize and
-deserialize JVM-based objects in a distributed setting.
+由于历史原因，在 Flink 1.9 之前，Flink Table & SQL API 的数据类型与 Flink 的 `TypeInformation` 耦合紧密。`TypeInformation` 在 DataStream 和 DataSet API 中被使用，并且足以用来用于描述分布式环境中 JVM 对象的序列化和反序列化操作所需的全部信息。
-However, `TypeInformation` was not designed to represent logical types independent of
-an actual JVM class. In the past, it was difficult to map SQL standard types to this
-abstraction. Furthermore, some types were not SQL-compliant and introduced without a
-bigger picture in mind.
+然而,`TypeInformation` 并不是被设计为表示独立于 JVM class 的逻辑类型。之前很难将 SQL 的标准类型映射到 `TypeInformation` 抽象。此外，有一些类型并不是兼容 SQL 的并且在没有更好的规划的时候被引进。
Review comment:
```suggestion
然而,`TypeInformation` 并不是为独立于 JVM class 的逻辑类型而设计的。之前很难将 SQL 的标准类型映射到 `TypeInformation` 抽象。此外，有一些类型并不是兼容 SQL 的并且引入的时候没有长远规划过。
```
----------------------------------------------------------------
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 #11190: [FLINK-16089][docs]
Translate "Data Type" page of "Table API & SQL" into Chinese
Posted by GitBox <gi...@apache.org>.
flinkbot commented on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590028903
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 bd237945580c716a1dfef091d6283cc3df43d1df (Sun Feb 23 05:25:09 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] danny0405 commented on a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
danny0405 commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r383765739
##########
File path: docs/dev/table/types.zh.md
##########
@@ -418,25 +383,21 @@ DataTypes.DECIMAL(p, s)
</div>
-The type can be declared using `DECIMAL(p, s)` where `p` is the number of digits in a
-number (*precision*) and `s` is the number of digits to the right of the decimal point
-in a number (*scale*). `p` must have a value between `1` and `38` (both inclusive). `s`
-must have a value between `0` and `p` (both inclusive). The default value for `p` is 10.
-The default value for `s` is `0`.
+此类型用 `DECIMAL(p, s)` 声明，其中 `p` 是数字的位数（*精度*），`s` 是数字中小数点右边的位数（*数量*）。`p` 的值必须介于 `1` 和 `38` 之间（含边界值）。`s` 的值必须介于 `0` 和 `p` 之间（含边界值）。其中 `p` 的缺省值是 `10`，`s` 的缺省值是 `0`。
Review comment:
scala -> 尾数
----------------------------------------------------------------
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] danny0405 commented on a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
danny0405 commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r383771025
##########
File path: docs/dev/table/types.zh.md
##########
@@ -878,40 +809,37 @@ DataTypes.INTERVAL(DataTypes.MONTH())
</div>
-The type can be declared using the above combinations where `p` is the number of digits of years
-(*year precision*). `p` must have a value between `1` and `4` (both inclusive). If no year precision
-is specified, `p` is equal to `2`.
+可以使用以上组合来声明类型，其中 `p` 是年数（*年精度*）的位数。`p` 的值必须介于 `1` 和之间 `4`（含边界值）。如果未指定年精度，`p` 则等于 `2`。
Review comment:
`1` 和之间 `4` ?
----------------------------------------------------------------
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 #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590057584
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "SUCCESS",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150192641",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "4eca602c7abec86fddbf098991740a9c050d7e4d",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "4eca602c7abec86fddbf098991740a9c050d7e4d",
"triggerType" : "PUSH"
}, {
"hash" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"status" : "PENDING",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150454263",
"triggerID" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* bd237945580c716a1dfef091d6283cc3df43d1df Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/150192641) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477)
* 4eca602c7abec86fddbf098991740a9c050d7e4d UNKNOWN
* a4473ff63b42dea26f49615d58f056b5939e52cb Travis: [PENDING](https://travis-ci.com/flink-ci/flink/builds/150454263)
<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 commented on issue #11190: [FLINK-16089][docs]
Translate "Data Type" page of "Table API & SQL" into Chinese
Posted by GitBox <gi...@apache.org>.
flinkbot commented on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590057584
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* bd237945580c716a1dfef091d6283cc3df43d1df 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 #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590057584
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "SUCCESS",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150192641",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "4eca602c7abec86fddbf098991740a9c050d7e4d",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "4eca602c7abec86fddbf098991740a9c050d7e4d",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* bd237945580c716a1dfef091d6283cc3df43d1df Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/150192641) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477)
* 4eca602c7abec86fddbf098991740a9c050d7e4d 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] danny0405 commented on a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
danny0405 commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r383749365
##########
File path: docs/dev/table/types.zh.md
##########
@@ -22,62 +22,47 @@ specific language governing permissions and limitations
under the License.
-->
-Due to historical reasons, before Flink 1.9, Flink's Table & SQL API data types were
-tightly coupled to Flink's `TypeInformation`. `TypeInformation` is used in the DataStream
-and DataSet API and is sufficient to describe all information needed to serialize and
-deserialize JVM-based objects in a distributed setting.
+由于历史原因，在 Flink 1.9 之前，Flink Table & SQL API 的数据类型与 Flink 的 `TypeInformation` 耦合紧密。`TypeInformation` 在 DataStream 和 DataSet API 中被使用，并且大量地用于描述分布式环境中 JVM 对象的序列化和反序列化操作所需的全部信息。
-However, `TypeInformation` was not designed to represent logical types independent of
-an actual JVM class. In the past, it was difficult to map SQL standard types to this
-abstraction. Furthermore, some types were not SQL-compliant and introduced without a
-bigger picture in mind.
+然而,`TypeInformation` 并不是被设计为表示独立于 JVM 类型的逻辑类型。之前很难将 SQL 的标准类型和这种抽象逻辑类型之间建立映射。此外，有一些类型并不是兼容 SQL 的并且在没有更好的规划的时候被引进。
-Starting with Flink 1.9, the Table & SQL API will receive a new type system that serves as a long-term
-solution for API stability and standard compliance.
+从 Flink 1.9 开始，Table & SQL API 将接收一种新的类型系统，作为维护 API 稳定性和标准符合性的长期解决方案。
Review comment:
作为维护 API 稳定性和标准符合性的长期解决方案 -》 解决方案 ... 用来保持 API 稳定性和 SQL 标准的兼容性
----------------------------------------------------------------
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 #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590057584
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "SUCCESS",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150192641",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* bd237945580c716a1dfef091d6283cc3df43d1df Travis: [SUCCESS](https://travis-ci.com/flink-ci/flink/builds/150192641) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477)
<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 #11190: [FLINK-16089][docs]
Translate "Data Type" page of "Table API & SQL" into Chinese
Posted by GitBox <gi...@apache.org>.
wuchong commented on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590061322
Hi @danny0405 , 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] danny0405 commented on issue #11190: [FLINK-16089][docs]
Translate "Data Type" page of "Table API & SQL" into Chinese
Posted by GitBox <gi...@apache.org>.
danny0405 commented on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590146367
@wuchong , sure, let me take the review work.
----------------------------------------------------------------
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] danny0405 commented on a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
danny0405 commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r383752075
##########
File path: docs/dev/table/types.zh.md
##########
@@ -22,62 +22,47 @@ specific language governing permissions and limitations
under the License.
-->
-Due to historical reasons, before Flink 1.9, Flink's Table & SQL API data types were
-tightly coupled to Flink's `TypeInformation`. `TypeInformation` is used in the DataStream
-and DataSet API and is sufficient to describe all information needed to serialize and
-deserialize JVM-based objects in a distributed setting.
+由于历史原因，在 Flink 1.9 之前，Flink Table & SQL API 的数据类型与 Flink 的 `TypeInformation` 耦合紧密。`TypeInformation` 在 DataStream 和 DataSet API 中被使用，并且大量地用于描述分布式环境中 JVM 对象的序列化和反序列化操作所需的全部信息。
-However, `TypeInformation` was not designed to represent logical types independent of
-an actual JVM class. In the past, it was difficult to map SQL standard types to this
-abstraction. Furthermore, some types were not SQL-compliant and introduced without a
-bigger picture in mind.
+然而,`TypeInformation` 并不是被设计为表示独立于 JVM 类型的逻辑类型。之前很难将 SQL 的标准类型和这种抽象逻辑类型之间建立映射。此外，有一些类型并不是兼容 SQL 的并且在没有更好的规划的时候被引进。
-Starting with Flink 1.9, the Table & SQL API will receive a new type system that serves as a long-term
-solution for API stability and standard compliance.
+从 Flink 1.9 开始，Table & SQL API 将接收一种新的类型系统，作为维护 API 稳定性和标准符合性的长期解决方案。
-Reworking the type system is a major effort that touches almost all user-facing interfaces. Therefore, its
-introduction spans multiple releases, and the community aims to finish this effort by Flink 1.10.
+重新设计类型系统是一项涉及几乎所有的面向用户接口的重大工作。因此，它的引入跨越多个版本，社区的目标是在 Flink 1.10 完成这项工作。
-Due to the simultaneous addition of a new planner for table programs (see [FLINK-11439](https://issues.apache.org/jira/browse/FLINK-11439)),
-not every combination of planner and data type is supported. Furthermore, planners might not support every
-data type with the desired precision or parameter.
+同时由于为 Table 编程添加了新的 Planner（见 [FLINK-11439](https://issues.apache.org/jira/browse/FLINK-11439)）, 因此并不支持新旧 Planner 和数据类型的全部组合。此外，这些 Planner 可能不会支持每一个数据类型所需的精度或参数。
-<span class="label label-danger">Attention</span> Please see the planner compatibility table and limitations
-section before using a data type.
+<span class="label label-danger">注意</span> 在使用数据类型之前请参阅 Planner 的兼容性表和局限性章节。
* This will be replaced by the TOC
{:toc}
-Data Type
+数据类型
---------
-A *data type* describes the logical type of a value in the table ecosystem. It can be used to declare input and/or
-output types of operations.
+*数据类型* 描述 Table 编程环境中的值的逻辑类型。它可以被用来声明操作的输入输出类型。
-Flink's data types are similar to the SQL standard's *data type* terminology but also contain information
-about the nullability of a value for efficient handling of scalar expressions.
+Flink 的数据类型和 SQL 标准的 *数据类型* 术语类似，但也包含有关可空值的信息，以便有效地处理标量表达式（Scalar Expressions）。
Review comment:
但也包含了 nullability 信息，可以被用于 scala expression 的优化。
----------------------------------------------------------------
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] danny0405 commented on a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
danny0405 commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r383751269
##########
File path: docs/dev/table/types.zh.md
##########
@@ -22,62 +22,47 @@ specific language governing permissions and limitations
under the License.
-->
-Due to historical reasons, before Flink 1.9, Flink's Table & SQL API data types were
-tightly coupled to Flink's `TypeInformation`. `TypeInformation` is used in the DataStream
-and DataSet API and is sufficient to describe all information needed to serialize and
-deserialize JVM-based objects in a distributed setting.
+由于历史原因，在 Flink 1.9 之前，Flink Table & SQL API 的数据类型与 Flink 的 `TypeInformation` 耦合紧密。`TypeInformation` 在 DataStream 和 DataSet API 中被使用，并且大量地用于描述分布式环境中 JVM 对象的序列化和反序列化操作所需的全部信息。
-However, `TypeInformation` was not designed to represent logical types independent of
-an actual JVM class. In the past, it was difficult to map SQL standard types to this
-abstraction. Furthermore, some types were not SQL-compliant and introduced without a
-bigger picture in mind.
+然而,`TypeInformation` 并不是被设计为表示独立于 JVM 类型的逻辑类型。之前很难将 SQL 的标准类型和这种抽象逻辑类型之间建立映射。此外，有一些类型并不是兼容 SQL 的并且在没有更好的规划的时候被引进。
-Starting with Flink 1.9, the Table & SQL API will receive a new type system that serves as a long-term
-solution for API stability and standard compliance.
+从 Flink 1.9 开始，Table & SQL API 将接收一种新的类型系统，作为维护 API 稳定性和标准符合性的长期解决方案。
-Reworking the type system is a major effort that touches almost all user-facing interfaces. Therefore, its
-introduction spans multiple releases, and the community aims to finish this effort by Flink 1.10.
+重新设计类型系统是一项涉及几乎所有的面向用户接口的重大工作。因此，它的引入跨越多个版本，社区的目标是在 Flink 1.10 完成这项工作。
-Due to the simultaneous addition of a new planner for table programs (see [FLINK-11439](https://issues.apache.org/jira/browse/FLINK-11439)),
-not every combination of planner and data type is supported. Furthermore, planners might not support every
-data type with the desired precision or parameter.
+同时由于为 Table 编程添加了新的 Planner（见 [FLINK-11439](https://issues.apache.org/jira/browse/FLINK-11439)）, 因此并不支持新旧 Planner 和数据类型的全部组合。此外，这些 Planner 可能不会支持每一个数据类型所需的精度或参数。
Review comment:
同时由于 Table 程序同时引入了新的 planner 详见 ...
- 并不是每种 Planner 都支持所有的数据类型。此外, 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] wuchong closed pull request #11190: [FLINK-16089][docs]
Translate "Data Type" page of "Table API & SQL" into Chinese
Posted by GitBox <gi...@apache.org>.
wuchong closed pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190
----------------------------------------------------------------
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] danny0405 commented on a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
danny0405 commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r383747027
##########
File path: docs/dev/table/types.zh.md
##########
@@ -22,62 +22,47 @@ specific language governing permissions and limitations
under the License.
-->
-Due to historical reasons, before Flink 1.9, Flink's Table & SQL API data types were
-tightly coupled to Flink's `TypeInformation`. `TypeInformation` is used in the DataStream
-and DataSet API and is sufficient to describe all information needed to serialize and
-deserialize JVM-based objects in a distributed setting.
+由于历史原因，在 Flink 1.9 之前，Flink Table & SQL API 的数据类型与 Flink 的 `TypeInformation` 耦合紧密。`TypeInformation` 在 DataStream 和 DataSet API 中被使用，并且大量地用于描述分布式环境中 JVM 对象的序列化和反序列化操作所需的全部信息。
Review comment:
is sufficient 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] flinkbot edited a comment on issue #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590057584
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "PENDING",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150192641",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* bd237945580c716a1dfef091d6283cc3df43d1df Travis: [PENDING](https://travis-ci.com/flink-ci/flink/builds/150192641)
<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 #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on issue #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#issuecomment-590057584
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "DELETED",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150192641",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"status" : "DELETED",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5477",
"triggerID" : "bd237945580c716a1dfef091d6283cc3df43d1df",
"triggerType" : "PUSH"
}, {
"hash" : "4eca602c7abec86fddbf098991740a9c050d7e4d",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "4eca602c7abec86fddbf098991740a9c050d7e4d",
"triggerType" : "PUSH"
}, {
"hash" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"status" : "PENDING",
"url" : "https://travis-ci.com/flink-ci/flink/builds/150454263",
"triggerID" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"triggerType" : "PUSH"
}, {
"hash" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5565",
"triggerID" : "a4473ff63b42dea26f49615d58f056b5939e52cb",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 4eca602c7abec86fddbf098991740a9c050d7e4d UNKNOWN
* a4473ff63b42dea26f49615d58f056b5939e52cb Travis: [PENDING](https://travis-ci.com/flink-ci/flink/builds/150454263) Azure: [SUCCESS](https://dev.azure.com/rmetzger/5bd3ef0a-4359-41af-abca-811b04098d2e/_build/results?buildId=5565)
<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 a change in pull request #11190:
[FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into
Chinese
Posted by GitBox <gi...@apache.org>.
wuchong commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
URL: https://github.com/apache/flink/pull/11190#discussion_r388065763
##########
File path: docs/dev/table/types.zh.md
##########
@@ -22,62 +22,47 @@ specific language governing permissions and limitations
under the License.
-->
-Due to historical reasons, before Flink 1.9, Flink's Table & SQL API data types were
-tightly coupled to Flink's `TypeInformation`. `TypeInformation` is used in the DataStream
-and DataSet API and is sufficient to describe all information needed to serialize and
-deserialize JVM-based objects in a distributed setting.
+由于历史原因，在 Flink 1.9 之前，Flink Table & SQL API 的数据类型与 Flink 的 `TypeInformation` 耦合紧密。`TypeInformation` 在 DataStream 和 DataSet API 中被使用，并且足以用来用于描述分布式环境中 JVM 对象的序列化和反序列化操作所需的全部信息。
-However, `TypeInformation` was not designed to represent logical types independent of
-an actual JVM class. In the past, it was difficult to map SQL standard types to this
-abstraction. Furthermore, some types were not SQL-compliant and introduced without a
-bigger picture in mind.
+然而,`TypeInformation` 并不是被设计为表示独立于 JVM class 的逻辑类型。之前很难将 SQL 的标准类型映射到 `TypeInformation` 抽象。此外，有一些类型并不是兼容 SQL 的并且在没有更好的规划的时候被引进。
-Starting with Flink 1.9, the Table & SQL API will receive a new type system that serves as a long-term
-solution for API stability and standard compliance.
+从 Flink 1.9 开始，Table & SQL API 将接收一种新的类型系统作为长期解决方案，用来保持 API 稳定性和 SQL 标准的兼容性。
Review comment:
```suggestion
从 Flink 1.9 开始，Table & SQL API 开始启用一种新的类型系统作为长期解决方案，用来保持 API 稳定性和 SQL 标准的兼容性。
```
----------------------------------------------------------------
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