mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-10-04 07:30:52 +00:00
80 lines
2.5 KiB
Markdown
80 lines
2.5 KiB
Markdown
|
---
|
||
|
|
machine_translated: true
|
||
|
|
---
|
||
|
|
|
||
|
|
# URL (URL, Format) {#table_engines-url}
|
||
|
|
|
||
|
|
Gère les données sur un serveur HTTP / HTTPS distant. Ce moteur est similaire
|
||
|
|
à l' [Fichier](file.md) moteur.
|
||
|
|
|
||
|
|
## Utilisation du moteur dans le serveur ClickHouse {#using-the-engine-in-the-clickhouse-server}
|
||
|
|
|
||
|
|
Le `format` doit être celui que ClickHouse peut utiliser dans
|
||
|
|
`SELECT` les requêtes et, si nécessaire, en `INSERTs`. Pour la liste complète des formats pris en charge, voir
|
||
|
|
[Format](../../interfaces/formats.md#formats).
|
||
|
|
|
||
|
|
Le `URL` doit être conforme à la structure D'un Localisateur de ressources uniforme. L'URL spécifiée doit pointer vers un serveur
|
||
|
|
qui utilise le protocole HTTP ou HTTPS. Cela ne nécessite pas de
|
||
|
|
en-têtes supplémentaires pour obtenir une réponse du serveur.
|
||
|
|
|
||
|
|
`INSERT` et `SELECT` les requêtes sont transformées en `POST` et `GET` demande,
|
||
|
|
respectivement. Pour le traitement `POST` demandes, le serveur distant doit prendre en charge
|
||
|
|
[Encodage de transfert en morceaux](https://en.wikipedia.org/wiki/Chunked_transfer_encoding).
|
||
|
|
|
||
|
|
Vous pouvez limiter le nombre maximal de sauts de redirection HTTP GET en utilisant [max\_http\_get\_redirects](../settings/settings.md#setting-max_http_get_redirects) paramètre.
|
||
|
|
|
||
|
|
**Exemple:**
|
||
|
|
|
||
|
|
**1.** Créer un `url_engine_table` table sur le serveur :
|
||
|
|
|
||
|
|
``` sql
|
||
|
|
CREATE TABLE url_engine_table (word String, value UInt64)
|
||
|
|
ENGINE=URL('http://127.0.0.1:12345/', CSV)
|
||
|
|
```
|
||
|
|
|
||
|
|
**2.** Créez un serveur HTTP de base à l'aide des outils Python 3 standard et
|
||
|
|
démarrer:
|
||
|
|
|
||
|
|
``` python3
|
||
|
|
from http.server import BaseHTTPRequestHandler, HTTPServer
|
||
|
|
|
||
|
|
class CSVHTTPServer(BaseHTTPRequestHandler):
|
||
|
|
def do_GET(self):
|
||
|
|
self.send_response(200)
|
||
|
|
self.send_header('Content-type', 'text/csv')
|
||
|
|
self.end_headers()
|
||
|
|
|
||
|
|
self.wfile.write(bytes('Hello,1\nWorld,2\n', "utf-8"))
|
||
|
|
|
||
|
|
if __name__ == "__main__":
|
||
|
|
server_address = ('127.0.0.1', 12345)
|
||
|
|
HTTPServer(server_address, CSVHTTPServer).serve_forever()
|
||
|
|
```
|
||
|
|
|
||
|
|
``` bash
|
||
|
|
$ python3 server.py
|
||
|
|
```
|
||
|
|
|
||
|
|
**3.** Les données de la demande:
|
||
|
|
|
||
|
|
``` sql
|
||
|
|
SELECT * FROM url_engine_table
|
||
|
|
```
|
||
|
|
|
||
|
|
``` text
|
||
|
|
┌─word──┬─value─┐
|
||
|
|
│ Hello │ 1 │
|
||
|
|
│ World │ 2 │
|
||
|
|
└───────┴───────┘
|
||
|
|
```
|
||
|
|
|
||
|
|
## Les détails de mise en Œuvre {#details-of-implementation}
|
||
|
|
|
||
|
|
- Les lectures et les écritures peuvent être parallèles
|
||
|
|
- Pas pris en charge:
|
||
|
|
- `ALTER` et `SELECT...SAMPLE` opérations.
|
||
|
|
- Index.
|
||
|
|
- Réplication.
|
||
|
|
|
||
|
|
[Article Original](https://clickhouse.tech/docs/en/operations/table_engines/url/) <!--hide-->
|