카테고리:: 반정형 및 정형 데이터 함수 (지도)

MAP_ENTRIES¶

MAP 값의 각 항목에 대해 키-값 페어 오브젝트의 ARRAY 값을 반환합니다.

구문¶

MAP_ENTRIES( <map> )

인자¶

map: 입력 MAP 값입니다.

반환¶

각 요소가 OBJECT <label-data_type_object>`이고 ``key` 필드 및 value 필드가 입력 MAP 값의 항목에 해당하는 ARRAY 값을 반환합니다.

map 이 NULL이면 이 함수는 NULL을 반환합니다.

:samp:`{map}`가 비어 있는 경우, 함수는 빈 ARRAY 값을 반환합니다.

반환된 ARRAY 값의 항목 순서는 정의되지 않았습니다.

사용법 노트¶

함수는 정확히 하나의 인자를 허용합니다. 인자가 없거나 둘 이상의 인자로 함수를 호출하면 오류가 발생합니다.

예¶

MAP 값의 항목을 키-값 페어 오브젝트로 반환합니다.

SELECT MAP_ENTRIES({'a': 1, 'b': 2}::MAP(VARCHAR, INT)) AS entries;

+-----------------+
| ENTRIES         |
|-----------------|
| [               |
|   {             |
|     "key": "a", |
|     "value": 1  |
|   },            |
|   {             |
|     "key": "b", |
|     "value": 2  |
|   }             |
| ]               |
+-----------------+

MAP 값이 비어 있는 경우 빈 ARRAY 값을 반환합니다.

SELECT MAP_ENTRIES({}::MAP(VARCHAR, INT)) AS entries;

+---------+
| ENTRIES |
|---------|
| []      |
+---------+

값이 ARRAY 유형인 MAP 항목의 값을 반환합니다.

SELECT MAP_ENTRIES({'a': [1, 2, 3], 'b': [4, 5]}::MAP(VARCHAR, ARRAY(INT))) AS entries;

+-----------------+
| ENTRIES         |
|-----------------|
| [               |
|   {             |
|     "key": "a", |
|     "value": [  |
|       1,        |
|       2,        |
|       3         |
|     ]           |
|   },            |
|   {             |
|     "key": "b", |
|     "value": [  |
|       4,        |
|       5         |
|     ]           |
|   }             |
| ]               |
+-----------------+

NULL 입력에 대해 NULL을 반환합니다.

SELECT MAP_ENTRIES(NULL::MAP(VARCHAR, INT)) AS entries;

+---------+
| ENTRIES |
|---------|
| NULL    |
+---------+