类别：

半结构化和结构化数据函数 （类型转换）

AS_ARRAY

将 VARIANT 值转换为 ARRAY 值。

另请参阅：

AS_<object_type>、AS_OBJECT

语法

AS_ARRAY( <variant_expr> )

实参

variant_expr

VARIANT 类型值计算的表达式。

返回

该函数返回 ARRAY 类型的值或 NULL：

  • 如果 variant_expr 实参中的值类型为 ARRAY，则函数返回 ARRAY 类型的值。

  • 如果 variant_expr 实参中的值类型与输出值的类型不匹配，则函数返回 NULL。

  • 如果 variant_expr 实参为 NULL，则该函数返回 NULL。

使用说明

示例

创建一个表并将数据加载到其中：

CREATE OR REPLACE TABLE as_array_example (
  array1 VARIANT,
  array2 VARIANT);

INSERT INTO as_array_example (array1, array2)
  SELECT
    TO_VARIANT(TO_ARRAY('Example')),
    TO_VARIANT(ARRAY_CONSTRUCT('Array-like', 'example'));

在查询中使用 AS_ARRAY 函数将 VARIANT 值转换为 ARRAY 值：

SELECT AS_ARRAY(array1) AS array1,
       AS_ARRAY(array2) AS array2
  FROM as_array_example;

+-------------+-----------------+
| ARRAY1      | ARRAY2          |
|-------------+-----------------|
| [           | [               |
|   "Example" |   "Array-like", |
| ]           |   "example"     |
|             | ]               |
+-------------+-----------------+