cardinality

MAP 値の要素数を返します。MAP はキーと値のペアの無順序コレクションで、例えば {"a":1, "b":2} のようなものです。1 つのキーと値のペアが 1 つの要素を構成します。{"a":1, "b":2} は 2 つの要素を含みます。

この関数は v3.0 以降でサポートされています。map_size() の別名です。

構文

INT cardinality(any_map)

パラメータ

any_map: 要素数を取得したい MAP 値。

戻り値

INT 型の値を返します。

入力が NULL の場合、NULL が返されます。

MAP 値のキーまたは値が NULL の場合、NULL は通常の値として処理されます。

例

StarRocks 内部テーブルから MAP データをクエリする

v3.1 以降、StarRocks はテーブル作成時に MAP カラムを定義することをサポートしています。この例では、以下のデータを含むテーブル test_map を使用します。

CREATE TABLE test_map(
    col_int INT,
    col_map MAP<VARCHAR(50),INT>
  )
DUPLICATE KEY(col_int);

INSERT INTO test_map VALUES
(1,map{"a":1,"b":2}),
(2,map{"c":3}),
(3,map{"d":4,"e":5});

SELECT * FROM test_map ORDER BY col_int;
+---------+---------------+
| col_int | col_map       |
+---------+---------------+
|       1 | {"a":1,"b":2} |
|       2 | {"c":3}       |
|       3 | {"d":4,"e":5} |
+---------+---------------+
3 rows in set (0.05 sec)

col_map カラムの各行の要素数を取得します。

select cardinality(col_map) from test_map order by col_int;
+----------------------+
| cardinality(col_map) |
+----------------------+
|                    2 |
|                    1 |
|                    2 |
+----------------------+
3 rows in set (0.05 sec)

データレイクから MAP データをクエリする

この例では、以下のデータを含む Hive テーブル hive_map を使用します。

SELECT * FROM hive_map ORDER BY col_int;
+---------+---------------+
| col_int | col_map       |
+---------+---------------+
|       1 | {"a":1,"b":2} |
|       2 | {"c":3}       |
|       3 | {"d":4,"e":5} |
+---------+---------------+

クラスター内に Hive catalog が作成された後、この catalog と cardinality() 関数を使用して、col_map カラムの各行の要素数を取得できます。

SELECT cardinality(col_map) FROM hive_map ORDER BY col_int;
+----------------------+
| cardinality(col_map) |
+----------------------+
|                    2 |
|                    1 |
|                    2 |
+----------------------+
3 rows in set (0.05 sec)