ClickHouse/docs/fr/sql-reference/table-functions/remote.md

84 lines
3.9 KiB
Markdown
Raw Normal View History

---
machine_translated: true
machine_translated_rev: f865c9653f9df092694258e0ccdd733c339112f5
toc_priority: 40
toc_title: distant
---
# à distance, remoteSecure {#remote-remotesecure}
Vous permet daccéder à des serveurs distants sans `Distributed` table.
Signature:
``` sql
remote('addresses_expr', db, table[, 'user'[, 'password']])
remote('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` ou juste `host`. Lhôte peut être spécifié comme nom de serveur ou ladresse IPv4 ou IPv6. Une adresse IPv6 est indiquée entre crochets. Le port est le port TCP sur le serveur distant. Si le port est omis, il utilise `tcp_port` à partir du fichier de configuration du serveur (par défaut, 9000).
!!! important "Important"
Le port est requis pour une adresse IPv6.
Exemple:
``` text
example01-01-1
example01-01-1:9000
localhost
127.0.0.1
[::]:9000
[2a02:6b8:0:1111::11]:9000
```
Plusieurs adresses séparées par des virgules. Dans ce cas, ClickHouse utilisera le traitement distribué, donc il enverra la requête à toutes les adresses spécifiées (comme les fragments avec des données différentes).
Exemple:
``` text
example01-01-1,example01-02-1
```
Une partie de lexpression peut être spécifiée entre crochets. Lexemple précédent peut être écrite comme suit:
``` text
example01-0{1,2}-1
```
Les accolades peuvent contenir une plage de Nombres séparés par deux points (entiers non négatifs). Dans ce cas, la gamme est étendue à un ensemble de valeurs qui génèrent fragment dadresses. Si le premier nombre commence par zéro, les valeurs sont formées avec le même alignement zéro. Lexemple précédent peut être écrite comme suit:
``` text
example01-{01..02}-1
```
Si vous avez plusieurs paires daccolades, il génère le produit direct des ensembles correspondants.
Les adresses et les parties dadresses entre crochets peuvent être séparées par le symbole de tuyau (\|). Dans ce cas, les ensembles correspondants de adresses sont interprétés comme des répliques, et la requête sera envoyée à la première sain réplique. Cependant, les répliques sont itérées dans lordre actuellement défini dans [équilibrage](../../operations/settings/settings.md) paramètre.
Exemple:
``` text
example01-{01..02}-{1|2}
```
Cet exemple spécifie deux fragments qui ont chacun deux répliques.
Le nombre dadresses générées est limitée par une constante. En ce moment, cest 1000 adresses.
À laide de la `remote` la fonction de table est moins optimale que la création dun `Distributed` table, car dans ce cas, la connexion au serveur est rétablie pour chaque requête. En outre, si des noms dhôte, les noms sont résolus, et les erreurs ne sont pas comptés lors de travail avec diverses répliques. Lors du traitement dun grand nombre de requêtes, créez toujours `Distributed` table à lavance, et ne pas utiliser la `remote` table de fonction.
Le `remote` table de fonction peut être utile dans les cas suivants:
- Accès à un serveur spécifique pour la comparaison de données, le débogage et les tests.
- Requêtes entre différents clusters ClickHouse à des fins de recherche.
- Demandes distribuées peu fréquentes qui sont faites manuellement.
- Distribué demandes où lensemble des serveurs est redéfinie à chaque fois.
Si lutilisateur nest pas spécifié, `default` est utilisée.
Si le mot de passe nest spécifié, un mot de passe vide est utilisé.
`remoteSecure` - la même chose 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 ou 9440.
[Article Original](https://clickhouse.tech/docs/en/query_language/table_functions/remote/) <!--hide-->