- カテゴリ:
半構造化データ関数と構造化データ関数 (型述語)
IS_CHAR , IS_VARCHAR¶
VARIANT 引数に 文字列値 が含まれる場合は、 TRUE を返します。
これらの関数は同義語です。
- こちらもご参照ください:
構文¶
IS_CHAR( <variant_expr> )
IS_VARCHAR( <variant_expr> )
引数¶
variant_expr
VARIANT型の値に評価される式です。
戻り値¶
BOOLEAN 値または NULL を返します。
VARIANT 値に文字列値が含まれている場合は、 TRUE を返します。それ以外の場合は、 FALSE を返します。
入力が NULL の場合は、エラーを報告せずに NULL を返します。
例¶
以下の例では、 IS_VARCHAR 関数を使用しています。
WHERE 句で IS_VARCHAR 関数を使用します。¶
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;
データをクエリする。このクエリは、 TYPEOF 関数を使用して、 VARIANT 列に格納されている値のデータ型を表示します。
SELECT n, v, TYPEOF(v)
FROM vartab
ORDER BY n;
+---+------------------------+------------+
| 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 | |
| | } | |
+---+------------------------+------------+
WHERE 句で IS_VARCHAR 関数を使用して、データ内文字列値を表示します。
SELECT * FROM vartab WHERE IS_VARCHAR(v);
+---+------------------------+
| N | V |
|---+------------------------|
| 7 | "Om ara pa ca na dhih" |
+---+------------------------+
SELECT リストで IS_VARCHAR 関数を使用します。¶
multiple_types
テーブルを作成して入力します。INSERT ステートメントでは、 TO_VARIANT 関数を使用して列に VARIANT 値を挿入します。
CREATE OR REPLACE TABLE multiple_types (
array1 VARIANT,
array2 VARIANT,
boolean1 VARIANT,
varchar1 VARIANT,
varchar2 VARIANT,
decimal1 VARIANT,
double1 VARIANT,
integer1 VARIANT,
object1 VARIANT);
INSERT INTO multiple_types
(array1, array2, boolean1, varchar1, varchar2,
decimal1, double1, integer1, object1)
SELECT
TO_VARIANT(TO_ARRAY('Example')),
TO_VARIANT(ARRAY_CONSTRUCT('Array-like', 'example')),
TO_VARIANT(TRUE),
TO_VARIANT('X'),
TO_VARIANT('I am a real character'),
TO_VARIANT(1.23::DECIMAL(6, 3)),
TO_VARIANT(3.21::DOUBLE),
TO_VARIANT(15),
TO_VARIANT(TO_OBJECT(PARSE_JSON('{"Tree": "Pine"}')));
TYPEOF 関数を使用してデータをクエリし、 VARIANT 値に格納されている値のデータ型を表示します。
SELECT TYPEOF(array1),
TYPEOF(array2),
TYPEOF(boolean1),
TYPEOF(varchar1),
TYPEOF(varchar2),
TYPEOF(decimal1),
TYPEOF(double1),
TYPEOF(integer1),
TYPEOF(object1)
FROM multiple_types;
+----------------+----------------+------------------+------------------+------------------+------------------+-----------------+------------------+-----------------+
| TYPEOF(ARRAY1) | TYPEOF(ARRAY2) | TYPEOF(BOOLEAN1) | TYPEOF(VARCHAR1) | TYPEOF(VARCHAR2) | TYPEOF(DECIMAL1) | TYPEOF(DOUBLE1) | TYPEOF(INTEGER1) | TYPEOF(OBJECT1) |
|----------------+----------------+------------------+------------------+------------------+------------------+-----------------+------------------+-----------------|
| ARRAY | ARRAY | BOOLEAN | VARCHAR | VARCHAR | DECIMAL | DOUBLE | INTEGER | OBJECT |
+----------------+----------------+------------------+------------------+------------------+------------------+-----------------+------------------+-----------------+
SELECT リストで IS_VARCHAR 関数を使用して、列がデータ内に文字列値を含むかどうかを表示します。
SELECT IS_VARCHAR(varchar1),
IS_VARCHAR(boolean1)
FROM multiple_types;
+----------------------+----------------------+
| IS_VARCHAR(VARCHAR1) | IS_VARCHAR(BOOLEAN1) |
|----------------------+----------------------|
| True | False |
+----------------------+----------------------+