URL - ClickHouse Documentation

Движок базы данных URL трактует имена таблиц как URL и предоставляет данные по этим URL в виде таблиц. Он использует табличную функцию url, которая направляет каждый URL соответствующему backend-соединению, например file, s3, HDFS, Azure Blob Storage или HTTP.

Создание базы данных

CREATE DATABASE web_data
ENGINE = URL([base_url]);

Если указан base_url, относительные имена таблиц разрешаются относительно него. Без базового URL каждое имя таблицы должно быть полным URL.

Использование

CREATE DATABASE web_data
ENGINE = URL('https://example.com/data/');

SELECT * FROM web_data.`daily.csv`;

База данных не хранит определений таблиц. Каждая таблица разрешается по своему URL в момент использования, поэтому её схема выводится из текущих данных. В именах таблиц также можно указывать полный URL, например web_data.s3://bucket/data/events.parquet“.

Управление доступом

Для создания такой базы данных требуются source-привилегии READ и WRITE на URL, независимо от значения table_engines_require_grant. Для чтения таблицы также необходима source-привилегия READ на разрешённое backend-соединение, а для записи — соответствующая привилегия WRITE. Например:

GRANT READ, WRITE ON URL TO user_name;
GRANT READ, WRITE ON S3 TO user_name;

Для базы данных с базовым URL file:// пользователю требуется привилегия READ ON FILE. На ClickHouse server доступ к локальным файлам дополнительно ограничен каталогом user_files_path. Подробности о версиях и совместимости см. в разделе привилегии SOURCES.

См. также

Последнее изменение 26 сентября 2026 г.