Skip to main content
Skip to main content
Edit this page

url

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

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

Синтаксис

Параметры

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

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

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

Примеры

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

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

Символы подстановки в URL​

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

Виртуальные столбцы​

  • _path — Путь до URL.
  • _file — Имя ресурса URL.

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