urlCluster - ClickHouse Documentation

Позволяет параллельно обрабатывать файлы по URL с множества узлов в указанном кластере. На инициаторе создаётся connection ко всем узлам кластера, раскрывается звёздочка в пути к файлу URL, после чего каждый файл динамически распределяется. На узле-воркере он запрашивает у инициатора следующую задачу на обработку и выполняет её. Это повторяется, пока не будут завершены все задачи.

Синтаксис

urlCluster(cluster_name, URL, format, structure)

Аргументы

Аргумент	Описание
`cluster_name`	Имя кластера, используемое для формирования набора адресов и параметров подключения к удалённым и локальным серверам.
`URL`	HTTP- или HTTPS-адрес сервера, принимающего запросы `GET`. Тип: String.
`format`	Формат данных. Тип: String.
`structure`	Структура таблицы в формате `'UserID UInt64, Name String'`. Определяет имена столбцов и их типы. Тип: String.

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

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

Примеры

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

Создайте простой HTTP-сервер с помощью стандартных средств Python 3 и запустите его:

from http.server import BaseHTTPRequestHandler, HTTPServer

class CSVHTTPServer(BaseHTTPRequestHandler):
    def do_GET(self):
        self.send_response(200)
        self.send_header('Content-type', 'text/csv')
        self.end_headers()

        self.wfile.write(bytes('Hello,1\nWorld,2\n', "utf-8"))

if __name__ == "__main__":
    server_address = ('127.0.0.1', 12345)
    HTTPServer(server_address, CSVHTTPServer).serve_forever()

SELECT * FROM urlCluster('cluster_simple','http://127.0.0.1:12345', CSV, 'column1 String, column2 UInt32')

Глоб-шаблоны в URL

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

​Синтаксис

​Аргументы

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

​Примеры

​Глоб-шаблоны в URL

​См. также

Синтаксис

Аргументы

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

Примеры

Глоб-шаблоны в URL

См. также