Fonctions de table

Documentation sur les fonctions de table

Les fonctions de table permettent de construire des tables.

Page	Description
azureBlobStorage	Fournit une interface de type table pour sélectionner/insérer des fichiers dans Azure Blob Storage. Similaire à la fonction s3.
azureBlobStorageCluster	Permet de traiter en parallèle des fichiers d’Azure Blob Storage avec de nombreux nœuds dans un cluster spécifié.
clusterAllReplicas	Permet d’accéder à tous les shards (configurés dans la section remote_servers) d’un cluster sans créer de table Distributed.
deltaLake	Fournit une interface de type table en lecture seule pour les tables Delta Lake dans Amazon S3.
deltaLakeCluster	Il s’agit d’une extension de la fonction de table deltaLake.
dictionary	Affiche les données du dictionnaire sous forme de table ClickHouse. Fonctionne de la même manière que le moteur Dictionary.
executable	La fonction de table executable crée une table à partir de la sortie d’une fonction définie par l’utilisateur (UDF) que vous définissez dans un script qui écrit des lignes sur stdout.
file	Un moteur de table qui fournit une interface de type table pour effectuer des SELECT à partir de fichiers et des INSERT dans des fichiers, de manière similaire à la fonction de table s3. Utilisez file lorsque vous travaillez avec des fichiers locaux, et s3 lorsque vous travaillez avec des buckets dans un stockage objet comme S3, GCS ou MinIO.
fileCluster	Permet le traitement simultané des fichiers correspondant à un chemin spécifié sur plusieurs nœuds d’un cluster. L’initiateur établit des connexions avec les nœuds workers, développe les globs dans le chemin du fichier et leur délègue les tâches de lecture. Chaque nœud worker interroge l’initiateur pour obtenir le fichier suivant à traiter, et ce jusqu’à ce que toutes les tâches soient terminées (c’est-à-dire que tous les fichiers aient été lus).
filesystem	Fournit un accès au système de fichiers pour lister les fichiers et renvoyer leurs métadonnées et leur contenu.
format	Analyse les données à partir des arguments selon le format d’entrée spécifié. Si l’argument de structure n’est pas spécifié, il est extrait des données.
gcs	Fournit une interface de type table pour SELECT et INSERT des données depuis Google Cloud Storage. Nécessite le rôle IAM Storage Object User.
fuzzQuery	Perturbe la chaîne de requête donnée avec des variations aléatoires.
fuzzJSON	Perturbe une chaîne JSON avec des variations aléatoires.
generateRandom	Génère des données aléatoires selon un schéma donné. Permet de remplir des tables de test avec ces données. Tous les types ne sont pas pris en charge.
mergeTreeTextIndex	Représente le dictionnaire d’un index de texte dans une table MergeTree. Peut être utilisée pour l’introspection.
mergeTreeProjection	Représente le contenu d’une projection dans des tables MergeTree. Peut être utilisée pour l’introspection.
mergeTreeIndex	Représente le contenu des fichiers d’index et de marques des tables MergeTree. Peut être utilisée pour l’introspection.
hdfs	Crée une table à partir de fichiers dans HDFS. Cette fonction de table est similaire aux fonctions de table url et file.
hdfsCluster	Permet de traiter en parallèle des fichiers depuis HDFS à partir de nombreux nœuds dans un cluster spécifié.
hudi	Fournit une interface de type table en lecture seule pour les tables Apache Hudi dans Amazon S3.
ytsaurus	La fonction de table permet de lire des données depuis le cluster YTsaurus.
hudiCluster Table Function	Une extension de la fonction de table hudi. Permet de traiter en parallèle des fichiers de tables Apache Hudi dans Amazon S3 avec de nombreux nœuds dans un cluster spécifié.
iceberg	Fournit une interface de type table en lecture seule pour les tables Apache Iceberg dans Amazon S3, Azure, HDFS ou stockées localement.
paimon	Fournit une interface de type table en lecture seule pour les tables Apache Paimon dans Amazon S3, Azure, HDFS ou stockées localement.
icebergCluster	Une extension de la fonction de table iceberg qui permet de traiter en parallèle des fichiers Apache Iceberg à partir de nombreux nœuds dans un cluster spécifié.
paimonCluster	Une extension de la fonction de table paimon qui permet de traiter en parallèle des fichiers Apache Paimon à partir de nombreux nœuds dans un cluster spécifié.
input	Fonction de table qui permet de convertir et d’insérer efficacement, dans une table ayant une autre structure, des données envoyées au serveur avec une structure donnée.
jdbc	Renvoie une table connectée via un pilote JDBC.
merge	Crée une table Merge temporaire. La structure sera dérivée des tables sous-jacentes en utilisant une union de leurs colonnes et en déduisant des types communs.
mongodb	Permet d’exécuter des requêtes SELECT sur des données stockées sur un serveur MongoDB distant.
mysql	Permet d’exécuter des requêtes SELECT et INSERT sur des données stockées sur un serveur MySQL distant.
null	Crée une table temporaire de la structure spécifiée avec le moteur de table Null. Cette fonction est utilisée pour faciliter l’écriture de tests et les démonstrations.
timeSeriesMetrics	timeSeriesMetrics renvoie la table des métriques utilisée par la table db_name.time_series_table, dont le moteur de table est TimeSeries.
timeSeriesSelector	Lit des séries temporelles depuis une table TimeSeries, filtrées par un sélecteur et dont les horodatages appartiennent à un intervalle spécifié.
timeSeriesTags	La fonction de table timeSeriesTags renvoie la table des tags utilisée par la table db_name.time_series_table, dont le moteur de table est TimeSeries.
prometheusQueryRange	Évalue une requête Prometheus à l’aide des données d’une table TimeSeries.
zeros	Utilisée à des fins de test comme méthode la plus rapide pour générer un grand nombre de lignes. Semblable aux tables système system.zeros et system.zeros_mt.
primes	Renvoie une table avec une seule colonne prime contenant des nombres premiers.
numbers	Renvoie une table avec une seule colonne number contenant une suite d’entiers.
prometheusQuery	Évalue une requête Prometheus à l’aide des données d’une table TimeSeries.
timeSeriesSamples	timeSeriesSamples renvoie la table des échantillons utilisée par la table db_name.time_series_table, dont le moteur de table est TimeSeries.
generate_series (generateSeries)	Renvoie une table avec l’unique colonne generate_series (UInt64), qui contient les entiers de start à stop inclus.
odbc	Renvoie la table connectée via ODBC.
postgresql	Permet d’exécuter des requêtes SELECT et INSERT sur des données stockées sur un serveur PostgreSQL distant.
redis	Cette fonction de table permet d’intégrer ClickHouse à Redis.
remote, remoteSecure	La fonction de table remote permet d’accéder à des serveurs distants à la volée, c’est-à-dire sans créer de table distribuée. La fonction de table remoteSecure est identique à remote, mais via une connexion sécurisée.
s3 Table Function	Fournit une interface de type table pour sélectionner/insérer des fichiers dans Amazon S3 et Google Cloud Storage. Cette fonction de table est similaire à la fonction hdfs, mais fournit des fonctionnalités spécifiques à S3.
s3Cluster	Extension de la fonction de table s3, qui permet de traiter en parallèle des fichiers provenant d’Amazon S3 et de Google Cloud Storage avec de nombreux nœuds dans un cluster spécifié.
sqlite	Permet d’exécuter des requêtes sur des données stockées dans une base de données SQLite.
arrowFlight	Permet de lire et d’écrire des données exposées via un serveur Apache Arrow Flight.
url	Crée une table à partir de l’URL, avec le format et la structure spécifiés
urlCluster	Permet de traiter en parallèle des fichiers depuis une URL à partir de nombreux nœuds dans un cluster spécifié.
view	Transforme une sous-requête en table. Cette fonction implémente des vues.
values	crée un stockage temporaire qui remplit les colonnes avec des valeurs.
loop	La fonction de table loop dans ClickHouse est utilisée pour renvoyer les résultats de la requête dans une boucle infinie.

​

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

Vous ne pouvez pas utiliser de fonctions de table si le paramètre allow_ddl est désactivé.