mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-29 11:02:08 +00:00
4a24d4f3ad
* Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
68 lines
5.1 KiB
ReStructuredText
68 lines
5.1 KiB
ReStructuredText
remote
|
||
------
|
||
|
||
``remote('addresses_expr', db, table[, 'user'[, 'password']])``
|
||
|
||
или
|
||
|
||
``remote('addresses_expr', db.table[, 'user'[, 'password']])``
|
||
|
||
- позволяет обратиться к удалённым серверам без создания таблицы типа Distributed.
|
||
|
||
``addresses_expr`` - выражение, генерирующее адреса удалённых серверов.
|
||
|
||
Это может быть просто один адрес сервера. Адрес сервера - это хост:порт, или только хост. Хост может быть указан в виде имени сервера, или в виде IPv4 или IPv6 адреса. IPv6 адрес указывается в квадратных скобках. Порт - TCP-порт удалённого сервера. Если порт не указан, используется tcp_port из конфигурационного файла сервера (по умолчанию - 9000).
|
||
|
||
Замечание: в качестве исключения, при указании IPv6-адреса, обязательно также указывать порт.
|
||
|
||
Примеры:
|
||
::
|
||
|
||
example01-01-1
|
||
example01-01-1:9000
|
||
localhost
|
||
127.0.0.1
|
||
[::]:9000
|
||
[2a02:6b8:0:1111::11]:9000
|
||
|
||
Могут быть указаны адреса через запятую - в этом случае, запрос пойдёт на все указанные адреса (как на шарды с разными данными) и будет обработан распределённо.
|
||
|
||
Пример:
|
||
::
|
||
|
||
example01-01-1,example01-02-1
|
||
|
||
Часть выражения может быть указана в фигурных скобках. Предыдущий пример может быть записан следующим образом:
|
||
::
|
||
|
||
example01-0{1,2}-1
|
||
|
||
В фигурных скобках может быть указан диапазон (неотрицательных целых) чисел через две точки. В этом случае, диапазон раскрывается в множество значений, генерирующих адреса шардов. Если запись первого числа начинается с нуля, то значения формируются с таким же выравниванием нулями. Предыдущий пример может быть записан следующим образом:
|
||
::
|
||
|
||
example01-{01..02}-1
|
||
|
||
При наличии нескольких пар фигурных скобок, генерируется прямое произведение соответствующих множеств.
|
||
|
||
Адреса или их фрагменты в фигурных скобках, могут быть указаны через символ |. В этом случае, соответствующие множества адресов понимаются как реплики - запрос будет отправлен на первую живую реплику. При этом, реплики перебираются в порядке, согласно текущей настройке load_balancing.
|
||
|
||
Пример:
|
||
::
|
||
|
||
example01-{01..02}-{1|2}
|
||
|
||
В этом примере указано два шарда, в каждом из которых имеется две реплики.
|
||
|
||
Количество генерируемых адресов ограничено некоторой константой - сейчас это 1000 штук.
|
||
|
||
Использование табличной функции remote менее оптимально, чем создание таблицы типа Distributed, так как в этом случае, соединения с серверами устанавливаются заново при каждом запросе, в случае задания имён хостов, делается резолвинг имён, а также не ведётся подсчёт ошибок при работе с разными репликами. При обработке большого количества запросов, всегда создавайте Distributed таблицу заранее, не используйте табличную функцию remote.
|
||
|
||
Табличная функция remote может быть полезна для следующих случаев:
|
||
* обращение на конкретный сервер в целях сравнения данных, отладки и тестирования;
|
||
* запросы между разными кластерами ClickHouse в целях исследований;
|
||
* нечастых распределённых запросов, задаваемых вручную;
|
||
* распределённых запросов, где набор серверов определяется каждый раз заново.
|
||
|
||
Имя пользователя может быть не задано - тогда используется имя пользователя 'default'.
|
||
Пароль может быть не задан - тогда используется пустой пароль.
|