.. _table_functions-remote: remote ------ Позволяет обратиться к удалённым серверам без создания таблицы типа ``Distributed``. Сигнатуры: .. code-block:: sql remote('addresses_expr', db, table[, 'user'[, 'password']]) remote('addresses_expr', db.table[, 'user'[, 'password']]) ``addresses_expr`` - выражение, генерирующее адреса удалённых серверов. Это может быть просто один адрес сервера. Адрес сервера - это ``хост:порт``, или только ``хост``. Хост может быть указан в виде имени сервера, или в виде IPv4 или IPv6 адреса. IPv6 адрес указывается в квадратных скобках. Порт - TCP-порт удалённого сервера. Если порт не указан, используется ``tcp_port`` из конфигурационного файла сервера (по умолчанию - 9000). .. important:: С IPv6-адресом обязательно указывать порт. Примеры: .. code-block:: text example01-01-1 example01-01-1:9000 localhost 127.0.0.1 [::]:9000 [2a02:6b8:0:1111::11]:9000 Адреса можно указать через запятую, в этом случае ClickHouse обработает запрос как распределённый, т.е. отправит его по всем указанным адресам как на шарды с разными данными. Пример: .. code-block:: text example01-01-1,example01-02-1 Часть выражения может быть указана в фигурных скобках. Предыдущий пример может быть записан следующим образом: .. code-block:: text example01-0{1,2}-1 В фигурных скобках может быть указан диапазон (неотрицательных целых) чисел через две точки. В этом случае, диапазон раскрывается в множество значений, генерирующих адреса шардов. Если запись первого числа начинается с нуля, то значения формируются с таким же выравниванием нулями. Предыдущий пример может быть записан следующим образом: .. code-block:: text example01-{01..02}-1 При наличии нескольких пар фигурных скобок, генерируется прямое произведение соответствующих множеств. Адреса или их фрагменты в фигурных скобках можно указать через символ \|. В этом случае, соответствующие множества адресов понимаются как реплики - запрос будет отправлен на первую живую реплику. При этом, реплики перебираются в порядке, согласно текущей настройке :ref:`load_balancing `. Пример: .. code-block:: text example01-{01..02}-{1|2} В этом примере указано два шарда, в каждом из которых имеется две реплики. Количество генерируемых адресов ограничено константой - сейчас это 1000 штук. Использование табличной функции ``remote`` менее оптимально, чем создание таблицы типа ``Distributed``, так как в этом случае, соединения с серверами устанавливаются заново при каждом запросе, в случае задания имён хостов, делается резолвинг имён, а также не ведётся подсчёт ошибок при работе с разными репликами. При обработке большого количества запросов, всегда создавайте ``Distributed`` таблицу заранее, не используйте табличную функцию ``remote``. Табличная функция ``remote`` может быть полезна для следующих случаях: * обращение на конкретный сервер в целях сравнения данных, отладки и тестирования; * запросы между разными кластерами ClickHouse в целях исследований; * нечастых распределённых запросов, задаваемых вручную; * распределённых запросов, где набор серверов определяется каждый раз заново. Если пользователь не задан,то используется ``default``. Если пароль не задан, то используется пустой пароль.