Функции таблиц
Функции таблиц — это методы для построения таблиц.
Вы можете использовать функции таблиц в:
-
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 | Движок таблицы, который предоставляет интерфейс, подобный таблице, для выбора и вставки данных из файлов, аналогично функции таблицы s3. Используйте file() при работе с локальными файлами и s3() при работе с ведрами в облачном хранилище, таком как S3, GCS или MinIO. |
| timeSeriesTags | Функция таблицы timeSeriesTags возвращает таблицу тегов, используемую таблицей db_name.time_series_table, чей движок таблицы является TimeSeries. |
| mysql | Позволяет выполнять запросы SELECT и INSERT на данных, которые хранятся на удаленном сервере MySQL. |
| Предоставляет интерфейс, подобный таблице, для выбора/вставки файлов в 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 | Предоставляет интерфейс, подобный таблице, для выборки и вставки данных из 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 параллельно на многих узлах в указанном кластере. |
| sqlite | Позволяет выполнять запросы на данные, хранящиеся в базе данных SQLite. |
| deltaLakeCluster | Это расширение к функции deltaLake. |
| numbers | Возвращает таблицы с единственной колонкой 'number', которая содержит специфицируемые целые числа. |
| null | Создает временную таблицу заданной структуры с движком таблицы Null. Функция используется для удобства написания тестов и демонстраций. |
| remote, remoteSecure | Функция таблицы remote позволяет получать доступ к удаленным серверам в реальном времени, т.е. без создания распределенной таблицы. Функция таблицы remoteSecure аналогична remote, но соединение защищено. |
| mongodb | Позволяет выполнять запросы SELECT на данных, которые хранятся на удаленном сервере MongoDB. |