Hisoka-X commented on code in PR #8367: URL: https://github.com/apache/seatunnel/pull/8367#discussion_r1898207967
##########
docs/en/concept/schema-feature.md:
##########
@@ -70,25 +70,26 @@ columns = [
#### What type supported at now
-| Data type | Value type in Java | Description
|
-|:----------|:---------------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| string | `java.lang.String` | string
|
-| boolean | `java.lang.Boolean` | boolean
|
-| tinyint | `java.lang.Byte` | -128 to 127
regular. 0 to 255 unsigned*. Specify the maximum number of digits in
parentheses.
|
-| smallint | `java.lang.Short` | -32768 to
32767 General. 0 to 65535 unsigned*. Specify the maximum number of digits in
parentheses.
|
-| int | `java.lang.Integer` | All numbers
from -2,147,483,648 to 2,147,483,647 are allowed.
|
-| bigint | `java.lang.Long` | All numbers
between -9,223,372,036,854,775,808 and 9,223,372,036,854,775,807 are allowed.
|
-| float | `java.lang.Float` |
Float-precision numeric data from -1.79E+308 to 1.79E+308.
|
-| double | `java.lang.Double` | Double
precision floating point. Handle most decimals.
|
-| decimal | `java.math.BigDecimal` | Double type
stored as a string, allowing a fixed decimal point.
|
-| null | `java.lang.Void` | null
|
-| bytes | `byte[]` | bytes
|
-| date | `java.time.LocalDate` | Only the
date is stored. From January 1, 0001 to December 31, 9999.
|
-| time | `java.time.LocalTime` | Only store
time. Accuracy is 100 nanoseconds.
|
-| timestamp | `java.time.LocalDateTime` | Stores a
unique number that is updated whenever a row is created or modified. timestamp
is based on the internal clock and does not correspond to real time. There can
only be one timestamp variable per table.
|
-| row | `org.apache.seatunnel.api.table.type.SeaTunnelRow` | Row type,
can be nested.
|
-| map | `java.util.Map` | A Map is an
object that maps keys to values. The key type includes `int` `string` `boolean`
`tinyint` `smallint` `bigint` `float` `double` `decimal` `date` `time`
`timestamp` `null` , and the value type includes `int` `string` `boolean`
`tinyint` `smallint` `bigint` `float` `double` `decimal` `date` `time`
`timestamp` `null` `array` `map` `row`. |
-| array | `ValueType[]` | A array is
a data type that represents a collection of elements. The element type includes
`int` `string` `boolean` `tinyint` `smallint` `bigint` `float` `double`.
|
+| Data type | Value type in Java |
Description
|
+|:-------------|:---------------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| string | `java.lang.String` | string
|
+| boolean | `java.lang.Boolean` | boolean
|
+| tinyint | `java.lang.Byte` | -128 to
127 regular. 0 to 255 unsigned*. Specify the maximum number of digits in
parentheses.
|
+| smallint | `java.lang.Short` | -32768
to 32767 General. 0 to 65535 unsigned*. Specify the maximum number of digits in
parentheses.
|
+| int | `java.lang.Integer` | All
numbers from -2,147,483,648 to 2,147,483,647 are allowed.
|
+| bigint | `java.lang.Long` | All
numbers between -9,223,372,036,854,775,808 and 9,223,372,036,854,775,807 are
allowed.
|
+| float | `java.lang.Float` |
Float-precision numeric data from -1.79E+308 to 1.79E+308.
|
+| double | `java.lang.Double` | Double
precision floating point. Handle most decimals.
|
+| decimal | `java.math.BigDecimal` | Double
type stored as a string, allowing a fixed decimal point.
|
+| null | `java.lang.Void` | null
|
+| bytes | `byte[]` | bytes
|
+| date | `java.time.LocalDate` | Only the
date is stored. From January 1, 0001 to December 31, 9999.
|
+| time | `java.time.LocalTime` | Only
store time. Accuracy is 100 nanoseconds.
|
+| timestamp | `java.time.LocalDateTime` | Stores a
unique number that is updated whenever a row is created or modified. timestamp
is based on the internal clock and does not correspond to real time. There can
only be one timestamp variable per table.
|
+| timestamp_tz | `java.time.OffsetDateTime` | Stores a
unique number that is updated whenever a row is created or modified. timestamp
is based on the internal clock and does not correspond to real time. There can
only be one timestamp variable per table.
|
Review Comment:
```suggestion
| timestamp | `java.time.LocalDateTime` | Stores
date and time information without time zone. Represents the time of an event in
local time. It does not include any offset or zone information.
|
| timestamp_tz | `java.time.OffsetDateTime` | Stores
date and time information with an offset from UTC. It includes both the local
date-time and the offset from UTC, providing more precise temporal information
when working with multiple time zones.
|
```
##########
docs/zh/concept/schema-feature.md:
##########
@@ -70,25 +70,26 @@ columns = [
#### 目前支持哪些类型
-| 数据类型 | Java中的值类型 | 描述
|
-|:----------|:---------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| string | `java.lang.String` | 字符串
|
-| boolean | `java.lang.Boolean` | 布尔
|
-| tinyint | `java.lang.Byte` | 常规-128 至
127 。 0 到 255 无符号*。 指定括号中的最大位数。
|
-| smallint | `java.lang.Short` | 常规-32768 至
32767。 0 到 65535 无符号*。 指定括号中的最大位数。
|
-| int | `java.lang.Integer` | 允许从
-2,147,483,648 到 2,147,483,647 的所有数字。
|
-| bigint | `java.lang.Long` | 允许
-9,223,372,036,854,775,808 和 9,223,372,036,854,775,807 之间的所有数字。
|
-| float | `java.lang.Float` | 从-1.79E+308
到 1.79E+308浮点精度数值数据。
|
-| double | `java.lang.Double` | 双精度浮点。
处理大多数小数。
|
-| decimal | `java.math.BigDecimal` | Double
类型存储为字符串，允许固定小数点。
|
-| null | `java.lang.Void` | null
|
-| bytes | `byte[]` | 字节。
|
-| date | `java.time.LocalDate` |
仅存储日期。从0001年1月1日到9999 年 12 月 31 日。
|
-| time | `java.time.LocalTime` | 仅存储时间。精度为
100 纳秒。
|
-| timestamp | `java.time.LocalDateTime` |
存储一个唯一的编号，每当创建或修改行时都会更新该编号。 时间戳基于内部时钟，与实际时间不对应。 每个表只能有一个时间戳变量。
|
-| row | `org.apache.seatunnel.api.table.type.SeaTunnelRow` | 行类型，可以嵌套。
|
-| map | `java.util.Map` | Map
是将键映射到值的对象。 键类型包括： `int` `string` `boolean` `tinyint` `smallint` `bigint`
`float` `double` `decimal` `date` `time` `timestamp` `null` , and the value
type includes `int` `string` `boolean` `tinyint` `smallint` `bigint` `float`
`double` `decimal` `date` `time` `timestamp` `null` `array` `map` `row`. |
-| array | `ValueType[]` |
数组是一种表示元素集合的数据类型。 元素类型包括： `int` `string` `boolean` `tinyint` `smallint`
`bigint` `float` `double`.
|
+| 数据类型 | Java中的值类型 | 描述
|
+|:-------------|:---------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| string | `java.lang.String` | 字符串
|
+| boolean | `java.lang.Boolean` | 布尔
|
+| tinyint | `java.lang.Byte` | 常规-128 至
127 。 0 到 255 无符号*。 指定括号中的最大位数。
|
+| smallint | `java.lang.Short` | 常规-32768
至 32767。 0 到 65535 无符号*。 指定括号中的最大位数。
|
+| int | `java.lang.Integer` | 允许从
-2,147,483,648 到 2,147,483,647 的所有数字。
|
+| bigint | `java.lang.Long` | 允许
-9,223,372,036,854,775,808 和 9,223,372,036,854,775,807 之间的所有数字。
|
+| float | `java.lang.Float` |
从-1.79E+308 到 1.79E+308浮点精度数值数据。
|
+| double | `java.lang.Double` | 双精度浮点。
处理大多数小数。
|
+| decimal | `java.math.BigDecimal` | Double
类型存储为字符串，允许固定小数点。
|
+| null | `java.lang.Void` | null
|
+| bytes | `byte[]` | 字节。
|
+| date | `java.time.LocalDate` |
仅存储日期。从0001年1月1日到9999 年 12 月 31 日。
|
+| time | `java.time.LocalTime` |
仅存储时间。精度为 100 纳秒。
|
+| timestamp | `java.time.LocalDateTime` |
存储一个唯一的编号，每当创建或修改行时都会更新该编号。 时间戳基于内部时钟，与实际时间不对应。 每个表只能有一个时间戳变量。
|
+| timestamp_tz | `java.time.OffsetDateTime` |
存储一个唯一的编号，每当创建或修改行时都会更新该编号。 时间戳基于内部时钟，与实际时间不对应。 每个表只能有一个时间戳变量。
|
Review Comment:
```suggestion
| timestamp | `java.time.LocalDateTime` |
存储不带时区的日期和时间信息，表示事件发生的本地时间。不包含任何偏移量或时区相关信息。
|
| timestamp_tz | `java.time.OffsetDateTime` | 存储带有
UTC 偏移量的日期和时间信息，包含本地日期时间和 UTC 偏移量。在处理多时区场景时，可以提供更精确的时间信息。
|
```
--
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.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
