MsgPack

MsgPack フォーマットのドキュメント

入力	出力	エイリアス
✔	✔

​

説明

ClickHouse は、MessagePack のデータファイルの読み書きをサポートしています。

​

データ型の対応

MessagePack データ型 (INSERT)	ClickHouse データ型	MessagePack データ型 (SELECT)
uint N, positive fixint	UIntN	uint N
int N, negative fixint	IntN	int N
bool	UInt8	uint 8
fixstr, str 8, str 16, str 32, bin 8, bin 16, bin 32	String	bin 8, bin 16, bin 32
fixstr, str 8, str 16, str 32, bin 8, bin 16, bin 32	FixedString	bin 8, bin 16, bin 32
float 32	Float32	float 32
float 64	Float64	float 64
uint 16	Date	uint 16
int 32	Date32	int 32
uint 32	DateTime	uint 32
uint 64	DateTime64	uint 64
fixarray, array 16, array 32	Array/Tuple	fixarray, array 16, array 32
fixmap, map 16, map 32	Map	fixmap, map 16, map 32
uint 32	IPv4	uint 32
bin 8	String	bin 8
int 8	Enum8	int 8
bin 8	(U)Int128/(U)Int256	bin 8
int 32	Decimal32	int 32
int 64	Decimal64	int 64
bin 8	Decimal128/Decimal256	bin 8

​

使用例

“.msgpk” ファイルへの書き込み:

$ clickhouse-client --query="CREATE TABLE msgpack (array Array(UInt8)) ENGINE = Memory;"
$ clickhouse-client --query="INSERT INTO msgpack VALUES ([0, 1, 2, 3, 42, 253, 254, 255]), ([255, 254, 253, 42, 3, 2, 1, 0])";
$ clickhouse-client --query="SELECT * FROM msgpack FORMAT MsgPack" > tmp_msgpack.msgpk;

​

フォーマット設定

設定	説明	デフォルト
input_format_msgpack_number_of_columns	挿入する MsgPack データのカラム数。データからスキーマを自動推論する際に使用されます。	0
output_format_msgpack_uuid_representation	MsgPack フォーマットで UUID を出力する際の形式。	EXT