MIN_MAP

Description

The MIN_MAP function aggregates MAP values by key and returns a MAP that contains the minimum non-NULL value for each key.

Usage Notes

The order of entries in the returned MAP is not guaranteed. Use map_keys, map_values, array_sort, and array_sortby when stable output order is required. A NULL key is aggregated as a regular key; all NULL keys belong to the same result entry.

Syntax

MIN_MAP(<map_expr>)

Parameters

Parameter	Description
<map_expr>	A MAP expression. The MAP value type must be comparable by the MIN aggregate function.

Return Value

Returns a MAP with the same key type as <map_expr>. For DecimalV2 value types, the returned value type is the corresponding DecimalV3 type. For other value types, the returned value type is the same as the input MAP value type.

If there is no valid input row in the group, returns an empty MAP. If a key appears but all values for that key are NULL, the value for that key is NULL.

Example

-- setup
CREATE TABLE map_agg_example (
    id INT,
    m MAP<INT, INT>,
    ms MAP<INT, STRING>
) DISTRIBUTED BY HASH(id) BUCKETS 1
PROPERTIES ("replication_num" = "1");

INSERT INTO map_agg_example VALUES
    (1, MAP(1, 10, 2, 20), MAP(1, 'b', 2, 'x')),
    (1, MAP(2, 5, 3, 30), MAP(1, 'a', 3, NULL)),
    (2, MAP(1, 7, 4, NULL), MAP(2, 'z')),
    (2, CAST(MAP() AS MAP<INT, INT>), CAST(MAP() AS MAP<INT, STRING>));

Query OK

SELECT id,
       array_sort(map_keys(result)) AS keys,
       array_sortby(map_values(result), map_keys(result)) AS values
FROM (
    SELECT id, MIN_MAP(m) AS result
    FROM map_agg_example
    GROUP BY id
) t
ORDER BY id;

+------+-----------+-------------+
| id   | keys      | values      |
+------+-----------+-------------+
|    1 | [1, 2, 3] | [10, 5, 30] |
|    2 | [1, 4]    | [7, null]   |
+------+-----------+-------------+

SELECT id,
       array_sort(map_keys(result)) AS keys,
       array_sortby(map_values(result), map_keys(result)) AS values
FROM (
    SELECT id, MIN_MAP(ms) AS result
    FROM map_agg_example
    GROUP BY id
) t
ORDER BY id;

+------+-----------+----------------+
| id   | keys      | values         |
+------+-----------+----------------+
|    1 | [1, 2, 3] | ["a", "x", null] |
|    2 | [2]       | ["z"]          |
+------+-----------+----------------+

SELECT array_sort(map_keys(result)) AS keys,
       array_sortby(map_values(result), map_keys(result)) AS values
FROM (
    SELECT MIN_MAP(m) AS result
    FROM map_agg_example
    WHERE id = 100
) t;

+------+--------+
| keys | values |
+------+--------+
| []   | []     |
+------+--------+