メインコンテンツまでスキップ
メインコンテンツまでスキップ

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のサブカラムを読み取る

マップ全体を読み取らずに済むように、場合によってはサブカラム keysvalues を使用できます。

クエリ:

結果:

参照