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

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 | | | } | +---+---------------+ 