twalthr commented on code in PR #29310:
URL: https://github.com/apache/flink/pull/29310#discussion_r4123880312
##########
docs/content.zh/docs/sql/reference/data-types.md:
##########
@@ -1593,6 +1593,12 @@ object as `{k1=v1, k2=v2}`, with each value rendered by
these same rules and a n
shown as `NULL`. A string is never quoted, at any depth. Use `JSON_STRING` for
the JSON form with
quoted strings. A variant that stores a JSON `null` casts to SQL `NULL`.
+Printed results, for example in the SQL client, render a `VARIANT` the same
way as
+`CAST(v AS STRING)`, not as JSON, but printing never fails. A binary value
prints as `x'68656c6c6f'`, a JSON `null` as `NULL`
+where a SQL `NULL` prints as `<NULL>`, a type written by a newer version as
`<UNKNOWN>`, and other
+data that cannot be decoded as `<INVALID>`. A `TIMESTAMP_LTZ` prints in the
session time zone, as in
+the cast.
Review Comment:
```suggestion
Printed results, for example in the SQL client, render a `VARIANT` the same
way as
`CAST(v AS STRING)`. A binary value prints as `x'68656c6c6f'`, a variant
`null` as `NULL`
where a SQL `NULL` prints as `<NULL>`, a variant type written by a newer
version as `<UNKNOWN>`, and other
data that cannot be decoded as `<INVALID>`. A `TIMESTAMP_LTZ` prints in the
session time zone.
```
--
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]
