카테고리:: 반정형 및 정형 데이터 함수 (형식 조건자)

IS_ARRAY¶

VARIANT 인자에 ARRAY 값이 있는 경우 TRUE를 반환합니다.

참고 항목:: IS_<오브젝트_유형_> , IS_OBJECT

구문¶

IS_ARRAY( <variant_expr> )

Copy

인자¶

variant_expr: VARIANT 형식의 값으로 평가되는 식입니다.

반환¶

BOOLEAN 값 또는 NULL 을 반환합니다.

VARIANT 값에 ARRAY 값이 포함된 경우 TRUE 를 반환합니다. 그렇지 않으면 FALSE를 반환합니다.
입력값이 NULL이면 오류를 보고하지 않고 NULL을 반환합니다.

사용법 노트¶

이 함수는 입력 인자로 정형 타입 을 지원하지 않습니다.

예¶

다음 예제에서는 IS_ARRAY 함수를 사용합니다.

WHERE 절에서 IS_ARRAY 함수 사용¶

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

WHERE 절에서 IS_ARRAY 함수를 사용하여 데이터에 ARRAY 값을 표시합니다.

SELECT * FROM vartab WHERE IS_ARRAY(v);

Copy

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

SELECT 목록에서 IS_ARRAY 함수 사용¶

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

Copy

TYPEOF 함수를 사용하여 데이터를 쿼리해 VARIANT 값에 저장된 값의 데이터 타입을 표시합니다.

SELECT TYPEOF(array1),
       TYPEOF(array2),
       TYPEOF(boolean1),
       TYPEOF(varchar1),
       TYPEOF(varchar2),
       TYPEOF(decimal1),
       TYPEOF(double1),
       TYPEOF(integer1),
       TYPEOF(object1)
  FROM multiple_types;

Copy

+----------------+----------------+------------------+------------------+------------------+------------------+-----------------+------------------+-----------------+
| 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_ARRAY 함수를 사용하여 열에 데이터에 ARRAY 값이 포함되어 있는지 표시합니다.

SELECT IS_ARRAY(array1),
       IS_ARRAY(array2),
       IS_ARRAY(boolean1)
  FROM multiple_types;

Copy

+------------------+------------------+--------------------+
| IS_ARRAY(ARRAY1) | IS_ARRAY(ARRAY2) | IS_ARRAY(BOOLEAN1) |
|------------------+------------------+--------------------|
| True             | True             | False              |
+------------------+------------------+--------------------+