url_* 会话设置

这些设置可在 system.settings 中查看，并由 源代码 自动生成。

在 url 表函数和 URL 表引擎中，用于解析相对 URL 的 base URL。

设置后，相对 URL 将按以下方式解析：

• 路径相对 URL (例如 data.csv) ：按照 RFC 3986 与 base URL 的路径合并。base 路径中最后一个 / 之后的所有内容都会被相对 URL 替换，因此末尾是否带斜杠很重要：https://example.com/dir/ + data.csv = https://example.com/dir/data.csv，而 https://example.com/dir + data.csv = https://example.com/data.csv。如果 base 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) ：根据 base URL 的 scheme 和 host 进行解析。
• scheme 相对 URL (例如 //other.com/test/data.csv) ：使用 base URL 的 scheme 进行解析。
• 仅查询引用 (例如 ?x=1) ：追加到 base URL 的路径后 (替换现有的查询字符串/片段) 。
• 仅片段引用 (例如 #frag) ：追加到 base URL 后，并保留查询字符串 (替换现有片段) 。
• 空引用：返回不带片段的 base URL。
• 如果 base URL 仅包含 scheme (例如 file://) ，则路径相对 URL 会直接追加到其后：file:// + data.csv = file://data.csv。对于 file:// scheme，这表示相对于 user_files 目录的路径 (对于 clickhouse-local，则为当前目录) 。在这种情况下，点分段会保持原样，因此目标引擎会根据自身的 base 目录解析它们。

例如，如果 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 通配符时，最多可遍历的目录数量。