カテゴリ：

半構造化データ関数と構造化データ関数 （キャスト）

AS_ARRAY

VARIANT 値を ARRAY 値にキャストします。

こちらもご参照ください。

AS_<オブジェクト型> 、 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'));

VARIANT 値を ARRAY 値にキャストするには、クエリで AS_ARRAY 関数を使用します。

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

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