Npy

Npy フォーマットは、.npy ファイル内の NumPy 配列を ClickHouse に読み込むために設計されています。 NumPy のファイルフォーマットは、数値データの配列を効率的に格納するためのバイナリフォーマットです。 インポート時には、ClickHouse は最上位の次元を、単一のカラムを持つ行の配列として扱います。

以下の表は、サポートされている Npy のデータ型と、それに対応する ClickHouse の型を示しています。

import numpy as np

arr = np.array([[[1],[2],[3]],[[4],[5],[6]]])
np.save('example_array.npy', arr)

SELECT *
FROM file('example_array.npy', Npy)

┌─array─────────┐
│ [[1],[2],[3]] │
│ [[4],[5],[6]] │
└───────────────┘

clickhouse-client を使用すると、次のコマンドで ClickHouse テーブルからデータを取得し、Npy フォーマットのファイルに保存できます。

$ clickhouse-client --query="SELECT {column} FROM {some_table} FORMAT Npy" > {filename.npy}