Npy

Documentation sur le format Npy

Entrée	Sortie	Alias
✔	✔

​

Description

Le format Npy est conçu pour charger dans ClickHouse un tableau NumPy depuis un fichier .npy. Le format de fichier NumPy est un format binaire utilisé pour stocker efficacement des tableaux de données numériques. Lors de l’importation, ClickHouse interprète la dimension de premier niveau comme un tableau de lignes à colonne unique.

Le tableau ci-dessous présente les types de données Npy pris en charge et leur type correspondant dans ClickHouse :

​

Correspondance des types de données

Type de données Npy (INSERT)	Type de données ClickHouse	Type de données Npy (SELECT)
i1	Int8	i1
i2	Int16	i2
i4	Int32	i4
i8	Int64	i8
u1, b1	UInt8	u1
u2	UInt16	u2
u4	UInt32	u4
u8	UInt64	u8
f2, f4	Float32	f4
f8	Float64	f8
S, U	String	S
	FixedString	S

​

Exemple d’utilisation

​

Enregistrer un tableau au format .npy avec Python

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

​

Lecture d’un fichier NumPy dans ClickHouse

Query

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

Response

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

​

Sélection des données

Vous pouvez sélectionner des données à partir d’une table ClickHouse et les enregistrer dans un fichier au format Npy à l’aide de la commande suivante avec clickhouse-client :

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

​

Paramètres de format