Npy

Documentação do formato Npy

Entrada	Saída	Alias
✔	✔

​

Descrição

O formato Npy foi projetado para carregar um array do NumPy de um arquivo .npy para o ClickHouse. O formato de arquivo do NumPy é um formato binário usado para armazenar arrays de dados numéricos com eficiência. Durante a importação, o ClickHouse trata a dimensão de nível superior como um array de linhas com uma única coluna.

A tabela abaixo mostra os tipos de dados Npy compatíveis e seus tipos correspondentes no ClickHouse:

​

Correspondência entre tipos de dados

Tipo de dado Npy (INSERT)	Tipo de dado do ClickHouse	Tipo de dado 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

​

Exemplo de uso

​

Salvando um array no formato .npy com Python

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

​

Ler um arquivo NumPy no ClickHouse

Query

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

Response

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

​

Selecionando dados

Você pode selecionar dados de uma tabela do ClickHouse e salvá-los em um arquivo no formato Npy usando o comando a seguir com o clickhouse-client:

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

​

Configurações de formato