Funciones de tabla

Documentación de las funciones de tabla

Las funciones de tabla son métodos para crear tablas.

Página	Descripción
azureBlobStorage	Proporciona una interfaz de tipo tabla para seleccionar e insertar archivos en Azure Blob Storage. Es similar a la función s3.
azureBlobStorageCluster	Permite procesar archivos de Azure Blob Storage en paralelo con muchos nodos en un clúster especificado.
clusterAllReplicas	Permite acceder a todos los segmentos (configurados en la sección remote_servers) de un clúster sin crear una tabla distribuida.
deltaLake	Proporciona una interfaz de tipo tabla de solo lectura para las tablas de Delta Lake en Amazon S3.
deltaLakeCluster	Es una extensión de la función de tabla deltaLake.
dictionary	Muestra los datos del diccionario como una tabla de ClickHouse. Funciona igual que el engine Dictionary.
executable	La función de tabla executable crea una tabla a partir de la salida de una función definida por el usuario (UDF) que defines en un script que envía filas a stdout.
file	Un motor de tabla que proporciona una interfaz de tipo tabla para SELECT desde archivos e INSERT en ellos, similar a la función de tabla S3. Usa file() al trabajar con archivos locales y s3() al trabajar con buckets en almacenamiento de objetos como S3, GCS o MinIO.
fileCluster	Permite procesar simultáneamente archivos que coinciden con una ruta especificada en varios nodos de un clúster. El iniciador establece conexiones con los nodos worker, expande los globs de la ruta del archivo y delega las tareas de lectura de archivos a los nodos worker. Cada nodo worker consulta al iniciador cuál es el siguiente archivo que debe procesar, y repite este proceso hasta que se completan todas las tareas (es decir, hasta que se leen todos los archivos).
filesystem	Proporciona acceso al sistema de archivos para listar archivos y devolver sus metadatos y contenido.
format	Analiza los datos de los argumentos según el formato de entrada especificado. Si no se especifica el argumento de estructura, se extrae de los datos.
gcs	Proporciona una interfaz de tipo tabla para SELECT e INSERT de datos desde Google Cloud Storage. Requiere el rol de IAM Storage Object User.
fuzzQuery	Altera la cadena de consulta dada con variaciones aleatorias.
fuzzJSON	Altera una cadena JSON con variaciones aleatorias.
generateRandom	Genera datos aleatorios con un esquema dado. Permite rellenar tablas de prueba con esos datos. No se admiten todos los tipos.
mergeTreeTextIndex	Representa el diccionario de un índice de texto en una tabla MergeTree. Puede usarse para introspección.
mergeTreeProjection	Representa el contenido de una proyección en tablas MergeTree. Puede usarse para introspección.
mergeTreeIndex	Representa el contenido de los archivos de índice y marcas de las tablas MergeTree. Puede usarse para introspección.
hdfs	Crea una tabla a partir de archivos en HDFS. Esta función de tabla es similar a las funciones de tabla url y file.
hdfsCluster	Permite procesar archivos de HDFS en paralelo desde muchos nodos en un clúster especificado.
hudi	Proporciona una interfaz de tipo tabla de solo lectura para las tablas de Apache Hudi en Amazon S3.
ytsaurus	Esta función de tabla permite leer datos del clúster de YTsaurus.
hudiCluster Table Function	Es una extensión de la función de tabla hudi. Permite procesar en paralelo archivos de tablas Apache Hudi en Amazon S3 con muchos nodos en un clúster especificado.
iceberg	Proporciona una interfaz de tipo tabla de solo lectura para tablas Apache Iceberg en Amazon S3, Azure, HDFS o almacenadas localmente.
paimon	Proporciona una interfaz de tipo tabla de solo lectura para tablas Apache Paimon en Amazon S3, Azure, HDFS o almacenadas localmente.
icebergCluster	Es una extensión de la función de tabla iceberg que permite procesar archivos de Apache Iceberg en paralelo desde muchos nodos en un clúster especificado.
paimonCluster	Es una extensión de la función de tabla paimon que permite procesar archivos de Apache Paimon en paralelo desde muchos nodos en un clúster especificado.
input	Función de tabla que permite convertir e insertar de forma eficiente datos enviados al servidor con una estructura dada en una tabla con otra estructura.
jdbc	Devuelve una tabla conectada mediante un driver JDBC.
merge	Crea una tabla Merge temporal. La estructura se derivará de las tablas subyacentes usando una unión de sus columnas y tipos comunes derivados.
mongodb	Permite realizar consultas SELECT sobre datos almacenados en un servidor remoto de MongoDB.
mysql	Permite realizar consultas SELECT e INSERT sobre datos almacenados en un servidor remoto de MySQL.
null	Crea una tabla temporal con la estructura especificada y el motor de tabla Null. La función se utiliza para facilitar la escritura de pruebas y demostraciones.
timeSeriesMetrics	timeSeriesMetrics devuelve la tabla de métricas utilizada por la tabla db_name.time_series_table, cuyo motor de tabla es TimeSeries.
timeSeriesSelector	Lee series temporales de una tabla TimeSeries, filtradas por un selector y con marcas de tiempo dentro de un intervalo especificado.
timeSeriesTags	La función de tabla timeSeriesTags devuelve la tabla de etiquetas utilizada por la tabla db_name.time_series_table, cuyo motor de tabla es TimeSeries.
prometheusQueryRange	Evalúa una consulta de Prometheus utilizando datos de una tabla TimeSeries.
zeros	Se utiliza con fines de prueba como el método más rápido para generar muchas filas. Es similar a las tablas del sistema system.zeros y system.zeros_mt.
primes	Devuelve una tabla con una única columna prime que contiene números primos.
timeSeriesData	timeSeriesData devuelve la tabla de datos utilizada por la tabla db_name.time_series_table, cuyo motor de tabla es TimeSeries.
numbers	Devuelve una tabla con una única columna number que contiene una secuencia de enteros.
prometheusQuery	Evalúa una consulta de Prometheus utilizando datos de una tabla TimeSeries.
generate_series (generateSeries)	Devuelve una tabla con una única columna, generate_series (UInt64), que contiene enteros de start a stop, ambos inclusive.
odbc	Devuelve la tabla conectada mediante ODBC.
postgresql	Permite realizar consultas SELECT e INSERT sobre datos almacenados en un servidor remoto de PostgreSQL.
redis	Esta función de tabla permite integrar ClickHouse con Redis.
remote, remoteSecure	La función de tabla remote permite acceder dinámicamente a servidores remotos, es decir, sin crear una tabla distribuida. La función de tabla remoteSecure es igual que remote, pero a través de una conexión segura.
s3 Table Function	Proporciona una interfaz similar a una tabla para seleccionar o insertar archivos en Amazon S3 y Google Cloud Storage. Esta función de tabla es similar a la función hdfs, pero ofrece características específicas de S3.
s3Cluster	Es una extensión de la función de tabla s3 que permite procesar archivos de Amazon S3 y Google Cloud Storage en paralelo con varios nodos de un clúster especificado.
sqlite	Permite realizar consultas sobre datos almacenados en una base de datos SQLite.
arrowFlight	Permite realizar consultas sobre datos expuestos a través de un servidor Apache Arrow Flight.
url	Crea una tabla a partir de la URL con el format y la structure especificados
urlCluster	Permite procesar archivos desde una URL en paralelo con varios nodos de un clúster especificado.
view	Convierte una subconsulta en una tabla. La función implementa vistas.
values	crea un almacenamiento temporal que rellena columnas con valores.
loop	La función de tabla loop de ClickHouse se utiliza para devolver resultados de consultas en un bucle infinito.

​

Uso

Las funciones de tabla se pueden usar en la cláusula FROM de una consulta SELECT. Por ejemplo, puede usar SELECT para leer datos de un archivo en su máquina local mediante la función de tabla file.

Query

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

Response

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

También puede usar funciones de tabla para crear una tabla temporal que solo está disponible en la consulta actual. Por ejemplo:

Query

SELECT * FROM generateSeries(1,5);

Response

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

La tabla se elimina cuando finaliza la consulta.

Las funciones de tabla pueden utilizarse para crear tablas, usando la siguiente sintaxis:

Query

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

Por ejemplo:

Query

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

Response

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

Por último, las funciones de tabla pueden utilizarse para INSERT datos en una tabla. Por ejemplo, podríamos escribir el contenido de la tabla que creamos en el ejemplo anterior en un archivo del disco usando de nuevo la función de tabla file:

Query

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

Query

cat numbers.csv
1
2
3
4
5

No puedes usar funciones de tabla si la opción allow_ddl está deshabilitada.