mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-26 09:32:01 +00:00
a0661953a6
* add cluster() adn clusterAllReplicas() table functions description, add signatures to remoteSecure() table function Signed-off-by: Slach <bloodjazman@gmail.com> * small russian fixes Signed-off-by: Slach <bloodjazman@gmail.com> * Update docs/en/sql-reference/table-functions/cluster.md Co-authored-by: Ivan Blinkov <github@blinkov.ru> * Update docs/en/sql-reference/table-functions/cluster.md Co-authored-by: Ivan Blinkov <github@blinkov.ru> * Update docs/en/sql-reference/table-functions/cluster.md Co-authored-by: Ivan Blinkov <github@blinkov.ru> * Update docs/en/sql-reference/table-functions/cluster.md Co-authored-by: Ivan Blinkov <github@blinkov.ru> * Update docs/en/sql-reference/table-functions/cluster.md Co-authored-by: Ivan Blinkov <github@blinkov.ru> * Update docs/en/sql-reference/table-functions/cluster.md Co-authored-by: Ivan Blinkov <github@blinkov.ru> Co-authored-by: Ivan Blinkov <github@blinkov.ru>
86 lines
4.0 KiB
Markdown
86 lines
4.0 KiB
Markdown
---
|
||
machine_translated: true
|
||
machine_translated_rev: 72537a2d527c63c07aa5d2361a8829f3895cf2bd
|
||
toc_priority: 40
|
||
toc_title: remoto
|
||
---
|
||
|
||
# remoto, remoteSecure {#remote-remotesecure}
|
||
|
||
Le permite acceder a servidores remotos sin crear un `Distributed` tabla.
|
||
|
||
Firma:
|
||
|
||
``` sql
|
||
remote('addresses_expr', db, table[, 'user'[, 'password']])
|
||
remote('addresses_expr', db.table[, 'user'[, 'password']])
|
||
remoteSecure('addresses_expr', db, table[, 'user'[, 'password']])
|
||
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` o simplemente `host`. El host se puede especificar como nombre de servidor o como dirección IPv4 o IPv6. Una dirección IPv6 se especifica entre corchetes. El puerto es el puerto TCP del servidor remoto. Si se omite el puerto, utiliza `tcp_port` del archivo de configuración del servidor (por defecto, 9000).
|
||
|
||
!!! important "Importante"
|
||
El puerto es necesario para una dirección IPv6.
|
||
|
||
Ejemplos:
|
||
|
||
``` text
|
||
example01-01-1
|
||
example01-01-1:9000
|
||
localhost
|
||
127.0.0.1
|
||
[::]:9000
|
||
[2a02:6b8:0:1111::11]:9000
|
||
```
|
||
|
||
Se pueden separar varias direcciones por comas. En este caso, ClickHouse usará procesamiento distribuido, por lo que enviará la consulta a todas las direcciones especificadas (como a fragmentos con datos diferentes).
|
||
|
||
Ejemplo:
|
||
|
||
``` text
|
||
example01-01-1,example01-02-1
|
||
```
|
||
|
||
Parte de la expresión se puede especificar entre llaves. El ejemplo anterior se puede escribir de la siguiente manera:
|
||
|
||
``` text
|
||
example01-0{1,2}-1
|
||
```
|
||
|
||
Los corchetes rizados pueden contener un rango de números separados por dos puntos (enteros no negativos). En este caso, el rango se expande a un conjunto de valores que generan direcciones de fragmentos. Si el primer número comienza con cero, los valores se forman con la misma alineación cero. El ejemplo anterior se puede escribir de la siguiente manera:
|
||
|
||
``` text
|
||
example01-{01..02}-1
|
||
```
|
||
|
||
Si tiene varios pares de llaves, genera el producto directo de los conjuntos correspondientes.
|
||
|
||
Las direcciones y partes de las direcciones entre llaves se pueden separar mediante el símbolo de tubería (\|). En este caso, los conjuntos de direcciones correspondientes se interpretan como réplicas y la consulta se enviará a la primera réplica en buen estado. Sin embargo, las réplicas se iteran en el orden establecido actualmente en el [load\_balancing](../../operations/settings/settings.md) configuración.
|
||
|
||
Ejemplo:
|
||
|
||
``` text
|
||
example01-{01..02}-{1|2}
|
||
```
|
||
|
||
En este ejemplo se especifican dos fragmentos que tienen dos réplicas cada uno.
|
||
|
||
El número de direcciones generadas está limitado por una constante. En este momento esto es 1000 direcciones.
|
||
|
||
Uso de la `remote` función de la tabla es menos óptima que la creación de un `Distributed` mesa, porque en este caso, la conexión del servidor se restablece para cada solicitud. Además, si se establecen nombres de host, los nombres se resuelven y los errores no se cuentan cuando se trabaja con varias réplicas. Cuando procese un gran número de consultas, cree siempre el `Distributed` mesa antes de tiempo, y no utilice el `remote` función de la tabla.
|
||
|
||
El `remote` puede ser útil en los siguientes casos:
|
||
|
||
- Acceder a un servidor específico para la comparación de datos, la depuración y las pruebas.
|
||
- Consultas entre varios clústeres de ClickHouse con fines de investigación.
|
||
- Solicitudes distribuidas poco frecuentes que se realizan manualmente.
|
||
- Solicitudes distribuidas donde el conjunto de servidores se redefine cada vez.
|
||
|
||
Si el usuario no está especificado, `default` se utiliza.
|
||
Si no se especifica la contraseña, se utiliza una contraseña vacía.
|
||
|
||
`remoteSecure` - igual que `remote` but with secured connection. Default port — [Tcp\_port\_secure](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-tcp_port_secure) de config o 9440.
|
||
|
||
[Artículo Original](https://clickhouse.tech/docs/en/query_language/table_functions/remote/) <!--hide-->
|