IS_OBJECT

IS_OBJECT (객체 확인)

VARIANT 인자가 OBJECT 값을 포함하면 TRUE를 반환해요.

출처: Snowflake SQL Reference - IS_OBJECT

본문

구문 (Syntax)

IS_OBJECT( <variant_expr> )

인자 (Arguments)

variant_expr

VARIANT 타입의 값으로 평가되는 표현식이에요.

반환 값 (Returns)

BOOLEAN 값 또는 NULL을 반환해요.

VARIANT 값이 OBJECT 값을 포함하면 TRUE, 그렇지 않으면 FALSE를 반환해요.

입력이 NULL이면 오류를 보고하지 않고 NULL을 반환해요.

사용 참고 사항 (Usage notes)

이 함수는 입력 인자로 구조화된 타입(structured type)을 지원하지 않아요.

예시 (Examples)

다음 예시들은 IS_OBJECT 함수를 사용해요.

WHERE 절에서 IS_OBJECT 함수 사용

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_OBJECT 함수를 사용해 데이터에서 OBJECT 값을 보여줘요:

SELECT * FROM vartab WHERE IS_OBJECT(v);

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

SELECT 목록에서 IS_OBJECT 함수 사용

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_OBJECT 함수를 사용해 열이 데이터에서 OBJECT 값을 포함하는지 보여줘요:

SELECT IS_OBJECT(array1), IS_OBJECT(boolean1), IS_OBJECT(object1)
  FROM multiple_types;

+-------------------+---------------------+--------------------+
| IS_OBJECT(ARRAY1) | IS_OBJECT(BOOLEAN1) | IS_OBJECT(OBJECT1) |
|-------------------+---------------------+--------------------|
| False             | False               | True               |
+-------------------+---------------------+--------------------+

더 알아보기 (Learn more)