mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-19 21:03:51 +00:00
c7e526e050
* Additional .gitignore entries * Merge a bunch of small articles about system tables into single one * Merge a bunch of small articles about formats into single one * Adapt table with formats to English docs too * Add SPb meetup link to main page * Move Utilities out of top level of docs (the location is probably not yet final) + translate couple articles * Merge MacOS.md into build_osx.md * Move Data types higher in ToC * Publish changelog on website alongside documentation * Few fixes for en/table_engines/file.md * Use smaller header sizes in changelogs * Group up table engines inside ToC * Move table engines out of top level too * Specificy in ToC that query language is SQL based. Thats a bit excessive, but catches eye. * Move stuff that is part of query language into respective folder * Move table functions lower in ToC * Lost redirects.txt update * Do not rely on comments in yaml + fix few ru titles * Extract major parts of queries.md into separate articles * queries.md has been supposed to be removed * Fix weird translation * Fix a bunch of links * There is only table of contents left * "Query language" is actually part of SQL abbreviation * Change filename in README.md too * fix mistype * s/formats\/interfaces/interfaces\/formats/g * Remove extra clarification from header as it was too verbose, probably making it a bit more confusing * Empty article was supposed to be hidden * At least change incorrect title * Move special links to the bottom of nav and slightly highlight them * Skip hidden pages in bottom navigation too * Make front page of documentation to be part of Introduction * Make tables in introduction somewhat readable + move abbreviation definitions earlier * Some introduction text refactoring * Some docs introduction refactoring * Use admonitions instead of divs * Additional .gitignore * Treat .gif as images too * Clarify ToC item
75 lines
5.1 KiB
Markdown
75 lines
5.1 KiB
Markdown
<a name="table_functions-remote"></a>
|
||
|
||
# remote
|
||
|
||
Позволяет обратиться к удалённым серверам без создания таблицы типа `Distributed`.
|
||
|
||
Сигнатуры:
|
||
|
||
```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-адресом обязательно нужно указывать порт.
|
||
|
||
Примеры:
|
||
|
||
```text
|
||
example01-01-1
|
||
example01-01-1:9000
|
||
localhost
|
||
127.0.0.1
|
||
[::]:9000
|
||
[2a02:6b8:0:1111::11]:9000
|
||
```
|
||
|
||
Адреса можно указать через запятую, в этом случае ClickHouse обработает запрос как распределённый, т.е. отправит его по всем указанным адресам как на шарды с разными данными.
|
||
|
||
Пример:
|
||
|
||
```text
|
||
example01-01-1,example01-02-1
|
||
```
|
||
|
||
Часть выражения может быть указана в фигурных скобках. Предыдущий пример может быть записан следующим образом:
|
||
|
||
```text
|
||
example01-0{1,2}-1
|
||
```
|
||
|
||
В фигурных скобках может быть указан диапазон (неотрицательных целых) чисел через две точки. В этом случае, диапазон раскрывается в множество значений, генерирующих адреса шардов. Если запись первого числа начинается с нуля, то значения формируются с таким же выравниванием нулями. Предыдущий пример может быть записан следующим образом:
|
||
|
||
```text
|
||
example01-{01..02}-1
|
||
```
|
||
|
||
При наличии нескольких пар фигурных скобок, генерируется прямое произведение соответствующих множеств.
|
||
|
||
Адреса или их фрагменты в фигурных скобках можно указать через символ |. В этом случае, соответствующие множества адресов понимаются как реплики - запрос будет отправлен на первую живую реплику. При этом, реплики перебираются в порядке, согласно текущей настройке [load_balancing](../../operations/settings/settings.md#settings-load_balancing).
|
||
|
||
Пример:
|
||
|
||
```text
|
||
example01-{01..02}-{1|2}
|
||
```
|
||
|
||
В этом примере указано два шарда, в каждом из которых имеется две реплики.
|
||
|
||
Количество генерируемых адресов ограничено константой - сейчас это 1000 штук.
|
||
|
||
Использование табличной функции `remote` менее оптимально, чем создание таблицы типа `Distributed`, так как в этом случае, соединения с серверами устанавливаются заново при каждом запросе, в случае задания имён хостов, делается резолвинг имён, а также не ведётся подсчёт ошибок при работе с разными репликами. При обработке большого количества запросов, всегда создавайте `Distributed` таблицу заранее, не используйте табличную функцию `remote`.
|
||
|
||
Табличная функция `remote` может быть полезна для следующих случаях:
|
||
|
||
- обращение на конкретный сервер в целях сравнения данных, отладки и тестирования;
|
||
- запросы между разными кластерами ClickHouse в целях исследований;
|
||
- нечастых распределённых запросов, задаваемых вручную;
|
||
- распределённых запросов, где набор серверов определяется каждый раз заново.
|
||
|
||
Если пользователь не задан,то используется `default`.
|
||
Если пароль не задан, то используется пустой пароль.
|