カテゴリ：: 半構造化データ関数と構造化データ関数（キャスト）

AS_ARRAY¶

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

こちらもご参照ください。: AS_<オブジェクト型> 、 AS_OBJECT

構文¶

AS_ARRAY( <variant_expr> )

Copy

引数¶

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'));

Copy

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

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

Copy

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