Перейти к основному содержимому
Перейти к основному содержимому

Функция Таблицы url

Функция url создает таблицу из URL с заданным format и structure.

Функция url может быть использована в запросах SELECT и INSERT к данным в URL таблицах.

Синтаксис

Параметры

  • URL — адрес HTTP или HTTPS сервера, который может принимать GET или POST запросы (для запросов SELECT или INSERT соответственно). Тип: String.
  • format — Формат данных. Тип: String.
  • structure — Структура таблицы в формате 'UserID UInt64, Name String'. Определяет имена и типы колонок. Тип: String.
  • headers - Заголовки в формате 'headers('key1'='value1', 'key2'='value2')'. Вы можете установить заголовки для HTTP вызова.

Возвращаемое значение

Таблица с заданным форматом и структурой и с данными из определенного URL.

Примеры

Получение первых 3 строк таблицы, которая содержит колонки типа String и UInt32 с HTTP-сервера, который отвечает в CSV формате.

Вставка данных из URL в таблицу:

Globs в URL​

Шаблоны в фигурных скобках { } используются для генерации набора шардов или для указания адресов failover. Поддерживаемые типы шаблонов и примеры можно увидеть в описании функции remote. Символ | внутри шаблонов используется для указания адресов failover. Они перечисляются в том же порядке, в каком указаны в шаблоне. Количество сгенерированных адресов ограничено настройкой glob_expansion_max_elements.

Виртуальные Колонки​

  • _path — Путь к URL. Тип: LowCardinality(String).
  • _file — Имя ресурса URL. Тип: LowCardinality(String).
  • _size — Размер ресурса в байтах. Тип: Nullable(UInt64). Если размер неизвестен, значение равно NULL.
  • _time — Время последнего изменения файла. Тип: Nullable(DateTime). Если время неизвестно, значение равно NULL.
  • _headers - Заголовки HTTP-ответа. Тип: Map(LowCardinality(String), LowCardinality(String)).

Partitioning в стиле Hive​

Когда параметр use_hive_partitioning установлен в 1, ClickHouse будет определять partitioning в стиле Hive в пути (/name=value/) и позволит использовать колонки партиции как виртуальные колонки в запросе. Эти виртуальные колонки будут иметь такие же имена, как в партиционированном пути, но будут начинаться с _.

Пример

Использование виртуальной колонки, созданной с помощью partitioning в стиле Hive.

Настройки Хранения​

  • engine_url_skip_empty_files - позволяет пропускать пустые файлы при чтении. Отключено по умолчанию.
  • enable_url_encoding - позволяет включать/выключать декодирование/кодирование пути в uri. Включено по умолчанию.

Смотрите Также