Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

настройки сеанса url_*

Эти настройки доступны в system.settings и автоматически генерируются на основе исходного кода.

url_base

История версий
ВерсияЗначение по умолчаниюКомментарий
26.5Новая настройка для указания базового URL при разрешении относительных URL в табличной функции url и движке таблицы URL.

Базовый URL, используемый для разрешения относительных URL в табличной функции url и движке таблицы URL.

Если настройка задана, относительные URL разрешаются следующим образом:

  • URL, относительный к пути (например, data.csv): объединяется с путём базового URL в соответствии с RFC 3986. Всё после последнего / в базовом пути заменяется относительным URL, поэтому завершающий слеш имеет значение: https://example.com/dir/ + data.csv = https://example.com/dir/data.csv, а https://example.com/dir + data.csv = https://example.com/data.csv. Если у базового URL нет пути (например, https://example.com), добавляется /: https://example.com/data.csv. Точечные сегменты (./ и ../) в относительном URL нормализуются: https://example.com/dir/ + ../a.csv = https://example.com/a.csv.
  • URL, относительный к хосту (например, /test/data.csv): разрешается относительно схемы и хоста базового URL.
  • URL, относительный к схеме (например, //other.com/test/data.csv): разрешается с использованием схемы базового URL.
  • Ссылка, содержащая только строку запроса (например, ?x=1): добавляется к пути базового URL (заменяя существующие строку запроса и фрагмент).
  • Ссылка, содержащая только фрагмент (например, #frag): добавляется к базовому URL с сохранением строки запроса (заменяя существующий фрагмент).
  • Пустая ссылка: возвращает базовый URL без фрагмента.
  • Если базовый URL содержит только схему (например, file://), URL, относительный к пути, добавляется к нему напрямую: file:// + data.csv = file://data.csv, что для схемы file:// означает путь, относительный к каталогу user_files (текущему каталогу для clickhouse-local). Точечные сегменты в этом случае сохраняются без изменений, поэтому целевой движок разрешает их относительно собственного базового каталога.

Например, если url_base равен https://example.com/def/, то:

  • data.csv преобразуется в https://example.com/def/data.csv
  • /test/data.csv преобразуется в https://example.com/test/data.csv
  • //other.com/test/data.csv преобразуется в https://other.com/test/data.csv

url_wildcard_max_directories_to_read

Тип
UInt64
По умолчанию
100000
История версий
ВерсияЗначение по умолчаниюКомментарий
26.7100000Новая настройка, ограничивающая число каталогов, читаемых при разворачивании подстановочных шаблонов в табличной функции `url`.

Максимальное число каталогов, которые можно обойти при разворачивании подстановочных шаблонов URL по индексным страницам.

Navigation