> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentation de la SQL Console intégrée, exposée par le serveur HTTP ClickHouse à l’adresse `/ui`

# SQL Console

La SQL Console est une web UI intégrée permettant d’exécuter des requêtes et d’explorer les données. Elle est accessible depuis n’importe quel port HTTP de ClickHouse, sur le chemin `/ui`, par exemple `http://localhost:8123/ui`.

<Note>
  La SQL Console est une fonctionnalité expérimentale.
</Note>

<h2 id="overview">
  Overview
</h2>

La SQL Console est une application monopage (SPA) compilée sous forme de bundle statique et intégrée directement dans le binary ClickHouse, tout comme ClickStack est intégré à `/clickstack`. Toutes les ressources sont servies par le binary ClickHouse lui-même — aucun CDN third-party n'est chargé.

Pour l'ouvrir, accédez à `/ui` sur n'importe quel port HTTP de ClickHouse (par exemple, `http://localhost:8123/ui`).

<h2 id="how-it-is-served">
  Comment il est servi
</h2>

Le bundle est compressé en gzip au moment du build et intégré avec `#embed`, de sorte que chaque réponse de `/ui` comporte un header `Content-Encoding: gzip`. Comme la SQL Console est une application monopage qui effectue le routage côté client, les requêtes sous `/ui` qui ne correspondent à aucune ressource embarquée et qui ne ressemblent pas à un fichier (c'est-à-dire sans extension) basculent vers le service de `index.html`. Les requêtes vers des paths qui ressemblent à des ressources manquantes (par exemple `/ui/nonexistent.js`) renvoient le status HTTP `404 Not Found`.

Le path `/ui` est mis en correspondance de manière exacte ou lorsqu'il est suivi d'une délimitation `/`, `?` ou `#`, si bien que les routes voisines telles que `/uix` ne sont pas détournées par le fallback de la SPA.

<h2 id="relationship-to-other-web-uis">
  Relation avec les autres UI web
</h2>

ClickHouse fournit plusieurs interfaces web intégrées, exposées sur le port HTTP :

* [`/play`](/fr/interfaces/web-sql) — l'UI Web SQL légère.
* `/dashboard` — les dashboards intégrés.
* `/clickstack` — l'UI ClickStack intégrée.
* `/ui` — la SQL Console décrite ici.

Les liens vers chacune d'elles figurent sur la page d'accueil du serveur HTTP de ClickHouse.

<h2 id="authentication">
  Authentification
</h2>

La SQL Console s'authentifie via les mêmes vérifications de `Session` et de contrôle d'accès que le protocole HTTP. La diffusion des ressources statiques de l'UI sur `/ui` ne nécessite pas d'authentification ; les requêtes émises par l'UI sont authentifiées comme n'importe quelle autre requête HTTP.