[FLINK-27291][docs-zh] Translate the "List of Data Types" section of "Data Types" into Chinese' #20724

coder-zjh · 2022-08-31T17:21:36Z

What is the purpose of the change

(For example: This pull request makes task deployment go through the blob server, rather than through RPC. That way we avoid re-transferring them on each deployment (during recovery).)

Brief change log

(for example:)

The TaskInfo is stored in the blob store on job creation time as a persistent artifact
Deployments RPC transmits only the blob storage reference
TaskManagers retrieve the TaskInfo from the blob cache

Verifying this change

Please make sure both new and modified tests in this PR follows the conventions defined in our code quality guide: https://flink.apache.org/contributing/code-style-and-quality-common.html#testing

(Please pick either of the following options)

This change is a trivial rework / code cleanup without any test coverage.

(or)

This change is already covered by existing tests, such as (please describe tests).

(or)

This change added tests and can be verified as follows:

(example:)

Added integration tests for end-to-end deployment with large payloads (100MB)
Extended integration test for recovery after master (JobManager) failure
Added test that validates that TaskInfo is transferred only once across recoveries
Manually verified the change by running a 4 node cluster with 2 JobManagers and 4 TaskManagers, a stateful streaming program, and killing one JobManager and two TaskManagers during the execution, verifying that recovery happens correctly.

Does this pull request potentially affect one of the following parts:

Dependencies (does it add or upgrade a dependency): (yes / no)
The public API, i.e., is any changed class annotated with @Public(Evolving): (yes / no)
The serializers: (yes / no / don't know)
The runtime per-record code paths (performance sensitive): (yes / no / don't know)
Anything that affects deployment or recovery: JobManager (and its components), Checkpointing, Kubernetes/Yarn, ZooKeeper: (yes / no / don't know)
The S3 file system connector: (yes / no / don't know)

Documentation

Does this pull request introduce a new feature? (yes / no)
If yes, how is the feature documented? (not applicable / docs / JavaDocs / not documented)

… "Data Types" in to Chinese

flinkbot · 2022-08-31T17:27:05Z

CI report:

dacaa9c Azure: FAILURE

Bot commands

The @flinkbot bot supports the following commands:

@flinkbot run azure re-run the last Azure build

ChengkaiYang2022 · 2022-09-01T04:43:22Z

.idea/vcs.xml

@@ -22,4 +22,4 @@
    <mapping directory="$PROJECT_DIR$" vcs="Git" />
    <mapping directory="$PROJECT_DIR$/docs/themes/book" vcs="Git" />
  </component>
-</project>
+</project>


Maybe we shouldn't change vcs.xml file?

Yes,I don't know when this file changed and I still committed it...

ChengkaiYang2022 · 2022-09-01T04:46:34Z

docs/content.zh/docs/dev/table/types.md

-
-The type can be declared using `CHAR(n)` where `n` is the number of code points. `n` must have a value between `1`
-and `2,147,483,647` (both inclusive). If no length is specified, `n` is equal to `1`.
+可以使用 `CHAR(n)` 声明该类型，其中n表示其长度，`n` 的取值范围为 `1` 到 `2,147,483,647` (包括两数在内) ，如果没有指定`n` 的值，n 等于 1。 


其中 n 表示其长度

There should be two spaces between Chinese characters and English characters.

ChengkaiYang2022 · 2022-09-01T04:53:18Z

Please change the title to '[FLINK-27291][docs-zh] Translate the "List of Data Types" section of "Data Types" in to Chinese'
and the git message should start with '[FLINK-27291][docs-zh]'.

ChengkaiYang2022

@coder-zjh Thanks for the contributions!

There are still some problems, mainly including space problems and grammatical problems, in the previous works. And I believe that they would be confusing for the users.

I left some comments before line 1180. Please take a look and it would be better if you help to polish the rest of the document.

ChengkaiYang2022 · 2022-09-02T13:07:20Z

docs/content.zh/docs/dev/table/types.md

 {{< tabs "datatypesimport" >}}
 {{< tab "Java/Scala" >}}
-For the JVM-based Table API those types are also available in `org.apache.flink.table.api.DataTypes`.
+Java/Scala Table API的数据类型详见： `org.apache.flink.table.api.DataTypes`.


API 的数据类型详见：

Space between English character and Chinese character.

ChengkaiYang2022 · 2022-09-02T13:09:01Z

docs/content.zh/docs/dev/table/types.md

@@ -333,11 +325,11 @@ DataTypes.VARBINARY(n)
 DataTypes.BYTES()
 ```

-**Bridging to JVM Types**
+**JVM Types桥接**


Space problems too.

ChengkaiYang2022 · 2022-09-02T13:09:39Z

docs/content.zh/docs/dev/table/types.md

@@ -444,10 +433,9 @@ DataTypes.TINYINT()
 {{< /tabs >}}

 #### `SMALLINT`
+2字节的有符号整数类型，存储`-32,768` 到 `32,767` 的整数。


Space problems too.

ChengkaiYang2022 · 2022-09-02T13:09:47Z

docs/content.zh/docs/dev/table/types.md

@@ -476,10 +464,9 @@ DataTypes.SMALLINT()
 {{< /tabs >}}

 #### `INT`
+4字节的有符号整数类型，存储 `-2,147,483,648` 到 `2,147,483,647` 的整数。


Space problems too.

ChengkaiYang2022 · 2022-09-02T13:15:15Z

docs/content.zh/docs/dev/table/types.md

-`t ARRAY` is a synonym for being closer to the SQL standard. For example, `INT ARRAY` is
-equivalent to `ARRAY<INT>`.
+可以使用 `ARRAY<t>` 声明类型，`t` 是其中元素的数据类型。。
+`t ARRAY` 是更接近 SQL 标准的同义词。 例如，`INT ARRAY` 是相当于`ARRAY<INT>`。


t ARRAY 是更接近 SQL 标准的同义词。例如，INT ARRAY 是相当于ARRAY。
->
为了更接近 SQL 标准，也可以使用 t ARRAY 的写法表达，比如，INT ARRAY 等同于 ARRAY。

ChengkaiYang2022 · 2022-09-02T13:35:43Z

docs/content.zh/docs/dev/table/types.md


-A row type is similar to the `STRUCT` type known from other non-standard-compliant frameworks.
+字段由字段名称、字段类型和可选描述组成。 最具体的类型 表的一行是行类型。 在这种情况下，行的每一列对应于字段 与列具有相同序号位置的行类型。


The previous work of the contributor is not clear enough.

ChengkaiYang2022 · 2022-09-02T13:39:35Z

docs/content.zh/docs/dev/table/types.md


-A row type is similar to the `STRUCT` type known from other non-standard-compliant frameworks.
+字段由字段名称、字段类型和可选描述组成。 最具体的类型 表的一行是行类型。 在这种情况下，行的每一列对应于字段 与列具有相同序号位置的行类型。
+与 SQL 标准相比，可选的字段描述简化了复杂的处理 结构。


与 SQL 标准相比，可选的字段描述可以简化复杂结构的处理过程。

ChengkaiYang2022 · 2022-09-02T13:40:25Z

docs/content.zh/docs/dev/table/types.md

-A row type is similar to the `STRUCT` type known from other non-standard-compliant frameworks.
+字段由字段名称、字段类型和可选描述组成。 最具体的类型 表的一行是行类型。 在这种情况下，行的每一列对应于字段 与列具有相同序号位置的行类型。
+与 SQL 标准相比，可选的字段描述简化了复杂的处理 结构。
+行类型类似于其他非标准兼容框架中已知的`STRUCT`类型。


Row 类型类似于其他非标准兼容框架中的 STRUCT 类型。

ChengkaiYang2022 · 2022-09-02T13:41:42Z

docs/content.zh/docs/dev/table/types.md


-`ROW(...)` is a synonym for being closer to the SQL standard. For example, `ROW(myField INT, myOtherField BOOLEAN)` is
-equivalent to `ROW<myField INT, myOtherField BOOLEAN>`.
+可以使用 `ROW<n0 t0 'd0', n1 t1 'd1', ...>` 声明类型，其中 `n` 是一个字段，`t`是字段的逻辑类型，`d`是字段的描述。


可以使用 ROW<n0 t0 'd0', n1 t1 'd1', ...> 声明类型，其中 n 代表一个字段，t 是字段的逻辑类型，d 是字段的描述。

ChengkaiYang2022 · 2022-09-02T13:42:43Z

docs/content.zh/docs/dev/table/types.md

-`ROW(...)` is a synonym for being closer to the SQL standard. For example, `ROW(myField INT, myOtherField BOOLEAN)` is
-equivalent to `ROW<myField INT, myOtherField BOOLEAN>`.
+可以使用 `ROW<n0 t0 'd0', n1 t1 'd1', ...>` 声明类型，其中 `n` 是一个字段，`t`是字段的逻辑类型，`d`是字段的描述。
+`ROW(...)` 是更接近 SQL 标准的同义词。 例如，`ROW(myField INT, myOtherField BOOLEAN)` 相当于`ROW<myField INT, myOtherField BOOLEAN>`。


ROW(...) 是为更接近 SQL 标准而使用的同义写法。例如，ROW(myField INT, myOtherField BOOLEAN) 等同于 ROW<myField INT, myOtherField BOOLEAN>。

kylemeow · 2022-09-14T03:32:15Z

docs/content.zh/docs/dev/table/types.md

 {{< /tab >}}
 {{< tab "Python" >}}
-For the Python Table API, those types are available in `pyflink.table.types.DataTypes`.
+Python Table API, 的数据类型详见： `pyflink.table.types.DataTypes`.


需要删除 API 后的逗号

Yes, i gonna fix it.

kylemeow · 2022-09-14T03:33:06Z

docs/content.zh/docs/dev/table/types.md

+| `FLOAT`          |                                       |
+| `DOUBLE`         |                                       |
+| `DATE`           |                                       |
+| `TIME`           | 仅支持到0.的精度。                            |


"仅支持到0.的精度" -> "仅支持精度为 0"

line 153: comma problem line 176: confusing translation

into datatypes-translate

cason0126 and others added 2 commits June 15, 2022 16:13

[FLINK-27291][docs-zh] Translate the "List of Data Types" section of…

c589aa8

… "Data Types" in to Chinese

update

1f2c62c

ChengkaiYang2022 reviewed Sep 1, 2022

View reviewed changes

ChengkaiYang2022 mentioned this pull request Sep 1, 2022

[FLINK-27291][docs-zh] Translate the "List of Data Types" section of… #19964

Closed

coder-zjh changed the title ~~Datatypes translate~~ [FLINK-27291][docs-zh] Translate the "List of Data Types" section of "Data Types" in to Chinese' Sep 1, 2022

coder-zjh requested a review from ChengkaiYang2022 September 1, 2022 05:22

flinkbot added component=chinese-translation component=Documentation labels Sep 1, 2022

ChengkaiYang2022 suggested changes Sep 2, 2022

View reviewed changes

coder-zjh changed the title ~~[FLINK-27291][docs-zh] Translate the "List of Data Types" section of "Data Types" in to Chinese'~~ [FLINK-27291][docs-zh] Translate the "List of Data Types" section of "Data Types" into Chinese' Sep 3, 2022

coder-zjh added 2 commits September 4, 2022 01:36

[FLINK-27291][docs-zh]check space problem and fix other problems

86abaf9

Delete vcs.xml

4c428d4

kylemeow reviewed Sep 14, 2022

View reviewed changes

coder-zjh added 2 commits September 14, 2022 11:44

[FLINK-27291][docs-zh]fix comma problem and confusing translation

a753d0c

line 153: comma problem line 176: confusing translation

Merge branch 'datatypes-translate' of https://github.com/coder-zjh/flink

dacaa9c

into datatypes-translate

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[FLINK-27291][docs-zh] Translate the "List of Data Types" section of "Data Types" into Chinese' #20724

[FLINK-27291][docs-zh] Translate the "List of Data Types" section of "Data Types" into Chinese' #20724

coder-zjh commented Aug 31, 2022

flinkbot commented Aug 31, 2022 •

edited

ChengkaiYang2022 Sep 1, 2022

coder-zjh Sep 1, 2022

ChengkaiYang2022 Sep 1, 2022

ChengkaiYang2022 commented Sep 1, 2022 •

edited

ChengkaiYang2022 left a comment •

edited

ChengkaiYang2022 Sep 2, 2022

ChengkaiYang2022 Sep 2, 2022

ChengkaiYang2022 Sep 2, 2022

ChengkaiYang2022 Sep 2, 2022

ChengkaiYang2022 Sep 2, 2022

ChengkaiYang2022 Sep 2, 2022 •

edited

ChengkaiYang2022 Sep 2, 2022

ChengkaiYang2022 Sep 2, 2022

ChengkaiYang2022 Sep 2, 2022

ChengkaiYang2022 Sep 2, 2022

kylemeow Sep 14, 2022

coder-zjh Sep 14, 2022

kylemeow Sep 14, 2022

coder-zjh Sep 14, 2022


		A row type is similar to the `STRUCT` type known from other non-standard-compliant frameworks.
		字段由字段名称、字段类型和可选描述组成。最具体的类型表的一行是行类型。在这种情况下，行的每一列对应于字段与列具有相同序号位置的行类型。

[FLINK-27291][docs-zh] Translate the "List of Data Types" section of "Data Types" into Chinese' #20724

Are you sure you want to change the base?

[FLINK-27291][docs-zh] Translate the "List of Data Types" section of "Data Types" into Chinese' #20724

Conversation

coder-zjh commented Aug 31, 2022

What is the purpose of the change

Brief change log

Verifying this change

Does this pull request potentially affect one of the following parts:

Documentation

flinkbot commented Aug 31, 2022 • edited

CI report:

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ChengkaiYang2022 commented Sep 1, 2022 • edited

ChengkaiYang2022 left a comment • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ChengkaiYang2022 Sep 2, 2022 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

flinkbot commented Aug 31, 2022 •

edited

ChengkaiYang2022 commented Sep 1, 2022 •

edited

ChengkaiYang2022 left a comment •

edited

ChengkaiYang2022 Sep 2, 2022 •

edited