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

Настройки сеанса ClickHouse в автоматически созданной группе url_*.

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

​

url_base

Базовый 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

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