libenchao commented on a change in pull request #12748:
URL: https://github.com/apache/flink/pull/12748#discussion_r444854722
##########
File path: docs/dev/table/types.zh.md
##########
@@ -1071,6 +1165,44 @@ DataTypes.BOOLEAN()
|`java.lang.Boolean` | X | X | *缺省* |
|`boolean` | X | (X) | 仅当类型不可为空时才输出。 |
+#### `RAW`
+
+任意序列化类型的数据类型。此类型是 Table 编程环境中的黑箱，仅在边缘反序列化。
Review comment:
```suggestion
任意序列化类型的数据类型。此类型对于 Flink Table 来讲是一个黑盒子，仅在跟外部交互时被反序列化。
```
##########
File path: docs/dev/table/types.zh.md
##########
@@ -1106,41 +1238,111 @@ DataTypes.NULL()
|`java.lang.Object` | X | X | *缺省* |
|*任何类型* | | (X) | 任何非基本数据类型 |
-#### `RAW`
+数据类型注解
+---------------------
-任意序列化类型的数据类型。此类型是 Table 编程环境中的黑箱，仅在边缘反序列化。
+Flink API
经常尝试使用反射自动从类信息中提取数据类型，以避免重复的手动定义模式工作。然而以反射方式提取数据类型并不总是成功的，因为可能会丢失逻辑信息。因此，可能有必要在类或字段声明附近添加额外信息以支持提取逻辑。
+
+下表列出了可以隐式映射到数据类型而无需额外信息的类：
+
+| 类 | 数据类型 |
+|:----------------------------|:------------------------------------|
+| `java.lang.String` | `STRING` |
+| `java.lang.Boolean` | `BOOLEAN` |
+| `boolean` | `BOOLEAN NOT NULL` |
+| `java.lang.Byte` | `TINYINT` |
+| `byte` | `TINYINT NOT NULL` |
+| `java.lang.Short` | `SMALLINT` |
+| `short` | `SMALLINT NOT NULL` |
+| `java.lang.Integer` | `INT` |
+| `int` | `INT NOT NULL` |
+| `java.lang.Long` | `BIGINT` |
+| `long` | `BIGINT NOT NULL` |
+| `java.lang.Float` | `FLOAT` |
+| `float` | `FLOAT NOT NULL` |
+| `java.lang.Double` | `DOUBLE` |
+| `double` | `DOUBLE NOT NULL` |
+| `java.sql.Date` | `DATE` |
+| `java.time.LocalDate` | `DATE` |
+| `java.sql.Time` | `TIME(0)` |
+| `java.time.LocalTime` | `TIME(9)` |
+| `java.sql.Timestamp` | `TIMESTAMP(9)` |
+| `java.time.LocalDateTime` | `TIMESTAMP(9)` |
+| `java.time.OffsetDateTime` | `TIMESTAMP(9) WITH TIME ZONE` |
+| `java.time.Instant` | `TIMESTAMP(9) WITH LOCAL TIME ZONE` |
+| `java.time.Duration` | `INVERVAL SECOND(9)` |
+| `java.time.Period` | `INTERVAL YEAR(4) TO MONTH` |
+| `byte[]` | `BYTES` |
+| `T[]` | `ARRAY<T>` |
+| `java.lang.Map<K, V>` | `MAP<K, V>` |
+| structured type `T` | anonymous structured type `T` |
+
+
+本文提到的其他 JVM 桥接类都需要 @DataTypeHint 注释。
+
+_数据类型提示_ 可以参数化或替换函数参数和返回值、结构化类或结构化类字段的默认提取逻辑，实现者可以通过声明 @DataTypeHint
注解来选择默认提取逻辑应修改的程度。
Review comment:
```suggestion
_数据类型提示_ 可以参数化或替换函数参数和返回值、结构化类或结构化类字段的默认提取逻辑，实现者可以通过声明 `@DataTypeHint`
注解来选择默认提取逻辑应修改的程度。
```
##########
File path: docs/dev/table/types.zh.md
##########
@@ -1071,6 +1165,44 @@ DataTypes.BOOLEAN()
|`java.lang.Boolean` | X | X | *缺省* |
|`boolean` | X | (X) | 仅当类型不可为空时才输出。 |
+#### `RAW`
+
+任意序列化类型的数据类型。此类型是 Table 编程环境中的黑箱，仅在边缘反序列化。
+
+Raw 类型是 SQL 标准的扩展。
+
+**声明**
+
+<div class="codetabs" markdown="1">
+
+<div data-lang="SQL" markdown="1">
+{% highlight text %}
+RAW('class', 'snapshot')
+{% endhighlight %}
+</div>
+
+<div data-lang="Java/Scala" markdown="1">
+{% highlight java %}
+DataTypes.RAW(class, serializer)
+
+DataTypes.RAW(class)
+{% endhighlight %}
+</div>
+
+</div>
+
+此类型用 `RAW('class', 'snapshot')` 声明，其中 `class` 是原始类，`snapshot` 是 Base64 编码的序列化的
`TypeSerializerSnapshot`。通常，类型字符串不是直接声明的，而是在保留类型时生成的。
Review comment:
```suggestion
此类型用 `RAW('class', 'snapshot')` 声明，其中 `class` 是原始类，`snapshot` 是 Base64
编码的序列化的 `TypeSerializerSnapshot`。通常，类型字符串不是直接声明的，而是在持久化类型时生成的。
```
##########
File path: docs/dev/table/types.zh.md
##########
@@ -1106,41 +1238,111 @@ DataTypes.NULL()
|`java.lang.Object` | X | X | *缺省* |
|*任何类型* | | (X) | 任何非基本数据类型 |
-#### `RAW`
+数据类型注解
+---------------------
-任意序列化类型的数据类型。此类型是 Table 编程环境中的黑箱，仅在边缘反序列化。
+Flink API
经常尝试使用反射自动从类信息中提取数据类型，以避免重复的手动定义模式工作。然而以反射方式提取数据类型并不总是成功的，因为可能会丢失逻辑信息。因此，可能有必要在类或字段声明附近添加额外信息以支持提取逻辑。
+
+下表列出了可以隐式映射到数据类型而无需额外信息的类：
+
+| 类 | 数据类型 |
+|:----------------------------|:------------------------------------|
+| `java.lang.String` | `STRING` |
+| `java.lang.Boolean` | `BOOLEAN` |
+| `boolean` | `BOOLEAN NOT NULL` |
+| `java.lang.Byte` | `TINYINT` |
+| `byte` | `TINYINT NOT NULL` |
+| `java.lang.Short` | `SMALLINT` |
+| `short` | `SMALLINT NOT NULL` |
+| `java.lang.Integer` | `INT` |
+| `int` | `INT NOT NULL` |
+| `java.lang.Long` | `BIGINT` |
+| `long` | `BIGINT NOT NULL` |
+| `java.lang.Float` | `FLOAT` |
+| `float` | `FLOAT NOT NULL` |
+| `java.lang.Double` | `DOUBLE` |
+| `double` | `DOUBLE NOT NULL` |
+| `java.sql.Date` | `DATE` |
+| `java.time.LocalDate` | `DATE` |
+| `java.sql.Time` | `TIME(0)` |
+| `java.time.LocalTime` | `TIME(9)` |
+| `java.sql.Timestamp` | `TIMESTAMP(9)` |
+| `java.time.LocalDateTime` | `TIMESTAMP(9)` |
+| `java.time.OffsetDateTime` | `TIMESTAMP(9) WITH TIME ZONE` |
+| `java.time.Instant` | `TIMESTAMP(9) WITH LOCAL TIME ZONE` |
+| `java.time.Duration` | `INVERVAL SECOND(9)` |
+| `java.time.Period` | `INTERVAL YEAR(4) TO MONTH` |
+| `byte[]` | `BYTES` |
+| `T[]` | `ARRAY<T>` |
+| `java.lang.Map<K, V>` | `MAP<K, V>` |
+| structured type `T` | anonymous structured type `T` |
+
+
+本文提到的其他 JVM 桥接类都需要 @DataTypeHint 注释。
+
+_数据类型提示_ 可以参数化或替换函数参数和返回值、结构化类或结构化类字段的默认提取逻辑，实现者可以通过声明 @DataTypeHint
注解来选择默认提取逻辑应修改的程度。
+
+@DataTypeHint 注解提供了一组可选的提示参数，以下示例显示了其中一些参数，可以在注解类的文档中找到更多信息。
Review comment:
```suggestion
`@DataTypeHint` 注解提供了一组可选的提示参数，以下示例显示了其中一些参数，可以在注解类的文档中找到更多信息。
```
##########
File path: docs/dev/table/types.zh.md
##########
@@ -1106,41 +1238,111 @@ DataTypes.NULL()
|`java.lang.Object` | X | X | *缺省* |
|*任何类型* | | (X) | 任何非基本数据类型 |
-#### `RAW`
+数据类型注解
+---------------------
-任意序列化类型的数据类型。此类型是 Table 编程环境中的黑箱，仅在边缘反序列化。
+Flink API
经常尝试使用反射自动从类信息中提取数据类型，以避免重复的手动定义模式工作。然而以反射方式提取数据类型并不总是成功的，因为可能会丢失逻辑信息。因此，可能有必要在类或字段声明附近添加额外信息以支持提取逻辑。
+
+下表列出了可以隐式映射到数据类型而无需额外信息的类：
+
+| 类 | 数据类型 |
+|:----------------------------|:------------------------------------|
+| `java.lang.String` | `STRING` |
+| `java.lang.Boolean` | `BOOLEAN` |
+| `boolean` | `BOOLEAN NOT NULL` |
+| `java.lang.Byte` | `TINYINT` |
+| `byte` | `TINYINT NOT NULL` |
+| `java.lang.Short` | `SMALLINT` |
+| `short` | `SMALLINT NOT NULL` |
+| `java.lang.Integer` | `INT` |
+| `int` | `INT NOT NULL` |
+| `java.lang.Long` | `BIGINT` |
+| `long` | `BIGINT NOT NULL` |
+| `java.lang.Float` | `FLOAT` |
+| `float` | `FLOAT NOT NULL` |
+| `java.lang.Double` | `DOUBLE` |
+| `double` | `DOUBLE NOT NULL` |
+| `java.sql.Date` | `DATE` |
+| `java.time.LocalDate` | `DATE` |
+| `java.sql.Time` | `TIME(0)` |
+| `java.time.LocalTime` | `TIME(9)` |
+| `java.sql.Timestamp` | `TIMESTAMP(9)` |
+| `java.time.LocalDateTime` | `TIMESTAMP(9)` |
+| `java.time.OffsetDateTime` | `TIMESTAMP(9) WITH TIME ZONE` |
+| `java.time.Instant` | `TIMESTAMP(9) WITH LOCAL TIME ZONE` |
+| `java.time.Duration` | `INVERVAL SECOND(9)` |
+| `java.time.Period` | `INTERVAL YEAR(4) TO MONTH` |
+| `byte[]` | `BYTES` |
+| `T[]` | `ARRAY<T>` |
+| `java.lang.Map<K, V>` | `MAP<K, V>` |
+| structured type `T` | anonymous structured type `T` |
+
+
+本文提到的其他 JVM 桥接类都需要 @DataTypeHint 注释。
Review comment:
```suggestion
本文提到的其他 JVM 桥接类都需要 `@DataTypeHint` 注解。
```
----------------------------------------------------------------
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
