> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Табличная функция `remote` позволяет обращаться к удалённым серверам на лету, то есть без создания Distributed таблицы. Табличная функция `remoteSecure` аналогична `remote`, но использует защищённое соединение.
# remote, remoteSecure
Табличная функция `remote` позволяет обращаться к удалённым серверам на лету, то есть без создания [Distributed](/ru/reference/engines/table-engines/special/distributed) таблицы. Табличная функция `remoteSecure` аналогична `remote`, но использует защищённое соединение.
Обе функции можно использовать в запросах `SELECT` и `INSERT`.
## Синтаксис
```sql theme={null}
remote(addresses_expr, [db, table, user [, password], sharding_key])
remote(addresses_expr, [db.table, user [, password], sharding_key])
remote(named_collection[, option=value [,..]])
remoteSecure(addresses_expr, [db, table, user [, password], sharding_key])
remoteSecure(addresses_expr, [db.table, user [, password], sharding_key])
remoteSecure(named_collection[, option=value [,..]])
```
## Параметры
| Аргумент | Описание |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `addresses_expr` | Адрес удалённого сервера или выражение, генерирующее несколько адресов удалённых серверов. Формат: `host` или `host:port`.
`host` можно указать как имя сервера либо как адрес IPv4 или IPv6. Адрес IPv6 необходимо указывать в `[]`.
`port` — TCP-порт удалённого сервера. Если порт не указан, используется [tcp\_port](/ru/reference/settings/server-settings/settings#tcp_port) из файла конфигурации сервера для табличной функции `remote` (по умолчанию 9000) и [tcp\_port\_secure](/ru/reference/settings/server-settings/settings#tcp_port_secure) для табличной функции `remoteSecure` (по умолчанию 9440).
Для адресов IPv6 указание порта обязательно.
Если указан только параметр `addresses_expr`, для `db` и `table` по умолчанию используется `system.one`.
Тип: [String](/ru/reference/data-types/string). |
| `db` | Имя базы данных. Тип: [String](/ru/reference/data-types/string). |
| `table` | Имя таблицы. Тип: [String](/ru/reference/data-types/string). |
| `user` | Имя пользователя. Если не указано, используется `default`. Тип: [String](/ru/reference/data-types/string). |
| `password` | Пароль пользователя. Если не указан, используется пустой пароль. Тип: [String](/ru/reference/data-types/string). |
| `sharding_key` | Ключ сегментирования для распределения данных по узлам. Например: `insert into remote('127.0.0.1:9000,127.0.0.2', db, table, 'default', rand())`. Тип: [UInt32](/ru/reference/data-types/int-uint). |
Аргументы также можно передавать с помощью [именованных коллекций](/ru/concepts/features/configuration/server-config/named-collections).
## Возвращаемое значение
Таблица, расположенная на удалённом сервере.
## Использование
Поскольку табличные функции `remote` и `remoteSecure` заново устанавливают соединение для каждого запроса, вместо них рекомендуется использовать таблицу `Distributed`. Кроме того, если указаны имена хостов, выполняется разрешение имён, а ошибки при работе с различными репликами не учитываются. При обработке большого количества запросов всегда заранее создавайте таблицу `Distributed` и не используйте табличную функцию `remote`.
Табличная функция `remote` может быть полезна в следующих случаях:
* Однократная миграция данных из одной системы в другую
* Доступ к конкретному серверу для сравнения данных, отладки и тестирования, то есть разовые ad hoc-подключения.
* Запросы между различными кластерами ClickHouse в исследовательских целях.
* Нечастые распределённые запросы, выполняемые вручную.
* Распределённые запросы, в которых набор серверов каждый раз задаётся заново.
### Адреса
```text theme={null}
example01-01-1
example01-01-1:9440
example01-01-1:9000
localhost
127.0.0.1
[::]:9440
[::]:9000
[2a02:6b8:0:1111::11]:9000
```
Несколько адресов можно указать через запятую. В этом случае ClickHouse будет использовать распределённую обработку и отправлять запрос на все указанные адреса (как в случае с сегментами, содержащими разные данные). Пример:
```text theme={null}
example01-01-1,example01-02-1
```
## Примеры
### Выборка данных с удалённого сервера:
```sql theme={null}
SELECT * FROM remote('127.0.0.1', db.remote_engine_table) LIMIT 3;
```
Или используя [именованные коллекции](/ru/concepts/features/configuration/server-config/named-collections):
```sql theme={null}
CREATE NAMED COLLECTION creds AS
host = '127.0.0.1',
database = 'db';
SELECT * FROM remote(creds, table='remote_engine_table') LIMIT 3;
```
### Вставка данных в таблицу на удалённом сервере:
```sql theme={null}
CREATE TABLE remote_table (name String, value UInt32) ENGINE=Memory;
INSERT INTO FUNCTION remote('127.0.0.1', currentDatabase(), 'remote_table') VALUES ('test', 42);
SELECT * FROM remote_table;
```
### Миграция таблиц из одной системы в другую:
В этом примере используется одна таблица из набора демонстрационных данных. База данных — `imdb`, а таблица — `actors`.
#### В исходной системе ClickHouse (системе, где сейчас хранятся данные)
* Проверьте исходную базу данных и имя таблицы (`imdb.actors`)
```sql theme={null}
show databases
```
```sql theme={null}
show tables in imdb
```
* Получите оператор CREATE TABLE в исходной системе:
```sql theme={null}
SELECT create_table_query
FROM system.tables
WHERE database = 'imdb' AND table = 'actors'
```
Ответ
```sql theme={null}
CREATE TABLE imdb.actors (`id` UInt32,
`first_name` String,
`last_name` String,
`gender` FixedString(1))
ENGINE = MergeTree
ORDER BY (id, first_name, last_name, gender);
```
#### В целевой системе ClickHouse
* Создайте целевую базу данных:
```sql theme={null}
CREATE DATABASE imdb
```
* Используя оператор CREATE TABLE из исходной системы, создайте целевую таблицу:
```sql theme={null}
CREATE TABLE imdb.actors (`id` UInt32,
`first_name` String,
`last_name` String,
`gender` FixedString(1))
ENGINE = MergeTree
ORDER BY (id, first_name, last_name, gender);
```
#### Возвращаемся к исходному развертыванию
Выполните вставку данных в новую базу данных и таблицу, созданные в удаленной системе. Вам понадобятся host, port, имя пользователя, пароль, база данных пункта назначения и целевая таблица.
```sql theme={null}
INSERT INTO FUNCTION
remoteSecure('remote.clickhouse.cloud:9440', 'imdb.actors', 'USER', 'PASSWORD')
SELECT * from imdb.actors
```
## Глоббинг
Шаблоны в `{ }` используются для генерации набора сегментов и указания реплик. Если есть несколько пар `{ }`, генерируется декартово произведение соответствующих наборов.
Поддерживаются следующие типы шаблонов.
* `{a,b,c}` - Обозначает любую из альтернативных строк `a`, `b` или `c`. Шаблон заменяется на `a` в адресе первого сегмента, на `b` — в адресе второго сегмента и так далее. Например, `example0{1,2}-1` генерирует адреса `example01-1` и `example02-1`.
* `{N..M}` - Диапазон чисел. Этот шаблон генерирует адреса сегментов с последовательно возрастающими индексами от `N` до `M` включительно. Например, `example0{1..2}-1` генерирует `example01-1` и `example02-1`.
* `{0n..0m}` - Диапазон чисел с ведущими нулями. Этот шаблон сохраняет ведущие нули в индексах. Например, `example{01..03}-1` генерирует `example01-1`, `example02-1` и `example03-1`.
* `{a|b}` - Любое количество вариантов, разделённых символом `|`. Шаблон задаёт реплики. Например, `example01-{1|2}` генерирует реплики `example01-1` и `example01-2`.
Запрос будет отправлен на первую работоспособную реплику. Однако для `remote` реплики перебираются в порядке, заданном параметром [load\_balancing](/ru/reference/settings/session-settings#load_balancing).
Количество генерируемых адресов ограничено параметром [table\_function\_remote\_max\_addresses](/ru/reference/settings/session-settings#table_function_remote_max_addresses).