Табличные Функции
Табличные функции — это методы для создания таблиц.
Вы можете использовать табличные функции в:
-
FROM клаузе запроса
SELECT.Метод создания временной таблицы, доступной только в текущем запросе. Таблица удаляется по завершении запроса.
-
CREATE TABLE AS table_function() запросе.
Это один из методов создания таблицы.
-
INSERT INTO TABLE FUNCTION запросе.
примечание
Вы не можете использовать табличные функции, если параметр allow_ddl отключен.
| Страница | Описание |
|---|---|
| fileCluster | Позволяет одновременно обрабатывать файлы, соответствующие заданному пути, на нескольких узлах в кластере. Инициатор устанавливает соединения с рабочими узлами, расширяет шаблоны в пути к файлу и передает задачи чтения файлов рабочим узлам. Каждый рабочий узел запрашивает у инициатора следующий файл для обработки, повторяя до завершения всех задач (все файлы прочитаны). |
| input | Табличная функция, которая позволяет эффективно преобразовывать и вставлять данные, отправленные на сервер с заданной структурой, в таблицу с другой структурой. |
| iceberg | Предоставляет интерфейс, подобный таблице, для чтения таблиц Apache Iceberg в Amazon S3, Azure, HDFS или локально хранящихся. |
| executable | Табличная функция executable создает таблицу на основе вывода пользовательской функции (UDF), которую вы определяете в скрипте, выводящем строки в stdout. |
| timeSeriesMetrics | timeSeriesMetrics возвращает таблицу метрик, используемую таблицей db_name.time_series_table, чей движок таблицы является движком TimeSeries. |
| loop | Табличная функция loop в ClickHouse используется для возвращения результатов запроса в бесконечном цикле. |
| url | Создает таблицу из URL с заданным format и structure |
| hudi | Предоставляет интерфейс, подобный таблице, для чтения таблиц Apache Hudi в Amazon S3. |
| fuzzQuery | Вносит случайные изменения в заданную строку запроса. |
| clusterAllReplicas | Позволяет получить доступ ко всем шартам (конфигурированным в разделе remote_servers) кластера без создания распределенной таблицы. |
| urlCluster | Позволяет обрабатывать файлы из URL параллельно с многих узлов в заданном кластере. |
| redis | Эта табличная функция позволяет интегрировать ClickHouse с Redis. |
| icebergCluster | Расширение табличной функции iceberg, которое позволяет обрабатывать файлы из Apache Iceberg параллельно с многих узлов в заданном кластере. |
| view | Превращает подзапрос в таблицу. Функция реализует представления. |
| file | Движок таблицы, который предоставляет интерфейс, похожий на таблицу, для SELECT из и INSERT в файлы, аналогично табличной функции s3. Используйте file(), когда работаете с локальными файлами, и s3(), когда работаете с корзинами в объектном хранилище, таких как S3, GCS или MinIO. |
| timeSeriesTags | Табличная функция timeSeriesTags возвращает таблицу тегов, используемую таблицей db_name.time_series_table, чей движок таблицы является движком TimeSeries. |
| mysql | Позволяет выполнять запросы SELECT и INSERT на данные, хранящиеся на удаленном сервере MySQL. |
| s3 Table Function | Предоставляет интерфейс, похожий на таблицу, для выбора/вставки файлов в Amazon S3 и Google Cloud Storage. Эта табличная функция аналогична функции hdfs, но предоставляет функции, специфичные для S3. |
| dictionary | Отображает данные словаря как таблицу ClickHouse. Работает так же, как движок Dictionary. |
| hdfs | Создает таблицу из файлов в HDFS. Эта табличная функция аналогична табличным функциям url и file. |
| fuzzJSON | Вносит случайные изменения в строку JSON. |
| hdfsCluster | Позволяет обрабатывать файлы из HDFS параллельно с многих узлов в заданном кластере. |
| zeros | Используется для тестовых целей как самый быстрый метод генерации множества строк. Аналогично системным таблицам system.zeros и system.zeros_mt. |
| values | Создает временное хранилище, которое заполняет колонки значениями. |
| generateRandom | Генерирует случайные данные с заданной схемой. Позволяет заполнять тестовые таблицы этими данными. Не все типы поддерживаются. |
| deltaLake | Предоставляет интерфейс, похожий на таблицу, для чтения таблиц Delta Lake в Amazon S3. |
| gcs | Предоставляет интерфейс, похожий на таблицу, для SELECT и INSERT данных из Google Cloud Storage. Требует участия IAM роли Storage Object User. |
| mergeTreeIndex | Представляет содержимое индекса и файлов меток таблиц MergeTree. Может использоваться для инстроспекции. |
| postgresql | Позволяет выполнять запросы SELECT и INSERT на данные, хранящиеся на удаленном сервере PostgreSQL. |
| timeSeriesData | timeSeriesData возвращает таблицу данных, использованную таблицей db_name.time_series_table, чей движок таблицы — TimeSeries. |
| azureBlobStorage | Предоставляет интерфейс, похожий на таблицу, для выбора/вставки файлов в Azure Blob Storage. Похож на функцию s3. |
| odbc | Возвращает таблицу, которая подключена через ODBC. |
| merge | Создает временную таблицу Merge. Структура таблицы берется из первой таблицы, которая соответствует регулярному выражению. |
| hudiCluster Table Function | Расширение табличной функции hudi. Позволяет обрабатывать файлы из таблиц Apache Hudi в Amazon S3 параллельно с многих узлов в заданном кластере. |
| generate_series (generateSeries) | Возвращает таблицу с единственным столбцом generate_series (UInt64), который содержит целые числа от начала до конца включительно. |
| azureBlobStorageCluster | Позволяет обрабатывать файлы из Azure Blob Storage параллельно с многих узлов в заданном кластере. |
| jdbc | Возвращает таблицу, которая подключена через JDBC-драйвер. |
| format | Парсит данные из аргументов в соответствии с указанным форматом ввода. Если аргумент структуры не указан, он извлекается из данных. |
| s3Cluster | Расширение табличной функции s3, которая позволяет обрабатывать файлы из Amazon S3 и Google Cloud Storage параллельно с многих узлов в заданном кластере. |
| TODO: Add title | TODO: Добавить описание |
| sqlite | Позволяет выполнять запросы на данные, хранящиеся в базе данных SQLite. |
| deltaLakeCluster | Это расширение табличной функции deltaLake. |
| numbers | Возвращает таблицы с единственным столбцом number, который содержит указанные целые числа. |
| null | Создает временную таблицу заданной структуры с движком таблицы Null. Функция используется для удобства написания тестов и демонстраций. |
| remote, remoteSecure | Табличная функция remote позволяет получать доступ к удаленным серверам динамически, т.е. без создания распределенной таблицы. Табличная функция remoteSecure аналогична remote, но через защищенное соединение. |
| mongodb | Позволяет выполнять запросы SELECT на данные, хранящиеся на удаленном сервере MongoDB. |