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

TO_OBJECT¶

将输入值转换为 OBJECT。

对于包含 OBJECT 的 VARIANT 值，返回 OBJECT。
对于 NULL 输入或仅包含 JSON null 的 VARIANT 值，返回 NULL。
对于 OBJECT，返回 OBJECT 本身。
对于所有其他输入值，报告错误。

语法¶

TO_OBJECT( <expr> )

Copy

实参¶

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

返回¶

返回值的数据类型是 OBJECT。

示例¶

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

创建一个表并插入一个 VARIANT 类型的值。（函数 PARSE_JSON 返回一个 VARIANT。)
CREATE TABLE t1 (vo VARIANT);
INSERT INTO t1 (vo) 
    SELECT PARSE_JSON('{"a":1}');
Copy
调用 TO_OBJECT 函数：
SELECT TO_OBJECT(vo) from t1;
+---------------+
| TO_OBJECT(VO) |
|---------------|
| {             |
|   "a": 1      |
| }             |
+---------------+
Copy