Fonctions de table

Documentation sur les fonctions de table

Les fonctions de table permettent de construire des tables.

​

Utilisation

Les fonctions de table peuvent être utilisées dans la clause FROM d’une requête SELECT. Par exemple, vous pouvez SELECT des données depuis un fichier situé sur votre machine locale à l’aide de la fonction de table file.

Query

echo "1, 2, 3" > example.csv

Response

./clickhouse client
:) SELECT * FROM file('example.csv')
┌─c1─┬─c2─┬─c3─┐
│  1 │  2 │  3 │
└────┴────┴────┘

Vous pouvez également utiliser des fonctions de table pour créer une table temporaire accessible uniquement pendant la requête en cours. Par exemple :

Query

SELECT * FROM generateSeries(1,5);

Response

┌─generate_series─┐
│               1 │
│               2 │
│               3 │
│               4 │
│               5 │
└─────────────────┘

La table est supprimée lorsque la requête se termine.

Les fonctions de table peuvent servir à créer des tables, selon la syntaxe suivante :

Query

CREATE TABLE [IF NOT EXISTS] [db.]table_name AS table_function()

Par exemple :

Query

CREATE TABLE series AS generateSeries(1, 5);
SELECT * FROM series;

Response

┌─generate_series─┐
│               1 │
│               2 │
│               3 │
│               4 │
│               5 │
└─────────────────┘

Enfin, les fonctions de table peuvent être utilisées pour INSERT des données dans une table. Par exemple, nous pourrions écrire le contenu de la table que nous avons créée dans l’exemple précédent dans un fichier sur disque en utilisant à nouveau la fonction de table file :

Query

INSERT INTO FUNCTION file('numbers.csv', 'CSV') SELECT * FROM series;

Query

cat numbers.csv
1
2
3
4
5

La plupart des fonctions de table nécessitent le privilège CREATE TEMPORARY TABLE pour s’exécuter ; un SELECT ou un INSERT qui en exécute une est donc refusé lorsque readonly est défini à 1.