Help wanted!

The following content of this documentation page has been machine-translated. But unlike other websites, it is not done on the fly. This translated text lives on GitHub repository alongside main ClickHouse codebase and waits for fellow native speakers to make it more human-readable. You can also use the original English version as a reference.

Help ClickHouse documentation by editing this page

远程，远程安全

允许您访问远程服务器，而无需创建 Distributed 桌子

签名:

  1. remote('addresses_expr', db, table[, 'user'[, 'password']])
  2. remote('addresses_expr', db.table[, 'user'[, 'password']])
  3. remoteSecure('addresses_expr', db, table[, 'user'[, 'password']])
  4. remoteSecure('addresses_expr', db.table[, 'user'[, 'password']])

addresses_expr – An expression that generates addresses of remote servers. This may be just one server address. The server address is host:port，或者只是 host. 主机可以指定为服务器名称，也可以指定为IPv4或IPv6地址。 IPv6地址在方括号中指定。 端口是远程服务器上的TCP端口。 如果省略端口，它使用 tcp_port 从服务器的配置文件（默认情况下，9000）。

重要事项

IPv6地址需要该端口。

例:

  1. example01-01-1
  2. example01-01-1:9000
  3. localhost
  4. 127.0.0.1
  5. [::]:9000
  6. [2a02:6b8:0:1111::11]:9000

多个地址可以用逗号分隔。 在这种情况下，ClickHouse将使用分布式处理，因此它将将查询发送到所有指定的地址（如具有不同数据的分片）。

示例:

  1. example01-01-1,example01-02-1

表达式的一部分可以用大括号指定。 前面的示例可以写成如下:

  1. example01-0{1,2}-1

大括号可以包含由两个点（非负整数）分隔的数字范围。 在这种情况下，范围将扩展为生成分片地址的一组值。 如果第一个数字以零开头，则使用相同的零对齐形成值。 前面的示例可以写成如下:

  1. example01-{01..02}-1

如果您有多对大括号，它会生成相应集合的直接乘积。

大括号中的地址和部分地址可以用管道符号(|)分隔。 在这种情况下，相应的地址集被解释为副本，并且查询将被发送到第一个正常副本。 但是，副本将按照当前设置的顺序进行迭代 load_balancing 设置。

示例:

  1. example01-{01..02}-{1|2}

此示例指定两个分片，每个分片都有两个副本。

生成的地址数由常量限制。 现在这是1000个地址。

使用 remote 表函数比创建一个不太优化 Distributed 表，因为在这种情况下，服务器连接被重新建立为每个请求。 此外，如果设置了主机名，则会解析这些名称，并且在使用各种副本时不会计算错误。 在处理大量查询时，始终创建 Distributed 表的时间提前，不要使用 remote 表功能。

该 remote 表函数可以在以下情况下是有用的:

  • 访问特定服务器进行数据比较、调试和测试。
  • 查询之间的各种ClickHouse群集用于研究目的。
  • 手动发出的罕见分布式请求。
  • 每次重新定义服务器集的分布式请求。

如果未指定用户, default 被使用。
如果未指定密码，则使用空密码。

remoteSecure -相同 remote but with secured connection. Default port — tcp_port_secure 从配置或9440.

原始文章