Funciones de tabla - ClickHouse Documentation

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.
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.
timeSeriesSamples	timeSeriesSamples devuelve la tabla de muestras utilizada por la tabla `db_name.time_series_table`, cuyo motor de tabla es 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 leer y escribir 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.

​Uso

Uso