정형 데이터 타입¶

정형 ARRAY 지정하기¶

정형 ARRAY를 지정하려면 다음 구문을 사용하십시오.

ARRAY( <element_type> [ NOT NULL ] )

여기서

• element_type 은 이 ARRAY에 있는 요소의 Snowflake 데이터 타입 입니다.

  정형 ARRAY, 정형 OBJECT 또는 MAP을 요소 유형으로 지정할 수도 있습니다.

  참고

  Iceberg 테이블 열 정의에서는 VARIANT, 반정형 ARRAY 또는 반정형 OBJECT를 ARRAY 요소의 유형으로 지정할 수 없습니다.

• NOT NULL은 ARRAY에 NULL인 요소를 포함할 수 없음을 지정합니다.

예를 들어 다음 문에서 SYSTEM$TYPEOF 함수가 반환하는 유형을 비교해 보십시오.

• 첫 번째 열 식은 반정형 ARRAY를 정형 ARRAY(NUMBER 요소로 구성된 ARRAY)로 캐스팅합니다.

• 두 번째 열 식은 반정형 ARRAY를 지정합니다.

SELECT
  SYSTEM$TYPEOF(
    [1, 2, 3]::ARRAY(NUMBER)
  ) AS structured_array,
  SYSTEM$TYPEOF(
    [1, 2, 3]
  ) AS semi_structured_array;

+-------------------------------+-----------------------+
| STRUCTURED_ARRAY              | SEMI_STRUCTURED_ARRAY |
|-------------------------------+-----------------------|
| ARRAY(NUMBER(38,0))[LOB]      | ARRAY[LOB]            |
+-------------------------------+-----------------------+

정형 OBJECT 지정하기¶

정형 OBJECT를 지정하려면 다음 구문을 사용하십시오.

OBJECT(
  [
    <key> <value_type> [ NOT NULL ]
    [ , <key> <value_type> [ NOT NULL ] ]
    [ , ... ]
  ]
)

여기서

• key 는 OBJECT에 대한 키를 지정합니다.

  • 오브젝트 정의의 각 key 는 고유해야 합니다.

  • 키의 순서는 오브젝트 정의의 일부입니다. 다른 순서로 된 동일한 키를 가진 두 OBJECT를 비교하는 것은 허용되지 않습니다. (컴파일 시간 오류가 발생합니다.)

  • 키를 지정하지 않지만 괄호는 지정할 경우(즉, OBJECT()를 사용하는 경우) 결과 유형은 키가 없는 정형 OBJECT입니다. 키가 없는 정형 OBJECT는 반정형 OBJECT와는 다릅니다.

• value_type 은 키에 해당하는 값의 Snowflake 데이터 타입 입니다.

  정형 ARRAY, 정형 OBJECT 또는 MAP을 값 유형으로 지정할 수도 있습니다.

  참고

  Iceberg 테이블 열 정의에서는 VARIANT, 반정형 ARRAY 또는 반정형 OBJECT를 OBJECT 키에 해당하는 값의 유형으로 지정할 수 없습니다.

• NOT NULL은 키에 해당하는 값이 NULL일 수 없음을 지정합니다.

예를 들어 다음 문에서 SYSTEM$TYPEOF 함수가 반환하는 유형을 비교해 보십시오.

• 첫 번째 열 식은 반정형 OBJECT를 다음 키와 값을 포함하는 정형 OBJECT로 캐스팅합니다.

  • NULL이 아닌 VARCHAR 값을 가진 str 이라는 키.

  • NUMBER 값을 가진 num 이라는 키.

• 두 번째 열 식은 반정형 OBJECT를 지정합니다.

SELECT
  SYSTEM$TYPEOF(
    {
      'str': 'test',
      'num': 1
    }::OBJECT(
      str VARCHAR NOT NULL,
      num NUMBER
    )
  ) AS structured_object,
  SYSTEM$TYPEOF(
    {
      'str': 'test',
      'num': 1
    }
  ) AS semi_structured_object;

+----------------------------------------------------------------+------------------------+
| STRUCTURED_OBJECT                                              | SEMI_STRUCTURED_OBJECT |
|----------------------------------------------------------------+------------------------|
| OBJECT(str VARCHAR(16777216), num NUMBER(38,0) NOT NULL )[LOB] | OBJECT[LOB]            |
+----------------------------------------------------------------+------------------------+

MAP 지정하기¶

MAP을 지정하려면 다음 구문을 사용하십시오.

MAP( <key_type> , <value_type> [ NOT NULL ] )

여기서

• key_type 은 맵 키의 Snowflake 데이터 타입 입니다. 키에는 다음 유형 중 하나를 사용해야 합니다.

  • VARCHAR

  • 소수 자릿수가 0인 NUMBER

  부동 소수점 데이터 타입을 키 유형으로 사용할 수 없습니다.

  맵 키는 NULL일 수 없습니다.

• value_type 은 맵에 있는 값의 Snowflake 데이터 타입 입니다.

  정형 ARRAY, 정형 OBJECT 또는 MAP을 값 유형으로 지정할 수도 있습니다.

  참고

  Iceberg 테이블 열 정의에서는 VARIANT, 반정형 ARRAY 또는 반정형 OBJECT를 MAP의 값 유형으로 지정할 수 없습니다.

• NOT NULL은 키에 해당하는 값이 NULL일 수 없음을 지정합니다. NOT NULL은 값이 NULL일 수 없음을 지정합니다.

다음 예에서는 반정형 OBJECT를 MAP으로 캐스팅하고 SYSTEM$TYPEOF 함수를 사용하여 오브젝트의 결과 유형을 인쇄합니다. MAP은 VARCHAR 키를 VARCHAR 값과 연결합니다.

SELECT
  SYSTEM$TYPEOF(
    {
      'a_key': 'a_val',
      'b_key': 'b_val'
    }::MAP(VARCHAR, VARCHAR)
  ) AS map_example;

+------------------------------------------------+
| MAP_EXAMPLE                                    |
|------------------------------------------------|
| map(VARCHAR(16777216), VARCHAR(16777216))[LOB] |
+------------------------------------------------+

반정형 유형을 정형 유형으로 명시적으로 캐스팅하기¶

반정형 오브젝트를 정형 유형으로 명시적으로 캐스팅하려면 CAST 함수를 호출하거나 :: 연산자를 사용 하면 됩니다.

다음과 같은 반정형 오브젝트만 해당 정형 유형으로 캐스팅할 수 있습니다. 그렇지 않으면 런타임 오류가 발생합니다.

다음 섹션에서는 유형이 캐스팅되는 방법에 대한 자세한 내용을 제공합니다.

• 반정형 ARRAY 및 VARIANT를 정형 ARRAY로 캐스팅하기

• 반정형 OBJECT 및 VARIANT를 정형 OBJECT로 캐스팅하기

• 반정형 OBJECT 및 VARIANT를 MAP으로 캐스팅하기

SELECT
  SYSTEM$TYPEOF(
    CAST ([1,2,3] AS ARRAY(NUMBER))
  ) AS array_cast_type,
  SYSTEM$TYPEOF(
    CAST ([1,2,3]::VARIANT AS ARRAY(NUMBER))
  ) AS variant_cast_type;

SELECT
  SYSTEM$TYPEOF(
    [1,2,3]::ARRAY(NUMBER)
  ) AS array_cast_type,
  SYSTEM$TYPEOF(
    [1,2,3]::VARIANT::ARRAY(NUMBER)
  ) AS variant_cast_type;

+--------------------------+--------------------------+
| ARRAY_CAST_TYPE          | VARIANT_CAST_TYPE        |
|--------------------------+--------------------------|
| ARRAY(NUMBER(38,0))[LOB] | ARRAY(NUMBER(38,0))[LOB] |
+--------------------------+--------------------------+

SELECT
  SYSTEM$TYPEOF(
    CAST ({'city':'San Mateo','state':'CA'} AS OBJECT(city VARCHAR, state VARCHAR))
  ) AS object_cast_type,
  SYSTEM$TYPEOF(
    CAST ({'city':'San Mateo','state':'CA'}::VARIANT AS OBJECT(city VARCHAR, state VARCHAR))
  ) AS variant_cast_type;

SELECT
  SYSTEM$TYPEOF(
     {'city':'San Mateo','state':'CA'}::OBJECT(city VARCHAR, state VARCHAR)
  ) AS object_cast_type,
  SYSTEM$TYPEOF(
     {'city':'San Mateo','state':'CA'}::VARIANT::OBJECT(city VARCHAR, state VARCHAR)
  ) AS variant_cast_type;

+--------------------------------------------------------------+--------------------------------------------------------------+
| OBJECT_CAST_TYPE                                             | VARIANT_CAST_TYPE                                            |
|--------------------------------------------------------------+--------------------------------------------------------------|
| OBJECT(city VARCHAR(16777216), state VARCHAR(16777216))[LOB] | OBJECT(city VARCHAR(16777216), state VARCHAR(16777216))[LOB] |
+--------------------------------------------------------------+--------------------------------------------------------------+

SELECT
  SYSTEM$TYPEOF(
    CAST ({'my_key':'my_value'} AS MAP(VARCHAR, VARCHAR))
  ) AS map_cast_type,
  SYSTEM$TYPEOF(
    CAST ({'my_key':'my_value'} AS MAP(VARCHAR, VARCHAR))
  ) AS variant_cast_type;

SELECT
  SYSTEM$TYPEOF(
    {'my_key':'my_value'}::MAP(VARCHAR, VARCHAR)
  ) AS map_cast_type,
  SYSTEM$TYPEOF(
    {'my_key':'my_value'}::VARIANT::MAP(VARCHAR, VARCHAR)
  ) AS variant_cast_type;

+------------------------------------------------+------------------------------------------------+
| MAP_CAST_TYPE                                  | VARIANT_CAST_TYPE                              |
|------------------------------------------------+------------------------------------------------|
| map(VARCHAR(16777216), VARCHAR(16777216))[LOB] | map(VARCHAR(16777216), VARCHAR(16777216))[LOB] |
+------------------------------------------------+------------------------------------------------+

정형 유형을 반정형 유형으로 명시적으로 캐스팅하기¶

정형 유형을 반정형 유형으로 명시적으로 캐스팅하려면 CAST 함수를 호출하거나, :: 연산자를 사용하거나 변환 함수(예: TO_ARRAY, TO_OBJECT 또는 TO_VARIANT) 중 하나를 호출할 수 있습니다.

예:

• col_structured_array 가 ARRAY 인 경우(VARCHAR):

  • CAST(col_structured_array AS ARRAY)는 반정형 ARRAY를 반환합니다.

  • CAST(col_structured_array AS VARIANT)는 반정형 ARRAY를 보유하는 VARIANT를 반환합니다.

• col_structured_object 가 OBJECT(이름 VARCHAR, 상태 VARCHAR)인 경우:

  • CAST(col_structured_object AS OBJECT)는 반정형 OBJECT를 반환합니다.

  • CAST(col_structured_object AS VARIANT)는 반정형 OBJECT를 보유하는 VARIANT를 반환합니다.

• col_map 이 MAP인 경우(VARCHAR, VARCHAR):

  • CAST(col_map AS OBJECT)는 반정형 OBJECT를 반환합니다.

  • CAST(col_map AS VARIANT)는 반정형 OBJECT를 보유하는 VARIANT를 반환합니다.

다음 사항을 참고하십시오.

• 반정형 OBJECT로 캐스팅하는 경우 정형 OBJECT의 키 순서는 유지되지 않습니다.

• 정형 OBJECT 또는 MAP을 반정형 OBJECT 또는 VARIANT로 캐스팅하는 경우 모든 NULL 값은 JSON null 값 으로 변환됩니다.

  정형 ARRAY를 VARIANT로 캐스팅하는 경우 NULL 값은 그대로 유지됩니다.

  SELECT [1,2,NULL,3]::ARRAY(INTEGER)::VARIANT;
  

  Copy

  +---------------------------------------+
  | [1,2,NULL,3]::ARRAY(INTEGER)::VARIANT |
  |---------------------------------------|
  | [                                     |
  |   1,                                  |
  |   2,                                  |
  |   undefined,                          |
  |   3                                   |
  | ]                                     |
  +---------------------------------------+
  

• 키에 대해 NUMBER 유형을 사용하는 MAP을 캐스팅하는 경우 MAP 키는 반환된 OBJECT에서 문자열로 변환됩니다.

값을 암시적으로 캐스팅하기(강제 변환)¶

한 정형 유형에서 다른 정형 유형으로 암시적으로 캐스팅(강제 변환) 하는 데는 다음 규칙이 적용됩니다.

• 두 가지 기본 오브젝트 유형이 동일한 경우 정형 유형은 다른 정형 유형으로 강제 변환될 수 있습니다.

  • 첫 번째 요소 유형이 두 번째 요소 유형으로 강제 변환 가능한 경우 한 유형의 ARRAY는 다른 유형의 ARRAY로 강제 변환될 수 있습니다.

    다음과 같은 경우에 요소 유형이 다른 요소 유형으로 강제 변환될 수 있습니다.

    • 두 유형 모두 숫자인 경우. 다음과 같은 경우에 지원됩니다.

      • 둘 다 동일한 숫자 유형을 사용하지만 전체 자릿수 및/또는 소수 자릿수가 다를 수 있는 경우.

      • NUMBER를 FLOAT로 강제 변환하는 경우(그 반대도 마찬가지임).

    • 두 유형 모두 타임스탬프인 경우. 다음과 같은 경우에 지원됩니다.

      • 둘 다 동일한 유형을 사용하지만 전체 자릿수가 다를 수 있는 경우.

      • TIMESTAMP_LTZ를 TIMESTAMP_TZ로 강제 변환하는 경우(그 반대도 마찬가지임).

    예:

    • ARRAY(NUMBER)는 ARRAY(DOUBLE)로 강제 변환될 수 있습니다.

    • ARRAY(DATE)는 ARRAY(NUMBER)로 강제 변환될 수 없습니다.

  • 다음 조건이 모두 참인 경우에만 한 가지 유형 정의가 있는 OBJECT가 다른 유형 정의가 있는 OBJECT로 강제 변환될 수 있습니다.

    • 두 OBJECT 유형 모두 동일한 수의 키를 갖습니다.

    • 두 OBJECT 유형 모두 키에 동일한 이름을 사용합니다.

    • 두 OBJECT 유형에서 모두 키가 동일한 순서로 되어 있습니다.

    • 한 OBJECT 유형에서 각 값의 유형은 다른 OBJECT 유형의 해당 값 유형으로 강제 변환될 수 있습니다.

      정형 ARRAY의 요소 유형과 마찬가지로, 다음과 같은 경우에만 한 값의 유형을 다른 유형으로 강제 변환할 수 있습니다.

      • 두 유형 모두 숫자인 경우. 다음과 같은 경우에 지원됩니다.

        • 둘 다 동일한 숫자 유형을 사용하지만 전체 자릿수 및/또는 소수 자릿수가 다를 수 있는 경우.

        • NUMBER를 FLOAT로 강제 변환하는 경우(그 반대도 마찬가지임).

      • 두 유형 모두 타임스탬프인 경우. 다음과 같은 경우에 지원됩니다.

        • 둘 다 동일한 유형을 사용하지만 전체 자릿수가 다를 수 있는 경우.

        • TIMESTAMP_LTZ를 TIMESTAMP_TZ로 강제 변환하는 경우(그 반대도 마찬가지임).

    예:

    • OBJECT(city VARCHAR, zipcode NUMBER)는 OBJECT(city VARCHAR, zipcode DOUBLE)로 강제 변환될 수 있습니다.

    • OBJECT(city VARCHAR, zipcode NUMBER)는 OBJECT(city VARCHAR, zipcode DATE)로 강제 변환될 수 없습니다.

  • 다음과 같은 경우 값 유형이 하나인 MAP이 값 유형이 다른 MAP으로 강제 변환될 수 있습니다.

    • 두 값 유형 모두 숫자인 경우. 다음과 같은 경우에 지원됩니다.

      • 둘 다 동일한 숫자 유형을 사용하지만 전체 자릿수 및/또는 소수 자릿수가 다를 수 있는 경우.

      • NUMBER를 FLOAT로 강제 변환하는 경우(그 반대도 마찬가지임).

    • 두 값 유형 모두 타임스탬프인 경우. 다음과 같은 경우에 지원됩니다.

      • 둘 다 동일한 유형을 사용하지만 전체 자릿수가 다를 수 있는 경우.

      • TIMESTAMP_LTZ를 TIMESTAMP_TZ로 강제 변환하는 경우(그 반대도 마찬가지임).

    예를 들어, MAP(VARCHAR, NUMBER)는 MAP(VARCHAR, DOUBLE)으로 강제 변환될 수 있습니다.

  • 두 키 유형 모두 전체 자릿수만 다른 동일한 정수 NUMERIC 유형을 사용하는 경우 키 유형이 하나인 MAP은 키 유형이 다른 MAP으로 강제 변환될 수 있습니다.

    예를 들어, MAP(VARCHAR, NUMBER)는 MAP(NUMBER, NUMBER)으로 강제 변환될 수 없습니다.

• 정형 유형은 반정형 오브젝트로 강제 변환될 수 없습니다(그 반대도 마찬가지임).

• VARCHAR 값은 정형 유형으로 강제 변환될 수 없습니다.

한 정형 유형에서 다른 정형 유형으로 캐스팅하기¶

CAST 함수를 호출하거나 :: 연산자를 사용하여 한 정형 유형에서 다른 정형 유형으로 캐스팅할 수 있습니다. 다음 정형 유형 간에 캐스팅할 수 있습니다.

• 정형 ARRAY의 경우:

  한 유형의 ARRAY를 다른 유형의 ARRAY로 캐스팅할 수 있습니다.

• 정형 OBJECT의 경우:

  • 캐스트를 사용하여 OBJECT에서 키-값 페어의 순서를 변경 할 수 있습니다.

  • 캐스트를 사용하여 OBJECT에서 키 이름을 변경 할 수 있습니다.

  • 캐스트를 사용하여 OBJECT에 키를 추가 할 수 있습니다.

  • 정형 OBJECT를 MAP으로 캐스팅할 수 있습니다.

• MAPs의 경우:

  • 특정 유형의 키와 값이 있는 MAP을 다른 유형의 키와 값이 있는 MAP으로 캐스팅할 수 있습니다.

  • MAP을 정형 OBJECT로 캐스팅할 수 있습니다.

한 유형에서 다른 유형으로 값을 캐스팅할 수 없으면 캐스트가 실패합니다. 예를 들어, ARRAY(BOOLEAN)을 ARRAY(DATE)로 캐스팅하려는 시도는 실패합니다.

SELECT CAST(
  CAST([1,2,3] AS ARRAY(NUMBER))
  AS ARRAY(VARCHAR)
);

SELECT CAST(
  {'city': 'San Mateo','state': 'CA'}::OBJECT(city VARCHAR, state VARCHAR)
  AS OBJECT(state VARCHAR, city VARCHAR)
);

SELECT CAST({'city':'San Mateo','state': 'CA'}::OBJECT(city VARCHAR, state VARCHAR)
  AS OBJECT(city_name VARCHAR, state_name VARCHAR) RENAME FIELDS);

+------------------------------------------------------------------------------+
| CAST({'CITY':'SAN MATEO','STATE': 'CA'}::OBJECT(CITY VARCHAR, STATE VARCHAR) |
|   AS OBJECT(CITY_NAME VARCHAR, STATE_NAME VARCHAR) RENAME FIELDS)            |
|------------------------------------------------------------------------------|
| {                                                                            |
|   "city_name": "San Mateo",                                                  |
|   "state_name": "CA"                                                         |
| }                                                                            |
+------------------------------------------------------------------------------+

SELECT CAST({'city':'San Mateo','state': 'CA'}::OBJECT(city VARCHAR, state VARCHAR)
  AS OBJECT(city VARCHAR, state VARCHAR, zipcode NUMBER) ADD FIELDS);

+------------------------------------------------------------------------------+
| CAST({'CITY':'SAN MATEO','STATE': 'CA'}::OBJECT(CITY VARCHAR, STATE VARCHAR) |
|   AS OBJECT(CITY VARCHAR, STATE VARCHAR, ZIPCODE NUMBER) ADD FIELDS)         |
|------------------------------------------------------------------------------|
| {                                                                            |
|   "city": "San Mateo",                                                       |
|   "state": "CA",                                                             |
|   "zipcode": null                                                            |
| }                                                                            |
+------------------------------------------------------------------------------+

SQL 함수를 사용하여 정형 ARRAY 및 OBJECT 생성하기¶

다음 함수는 반정형 ARRAY를 생성합니다.

• ARRAY_CONSTRUCT

• ARRAY_CONSTRUCT_COMPACT

• ARRAY_AGG

• TO_ARRAY

다음 함수는 반정형 OBJECT를 생성합니다.

• OBJECT_CONSTRUCT

• OBJECT_CONSTRUCT_KEEP_NULL

• OBJECT_AGG

• TO_OBJECT

정형 ARRAY 또는 OBJECT를 생성하려면 이러한 함수를 사용하고 함수의 반환 값을 명시적으로 캐스팅하십시오. 예:

SELECT ARRAY_CONSTRUCT(10, 20, 30)::ARRAY(NUMBER);

SELECT OBJECT_CONSTRUCT(
  'name', 'abc',
  'created_date', '2020-01-18'::DATE
)::OBJECT(
  name VARCHAR,
  created_date DATE
);

자세한 내용은 반정형 유형을 정형 유형으로 명시적으로 캐스팅하기 섹션을 참조하십시오.

ARRAY 및 OBJECT 상수를 사용하여 정형 ARRAY 및 OBJECT 생성하기¶

ARRAY 상수 또는 OBJECT 상수 를 지정하면 반정형 ARRAY 또는 OBJECT를 지정하게 됩니다.

정형 ARRAY 또는 OBJECT를 생성하려면 식을 명시적으로 캐스팅해야 합니다. 예:

SELECT [10, 20, 30]::ARRAY(NUMBER);

SELECT {
  'name': 'abc',
  'created_date': '2020-01-18'::DATE
}::OBJECT(
  name VARCHAR,
  created_date DATE
);

자세한 내용은 반정형 유형을 정형 유형으로 명시적으로 캐스팅하기 섹션을 참조하십시오.

MAP 구성하기¶

MAP을 생성하려면 반정형 오브젝트를 생성하고 OBJECT를 MAP으로 캐스팅합니다.

예를 들어 다음 문은 모두 MAP {'city'->'San Mateo','state'->'CA'} 를 생성합니다.

SELECT OBJECT_CONSTRUCT(
  'city', 'San Mateo',
  'state', 'CA'
)::MAP(
  VARCHAR,
  VARCHAR
);

SELECT {
  'city': 'San Mateo',
  'state': 'CA'
}::MAP(
  VARCHAR,
  VARCHAR
);

다음 문은 MAP {-10->'CA',-20->'OR'} 를 생성합니다.

SELECT {
  '-10': 'CA',
  '-20': 'OR'
}::MAP(
  NUMBER,
  VARCHAR
)

자세한 내용은 반정형 OBJECT 및 VARIANT를 MAP으로 캐스팅하기 섹션을 참조하십시오.

정형 OBJECT에서 키 목록 가져오기¶

정형 OBJECT의 키 목록을 가져오려면 OBJECT_KEYS 함수를 호출하십시오.

SELECT OBJECT_KEYS({'city':'San Mateo','state':'CA'}::OBJECT(city VARCHAR, state VARCHAR));

입력값이 정형 OBJECT인 경우 함수는 키가 포함된 ARRAY(VARCHAR)를 반환합니다. 입력값이 반정형 OBJECT인 경우 함수는 ARRAY를 반환합니다.

MAP에서 키 목록 가져오기¶

MAP의 키 목록을 가져오려면 MAP_KEYS 함수를 호출하십시오.

SELECT MAP_KEYS({'my_key':'my_value'}::MAP(VARCHAR,VARCHAR));

정형 유형의 값 및 요소에 액세스하기¶

다음 메서드를 사용하여 정형 ARRAY, 정형 OBJECT, MAP의 값과 요소에 액세스할 수 있습니다.

• GET 함수

• GET_IGNORE_CASE 함수

• GET_PATH 함수

• 점 표기법

• 대괄호 표기법

반환된 값과 요소에는 VARIANT이 아닌 오브젝트에 대해 지정된 유형이 있습니다.

다음 예에서는 반정형 ARRAY 및 ARRAY(VARCHAR)의 첫 번째 요소를 SYSTEM$TYPEOF 함수에 전달하여 해당 요소의 데이터 타입을 반환합니다.

SELECT
  SYSTEM$TYPEOF(
    ARRAY_CONSTRUCT('San Mateo')[0]
  ) AS semi_structured_array_element,
  SYSTEM$TYPEOF(
    CAST(
      ARRAY_CONSTRUCT('San Mateo') AS ARRAY(VARCHAR)
    )[0]
  ) AS structured_array_element;

+-------------------------------+-----------------------------+
| SEMI_STRUCTURED_ARRAY_ELEMENT | STRUCTURED_ARRAY_ELEMENT    |
|-------------------------------+-----------------------------|
| VARIANT[LOB]                  | VARCHAR(16777216)[LOB]      |
+-------------------------------+-----------------------------+

다음 사항을 참고하십시오.

• 정형 OBJECT를 GET 또는 GET_IGNORE_CASE 함수에 전달할 때 키에 대한 상수를 지정해야 합니다.

  MAP 또는 정형 ARRAY를 GET 함수에 전달하는 경우 상수를 지정할 필요가 없습니다.

  MAP을 GET_IGNORE_CASE 함수에 전달하는 경우에도 상수를 지정할 필요가 없습니다.

• 정형 OBJECT, 정형 ARRAY 또는 MAP을 GET_PATH 함수에 전달할 때 경로 이름에 대한 상수를 지정해야 합니다.

• 정형 오브젝트의 경우 존재하지 않는 경로 또는 OBJECT 키를 사용하면 컴파일 시간 오류가 발생합니다.

  반면, 반정형 오브젝트에 존재하지 않는 인덱스, 키 또는 경로를 사용하는 경우 함수는 NULL을 반환합니다.

정형 ARRAY의 크기 확인하기¶

정형 ARRAY의 크기를 확인하려면 ARRAY를 ARRAY_SIZE 함수에 전달하십시오.

SELECT ARRAY_SIZE([1,2,3]::ARRAY(NUMBER));

MAP의 크기 확인하기¶

MAP의 크기를 확인하려면 MAP을 MAP_SIZE 함수에 전달하십시오.

SELECT MAP_SIZE({'my_key':'my_value'}::MAP(VARCHAR,VARCHAR));

정형 ARRAY에서 요소 조회하기¶

정형 ARRAY에 요소가 있는지 확인하려면 ARRAY_CONTAINS 함수를 호출하십시오. 예:

SELECT ARRAY_CONTAINS(10, [1, 10, 100]::ARRAY(NUMBER));

정형 ARRAY에서 요소의 위치를 확인하려면 ARRAY_POSITION 함수를 호출하십시오. 예:

SELECT ARRAY_POSITION(10, [1, 10, 100]::ARRAY(NUMBER));

MAP에 키가 포함되어 있는지 확인하기¶

MAP에 키가 포함되어 있는지 확인하려면 MAP_CONTAINS_KEY 함수를 호출하십시오.

예:

SELECT MAP_CONTAINS_KEY('key_to_find', my_map);

SELECT MAP_CONTAINS_KEY(10, my_map);

정형 오브젝트와 반정형 오브젝트 비교하기¶

정형 ARRAY, 정형 OBJECT 또는 MAP을 반정형 ARRAY, OBJECT 또는 VARIANT와 비교할 수 없습니다.

정형 오브젝트와 다른 정형 오브젝트 비교하기¶

동일한 유형의 두 오브젝트를 비교할 수 있습니다(예: 정형 ARRAY 2개, 정형 OBJECT 2개 또는 MAP 2개).

현재, 정형 유형을 비교하기 위해 다음과 같은 비교 연산자가 지원됩니다.

• =

• !=

• <

• <=

• >=

• >

두 정형 오브젝트가 동일한지 비교할 때 다음 사항에 유의하십시오.

• 한 유형을 다른 유형으로 강제 변환 할 수 없으면 비교가 실패합니다.

• 숫자 키가 있는 MAP을 비교할 때 키는 (VARCHAR 값이 아니라) 숫자로 비교됩니다.

<, <=, >= 또는 > 을 사용하여 두 정형 오브젝트를 비교할 때 정형 오브젝트 필드는 사전순으로 비교됩니다. 예를 들어 다음 오브젝트는

{'a':2,'b':1}::OBJECT(b INTEGER,a INTEGER)

다음 오브젝트보다 큽니다.

{'a':1,'b':2}::OBJECT(b INTEGER,a INTEGER)

두 ARRAY의 중첩 여부 확인하기¶

정형 ARRAY 2개로 구성된 요소가 중첩되는지 확인해야 하는 경우 ARRAYS_OVERLAP 함수를 호출하십시오. 예:

SELECT ARRAYS_OVERLAP(numeric_array, other_numeric_array);

ARRAY는 비교 가능한 유형 이어야 합니다.

반정형 ARRAY 및 정형 ARRAY를 이 함수에 전달할 수 없습니다. 두 ARRAY 모두 정형 또는 반정형 중 하나여야 합니다.

정형 ARRAY 변환하기¶

정형 ARRAY를 이러한 함수에 전달하면 함수는 동일한 유형의 정형 ARRAY를 반환합니다.

• ARRAY_APPEND

• ARRAY_CAT

• ARRAY_COMPACT

• ARRAY_EXCEPT

• ARRAY_INSERT

• ARRAY_INTERSECTION

• ARRAY_PREPEND

• ARRAY_SLICE

• ARRAY_UNION_AGG

다음 섹션에서는 이러한 함수가 정형 ARRAY에서 작동하는 방식을 설명합니다.

• 배열에 요소를 추가하는 함수

• 여러 ARRAY를 입력으로 허용하는 함수

SELECT ARRAY_APPEND( [1,2]::ARRAY(DOUBLE), 3::NUMBER );

SELECT ARRAY_APPEND( [1,2]::ARRAY(DOUBLE), '3' );

SELECT ARRAY_APPEND( [1,2]::ARRAY(NUMBER), '2022-02-02'::DATE );

SELECT ARRAY_CAT( [1,2]::ARRAY(NUMBER), ['3','4'] );

SELECT ARRAY_CAT( [1,2], ['3','4']::ARRAY(VARCHAR) );

SELECT
  ARRAY_CAT(
    [1, 2, 3]::ARRAY(NUMBER NOT NULL),
    [5.5, NULL]::ARRAY(NUMBER(2, 1))
  ) AS concatenated_array,
  SYSTEM$TYPEOF(concatenated_array);

+--------------------+-----------------------------------+
| CONCATENATED_ARRAY | SYSTEM$TYPEOF(CONCATENATED_ARRAY) |
|--------------------+-----------------------------------|
| [                  | ARRAY(NUMBER(38,1))[LOB]          |
|   1,               |                                   |
|   2,               |                                   |
|   3,               |                                   |
|   5.5,             |                                   |
|   undefined        |                                   |
| ]                  |                                   |
+--------------------+-----------------------------------+

SELECT ARRAY_EXCEPT( [1,2]::ARRAY(NUMBER), [2,3]::ARRAY(DOUBLE) );

SELECT ARRAY_EXCEPT( [1,2]::ARRAY(NUMBER), ['2','3']::ARRAY(VARCHAR) );

정형 OBJECT 변환하기¶

다음 섹션에서는 다른 OBJECT에서 변환된 정형 OBJECT를 반환하는 방법을 설명합니다.

• 키-값 페어 제거하기

• 키-값 페어 삽입 및 값 업데이트하기

• 기존 OBJECT에서 키-값 페어 선택하기

키-값 페어의 순서를 변경하거나, 키 이름을 바꾸거나, 값을 지정하지 않고 키를 추가해야 하는 경우에는 CAST 함수 또는 :: 연산자 를 사용하십시오. 자세한 내용은 한 정형 유형에서 다른 정형 유형으로 캐스팅하기 섹션을 참조하십시오.

MAP 변환하기¶

MAP을 변환하려면 다음 함수를 사용하십시오.

• MAP_CAT

• MAP_DELETE

• MAP_INSERT

• MAP_PICK

정형 유형과 함께 FLATTEN 함수 사용하기¶

정형 ARRAY, 정형 OBJECT, MAP을 FLATTEN 함수에 전달할 수 있습니다. 반정형 데이터 타입의 경우와 마찬가지로, PATH 인자를 사용하여 평면화되는 값을 지정할 수 있습니다.

• 평면화되는 값이 정형 ARRAY이고 RECURSIVE 인자가 FALSE인 경우 value 열에는 ARRAY와 동일한 유형의 값이 포함됩니다.

  예:

  SELECT value, SYSTEM$TYPEOF(value)
    FROM TABLE(FLATTEN(INPUT => [1.08, 2.13, 3.14]::ARRAY(DOUBLE)));
  

  Copy

  +-------+----------------------+
  | VALUE | SYSTEM$TYPEOF(VALUE) |
  |-------+----------------------|
  |  1.08 | FLOAT[DOUBLE]        |
  |  2.13 | FLOAT[DOUBLE]        |
  |  3.14 | FLOAT[DOUBLE]        |
  +-------+----------------------+
  

• 평면화되는 값이 MAP이고 RECURSIVE 인자가 FALSE인 경우 key 열에는 MAP 키와 동일한 유형의 키가 포함되고 value 열에는 MAP 값과 동일한 유형의 값이 포함됩니다.

  예:

  SELECT key, SYSTEM$TYPEOF(key), value, SYSTEM$TYPEOF(value)
    FROM TABLE(FLATTEN(INPUT => {'my_key': 'my_value'}::MAP(VARCHAR, VARCHAR)));
  

  Copy

  +--------+------------------------+----------+------------------------+
  | KEY    | SYSTEM$TYPEOF(KEY)     | VALUE    | SYSTEM$TYPEOF(VALUE)   |
  |--------+------------------------+----------+------------------------|
  | my_key | VARCHAR(16777216)[LOB] | my_value | VARCHAR(16777216)[LOB] |
  +--------+------------------------+----------+------------------------+
  

• 그렇지 않으면 key 및 value 열의 유형은 VARIANT입니다.

MAP의 경우 반환된 키와 값의 순서가 불명확합니다.

PARSE_JSON 함수 사용하기¶

PARSE_JSON 함수는 정형 유형을 반환하지 않습니다.

집합 연산자 및 CASE 식과 함께 정형 유형 사용하기¶

다음 섹션에서 정형 ARRAY, 정형 OBJECT, MAP을 사용할 수 있습니다.

• 집합 연산자(예: UNION ALL)로 결합된 쿼리 식.

• CASE 식.

집합 연산자의 경우, 서로 다른 식에서 서로 다른 유형이 사용되는 경우(예: 한 유형이 ARRAY(NUMBER)이고 다른 유형이 ARRAY(DOUBLE)인 경우) 한 유형이 다른 유형으로 강제 변환됩니다.

다른 반정형 함수 사용하기¶

다음 함수는 정형 ARRAY, 정형 OBJECT 또는 MAP을 입력 인자로 허용하지 않습니다.

• AS_ARRAY

• AS_OBJECT

• IS_ARRAY

• IS_OBJECT

• TYPEOF

정형 유형을 입력값으로 전달하면 오류가 발생합니다.

SHOW COLUMNS 명령을 사용하여 정형 유형 정보 보기¶

SHOW COLUMNS 명령의 출력에서 data_type 열에는 요소, 키, 값의 유형에 대한 정보가 포함됩니다.

DESCRIBE 및 기타 SHOW 명령을 사용하여 정형 유형 정보 보기¶

다음 명령의 출력에는 정형 유형에 대한 정보가 포함됩니다.

• DESCRIBE TABLE

• DESCRIBE RESULT

• DESCRIBE FUNCTION

• DESCRIBE PROCEDURE

• SHOW FUNCTIONS

• SHOW PROCEDURES

예를 들어, DESCRIBE RESULT 출력에서 MAP(VARCHAR, VARCHAR) 열의 행에는 type 열에 다음 값이 포함됩니다.

map(VARCHAR(16777216), VARCHAR(16777216))

ARRAY(NUMBER) 열의 행에는 type 열에 다음 값이 포함됩니다.

ARRAY(NUMBER(38,0))

데이터베이스에 사용된 정형 유형에 대한 정보 보기¶

정형 유형 열의 경우 INFORMATION_SCHEMA COLUMNS 뷰 는 열의 기본 데이터 타입(ARRAY, OBJECT 또는 MAP)에 대한 정보만 제공합니다.

예를 들어, data_type 열에는 《ARRAY》, 《OBJECT》 또는 《MAP》만 포함됩니다. 열에는 요소, 키 또는 값의 유형이 포함되지 않습니다.

요소, 키, 값의 유형에 대한 정보를 보려면 다음 뷰를 사용하십시오.

• 정형 ARRAY의 요소 유형에 대한 자세한 내용을 보려면 INFORMATION_SCHEMA의 ELEMENT_TYPES 뷰 또는 ACCOUNT_USAGE의 ELEMENT_TYPES 뷰 를 쿼리하십시오.

• 정형 OBJECT 및 MAP의 키 및 값 유형에 대한 자세한 내용을 보려면 INFORMATION_SCHEMA의 FIELDS 뷰 또는 ACCOUNT_USAGE의 FIELDS 뷰 를 쿼리하십시오.