- Categorias:
Funções de dados semiestruturados e estruturados (Predicados de tipo)
IS_<tipo_de_objeto>¶
Esta família de funções serve como predicados booleanos que podem ser usados para determinar o tipo de dados de um valor armazenado em uma coluna de VARIANT:
- Consulte também:
Notas de uso geral¶
Todas as funções são unárias, usando uma expressão VARIANT como único argumento.
Todas as funções retornam FALSE se a entrada for SQL NULL ou se a expressão VARIANT contiver NULL.
Exemplos¶
Criação e preenchimento da tabela vartab
. A instrução INSERT usa a função PARSE_JSON para inserir valores VARIANT na coluna v
da tabela.
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;
Consultar os dados. A consulta usa a função TYPEOF para mostrar os tipos de dados dos valores armazenados na coluna 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 | |
| | } | |
+---+------------------------+------------+
Contar todas as linhas da tabela vartab
onde a coluna VARIANT v
contém um valor de cadeia de caracteres:
SELECT COUNT(*) FROM vartab WHERE IS_VARCHAR(v);
+----------+
| COUNT(*) |
|----------|
| 1 |
+----------+
Selecionar linhas na tabela vartab
onde a coluna VARIANT v
contém o tipo de dados especificado:
SELECT * FROM vartab WHERE IS_NULL_VALUE(v);
+---+------+
| N | V |
|---+------|
| 1 | null |
+---+------+
SELECT * FROM vartab WHERE IS_BOOLEAN(v);
+---+------+
| N | V |
|---+------|
| 3 | true |
+---+------+
SELECT * FROM vartab WHERE IS_INTEGER(v);
+---+-----+
| N | V |
|---+-----|
| 4 | -17 |
+---+-----+
SELECT * FROM vartab WHERE IS_DECIMAL(v);
+---+--------+
| N | V |
|---+--------|
| 4 | -17 |
| 5 | 123.12 |
+---+--------+
SELECT * FROM vartab WHERE IS_DOUBLE(v);
+---+-----------------------+
| N | V |
|---+-----------------------|
| 4 | -17 |
| 5 | 123.12 |
| 6 | 1.912000000000000e+02 |
+---+-----------------------+
SELECT * FROM vartab WHERE IS_VARCHAR(v);
+---+------------------------+
| N | V |
|---+------------------------|
| 7 | "Om ara pa ca na dhih" |
+---+------------------------+
SELECT * FROM vartab WHERE IS_ARRAY(v);
+---+-------------+
| N | V |
|---+-------------|
| 8 | [ |
| | -1, |
| | 12, |
| | 289, |
| | 2188, |
| | false, |
| | undefined |
| | ] |
+---+-------------+
SELECT * FROM vartab WHERE IS_OBJECT(v);
+---+---------------+
| N | V |
|---+---------------|
| 9 | { |
| | "x": "abc", |
| | "y": false, |
| | "z": 10 |
| | } |
+---+---------------+