[GitHub] [flink] wuchong commented on a change in pull request #11190: [FLINK-16089][docs] Translate "Data Type" page of "Table API & SQL" into Chinese
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 对于数据类型的精度和参数化支持也可能是不完整的。
-Attention Please see the planner
compatibility table and limitations
-section before using a data type.
+注意 在使用数据类型之前请参阅 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:
us...@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
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: us...@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
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: us...@infra.apache.org With regards, Apache Git Services
