MsgPack

Documentation sur le format MsgPack

Entrée	Sortie	Alias
✔	✔

​

Description

ClickHouse prend en charge la lecture et l’écriture de fichiers de données au format MessagePack.

​

Correspondance entre les types de données

Type de données MessagePack (INSERT)	Type de données ClickHouse	Type de données 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

​

Exemple d’utilisation

Écriture dans le fichier “.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;

​

Paramètres de format

Paramètre	Description	Valeur par défaut
input_format_msgpack_number_of_columns	le nombre de colonnes dans les données MsgPack insérées. Utilisé pour l’inférence automatique du schéma à partir des données.	0
output_format_msgpack_uuid_representation	la façon de représenter l’UUID au format MsgPack en sortie.	EXT