类别：

转换函数、 :doc:`/sql-reference/functions-semistructured`（数组/对象）

TO_OBJECT

将输入值转换为 OBJECT。

  • 对于包含 OBJECT 的 VARIANT 值，返回 OBJECT。

  • 对于 NULL 输入或仅包含 JSON null 的 VARIANT 值，返回 NULL。

  • 对于 OBJECT，返回 OBJECT 本身。

  • 对于所有其他输入值，报告错误。

语法

TO_OBJECT( <expr> )

实参

expr

一个表达式，计算结果为包含 OBJECT 的 VARIANT。

返回

返回值的数据类型是 OBJECT。

示例

这演示了 TO_OBJECT 函数的简单用法：

创建一个表并插入一个 VARIANT 类型的值。（函数 PARSE_JSON 返回一个 VARIANT。)

CREATE TABLE t1 (vo VARIANT);
INSERT INTO t1 (vo) 
    SELECT PARSE_JSON('{"a":1}');

调用 TO_OBJECT 函数：

SELECT TO_OBJECT(vo) from t1;
+---------------+
| TO_OBJECT(VO) |
|---------------|
| {             |
|   "a": 1      |
| }             |
+---------------+