カテゴリ：: 半構造化データ関数と構造化データ関数（型述語）

IS_<オブジェクト型>¶

この関数ファミリーは、 VARIANT 列に保存されている値のデータ型を決定するために使用できるブール述語として機能します。

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

一般的な使用上の注意¶

すべての関数は単項で、 VARIANT 式を唯一の引数として使用します。
入力が SQL NULL であるか、 VARIANT 式が NULL を含んでいる場合、すべての関数は FALSE を返します。

例¶

vartab テーブルを作成して入力します。INSERT ステートメントは PARSE_JSON 関数を使用して、テーブルの v 列に VARIANT 値を挿入します。

CREATE OR REPLACE TABLE vartab (n NUMBER(2), v VARIANT);

INSERT INTO vartab
  SELECT column1 AS n, PARSE_JSON(column2) AS v
    FROM VALUES (1, 'null'), 
                (2, null), 
                (3, 'true'),
                (4, '-17'), 
                (5, '123.12'), 
                (6, '1.912e2'),
                (7, '"Om ara pa ca na dhih"  '), 
                (8, '[-1, 12, 289, 2188, false,]'), 
                (9, '{ "x" : "abc", "y" : false, "z": 10} ') 
       AS vals;

Copy

データをクエリする。このクエリは、 TYPEOF 関数を使用して、 VARIANT 列に格納されている値のデータ型を表示します。

SELECT n, v, TYPEOF(v)
  FROM vartab
  ORDER BY n;

Copy

+---+------------------------+------------+
| N | V                      | TYPEOF(V)  |
|---+------------------------+------------|
| 1 | null                   | NULL_VALUE |
| 2 | NULL                   | NULL       |
| 3 | true                   | BOOLEAN    |
| 4 | -17                    | INTEGER    |
| 5 | 123.12                 | DECIMAL    |
| 6 | 1.912000000000000e+02  | DOUBLE     |
| 7 | "Om ara pa ca na dhih" | VARCHAR    |
| 8 | [                      | ARRAY      |
|   |   -1,                  |            |
|   |   12,                  |            |
|   |   289,                 |            |
|   |   2188,                |            |
|   |   false,               |            |
|   |   undefined            |            |
|   | ]                      |            |
| 9 | {                      | OBJECT     |
|   |   "x": "abc",          |            |
|   |   "y": false,          |            |
|   |   "z": 10              |            |
|   | }                      |            |
+---+------------------------+------------+

VARIANT 列の v に文字列値が含まれる vartab テーブルのすべての行をカウントします。

SELECT COUNT(*) FROM vartab WHERE IS_VARCHAR(v);

Copy

+----------+
| COUNT(*) |
|----------|
|        1 |
+----------+

VARIANT 列の v に指定されたデータ型が含まれる vartab テーブルの行を選択します。

SELECT * FROM vartab WHERE IS_NULL_VALUE(v);

Copy

+---+------+
| N | V    |
|---+------|
| 1 | null |
+---+------+

SELECT * FROM vartab WHERE IS_BOOLEAN(v);

Copy

+---+------+
| N | V    |
|---+------|
| 3 | true |
+---+------+

SELECT * FROM vartab WHERE IS_INTEGER(v);

Copy

+---+-----+
| N | V   |
|---+-----|
| 4 | -17 |
+---+-----+

SELECT * FROM vartab WHERE IS_DECIMAL(v);

Copy

+---+--------+
| N | V      |
|---+--------|
| 4 | -17    |
| 5 | 123.12 |
+---+--------+

SELECT * FROM vartab WHERE IS_DOUBLE(v);

Copy

+---+-----------------------+
| N | V                     |
|---+-----------------------|
| 4 | -17                   |
| 5 | 123.12                |
| 6 | 1.912000000000000e+02 |
+---+-----------------------+

SELECT * FROM vartab WHERE IS_VARCHAR(v);

Copy

+---+------------------------+
| N | V                      |
|---+------------------------|
| 7 | "Om ara pa ca na dhih" |
+---+------------------------+

SELECT * FROM vartab WHERE IS_ARRAY(v);

Copy

+---+-------------+
| N | V           |
|---+-------------|
| 8 | [           |
|   |   -1,       |
|   |   12,       |
|   |   289,      |
|   |   2188,     |
|   |   false,    |
|   |   undefined |
|   | ]           |
+---+-------------+

SELECT * FROM vartab WHERE IS_OBJECT(v);

Copy

+---+---------------+
| N | V             |
|---+---------------|
| 9 | {             |
|   |   "x": "abc", |
|   |   "y": false, |
|   |   "z": 10     |
|   | }             |
+---+---------------+