Map(K, V)

データ型 Map(K, V) はキーと値のペアを格納します。

他のデータベースと異なり、ClickHouse における map ではキーは一意である必要はありません。つまり、同じキーを持つ要素を 2 つ含むことができます。 （これは、map が内部的には Array(Tuple(K, V)) として実装されているためです。）

map m からキー k に対応する値を取得するには、構文 m[k] を使用できます。 また、m[k] は map を走査するため、この操作の実行時間は map のサイズに比例します。

パラメータ

• K — Map のキーの型。Nullable および Nullable 型をネストした LowCardinality を除く任意の型。
• V — Map の値の型。任意の型。

例

map 型のカラムを持つテーブルを作成します。

CREATE TABLE tab (m Map(String, UInt64)) ENGINE=Memory;
INSERT INTO tab VALUES ({'key1':1, 'key2':10}), ({'key1':2,'key2':20}), ({'key1':3,'key2':30});

key2 の値を選択するには:

SELECT m['key2'] FROM tab;

結果：

┌─arrayElement(m, 'key2')─┐
│                      10 │
│                      20 │
│                      30 │
└─────────────────────────┘

指定したキー k がマップ内に含まれていない場合、m[k] は値型のデフォルト値を返します。例えば、整数型なら 0、文字列型なら '' です。 マップ内にキーが存在するかどうかを確認するには、mapContains 関数を使用します。

CREATE TABLE tab (m Map(String, UInt64)) ENGINE=Memory;
INSERT INTO tab VALUES ({'key1':100}), ({});
SELECT m['key1'] FROM tab;

結果:

┌─arrayElement(m, 'key1')─┐
│                     100 │
│                       0 │
└─────────────────────────┘

Tuple から Map への変換

Tuple() 型の値は、CAST 関数を使用して Map() 型にキャストできます。

例

クエリ:

SELECT CAST(([1, 2, 3], ['Ready', 'Steady', 'Go']), 'Map(UInt8, String)') AS map;

結果：

┌─map───────────────────────────┐
│ {1:'Ready',2:'Steady',3:'Go'} │
└───────────────────────────────┘

Map のサブカラムの読み取り

Map 全体を読み出さずに済むように、場合によってはサブカラム keys と values を使用できます。

例

クエリ:

CREATE TABLE tab (m Map(String, UInt64)) ENGINE = Memory;
INSERT INTO tab VALUES (map('key1', 1, 'key2', 2, 'key3', 3));

SELECT m.keys FROM tab; --   mapKeys(m)と同じ
SELECT m.values FROM tab; -- mapValues(m)と同じ

結果:

┌─m.keys─────────────────┐
│ ['key1','key2','key3'] │
└────────────────────────┘

┌─m.values─┐
│ [1,2,3]  │
└──────────┘

関連項目

• map() 関数
• CAST() 関数
• Map データ型用 -Map コンビネータ

関連コンテンツ

• ブログ記事: Building an Observability Solution with ClickHouse - Part 2 - Traces