Map(K, V)
データ型 Map(K, V)
はキーと値のペアを格納します。
他のデータベースとは異なり、ClickHouseのマップはユニークではありません。つまり、マップには同じキーを持つ2つの要素を含むことができます。
(その理由は、マップが内部的に Array(Tuple(K, V))
として実装されているためです。)
構文 m[k]
を使用して、マップ m
のキー k
に対する値を取得できます。
また、m[k]
はマップをスキャンします。つまり、操作の実行時間はマップのサイズに対して線形になります。
パラメータ
K
— マップのキーの型。 Nullable および LowCardinality で、かつ Nullable 型とネストされていない任意の型。V
— マップの値の型。任意の型。
例
マップ型のカラムを持つテーブルを作成します:
key2
の値を選択するには:
結果:
要求されたキー k
がマップに存在しない場合、m[k]
は値の型のデフォルト値を返します。例えば、整数型の場合は 0
、文字列型の場合は ''
です。
マップ内にキーが存在するかどうかを確認するには、関数 mapContains を使用できます。
結果:
TupleからMapへの変換
Tuple()
型の値は、関数 CAST を使用して Map()
型の値にキャストできます:
例
クエリ:
結果:
Mapのサブカラムを読み取る
マップ全体を読み取らずに済むように、場合によってはサブカラム keys
と values
を使用できます。
例
クエリ:
結果:
参照
- map() 関数
- CAST() 関数
- -Map 機能はマップデータ型のために