2020-03-30 12:48:55 +00:00
---
machine_translated: true
2020-05-15 04:34:54 +00:00
machine_translated_rev: 72537a2d527c63c07aa5d2361a8829f3895cf2bd
2020-04-04 09:15:31 +00:00
toc_priority: 41
toc_title: URL
2020-03-30 12:48:55 +00:00
---
# URL (URL, Format) {#table_engines-url}
Gère les données sur un serveur HTTP / HTTPS distant. Ce moteur est similaire
2020-05-15 04:34:54 +00:00
à l' [Fichier ](file.md ) moteur.
2020-03-30 12:48:55 +00:00
2020-05-15 04:34:54 +00:00
## Utilisation du moteur dans le serveur ClickHouse {#using-the-engine-in-the-clickhouse-server}
2020-03-30 12:48:55 +00:00
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
2020-04-04 09:15:31 +00:00
[Format ](../../../interfaces/formats.md#formats ).
2020-03-30 12:48:55 +00:00
2020-05-15 04:34:54 +00:00
Le `URL` doit être conforme à la structure D'un Localisateur de ressources uniforme. L'URL spécifiée doit pointer vers un serveur
2020-03-30 12:48:55 +00:00
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 ).
2020-04-04 09:15:31 +00:00
Vous pouvez limiter le nombre maximal de sauts de redirection HTTP GET en utilisant [max\_http\_get\_redirects ](../../../operations/settings/settings.md#setting-max_http_get_redirects ) paramètre.
2020-03-30 12:48:55 +00:00
**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)
```
2020-05-15 04:34:54 +00:00
**2.** Créez un serveur HTTP de base à l'aide des outils Python 3 standard et
2020-03-30 12:48:55 +00:00
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 │
└───────┴───────┘
```
2020-05-15 04:34:54 +00:00
## Les détails de mise en Œuvre {#details-of-implementation}
2020-03-30 12:48:55 +00:00
- 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-->