> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentation du format Pretty

# Pretty

| Entrée | Sortie | Alias |
| - | - | - |
| ✗ | ✔ | |

## Description

Le format `Pretty` affiche les données sous forme de tableaux en Unicode,
en utilisant des séquences d'échappement ANSI pour afficher les couleurs dans le terminal.
La grille complète du tableau est tracée, et chaque ligne du tableau occupe deux lignes dans le terminal.
Chaque bloc de résultats est affiché dans un tableau distinct.
Cela est nécessaire pour que les blocs puissent être affichés sans mise en mémoire tampon des résultats (une mise en mémoire tampon serait nécessaire pour précalculer la largeur visible de toutes les valeurs).

[NULL](/docs/fr/reference/syntax.md) s'affiche sous la forme `ᴺᵁᴸᴸ`.

## Exemple d'utilisation

Exemple (pour le format [`PrettyCompact`](/docs/fr/reference/formats/Pretty/PrettyCompact)) :

```sql title="Query" theme={null}
SELECT * FROM t_null
```

```response title="Response" theme={null}
┌─x─┬────y─┐
│ 1 │ ᴺᵁᴸᴸ │
└───┴──────┘
```

Les lignes ne sont pas échappées dans les formats `Pretty`. Les caractères de contrôle non imprimables (contrôles C0 `0x00`-`0x1F` et `DEL` `0x7F`) présents dans les valeurs et dans les noms de colonnes sont en revanche affichés par défaut sous la forme des « Control Pictures » Unicode correspondantes (`U+2400`-`U+2421`), afin qu’ils restent visibles et ne déforment pas la table. Par exemple, un caractère NUL est affiché sous la forme `␀` :

```sql title="Query" theme={null}
SELECT 'String with a NUL \0 character' AS Escaping_test FORMAT PrettyCompact
```

```response title="Response" theme={null}
┌─Escaping_test─────────────────┐
│ String with a NUL ␀ character │
└───────────────────────────────┘
```

`TAB`, le saut de ligne et `ESC` font exception : ils sont toujours affichés tels quels, car un terminal les interprète au lieu de les ignorer — une tabulation fait avancer le curseur jusqu’au taquet de tabulation suivant, et c’est grâce à une séquence d’échappement ANSI que les données peuvent embarquer une visualisation. Un saut de ligne continue lui aussi de provoquer un retour à la ligne : à l’intérieur d’une cellule de table lorsque [`output_format_pretty_multiline_fields`](/docs/fr/reference/settings/formats#output_format_pretty_multiline_fields) est activé, et tel quel dans le cas contraire. Les noms de colonnes constituent l’exception à cette exception : l’en-tête et le pied de table tiennent sur une seule ligne, si bien qu’un saut de ligne dans un nom est remplacé comme n’importe quel autre caractère de contrôle.

Pour afficher à la place les caractères de contrôle tels quels, désactivez [`output_format_pretty_display_control_characters`](/docs/fr/reference/settings/formats#output_format_pretty_display_control_characters) :

```sql title="Query" theme={null}
SELECT 'String with a NUL \0 character' AS Escaping_test FORMAT PrettyCompact
SETTINGS output_format_pretty_display_control_characters = 0
```

La réponse contient alors l’octet `NUL` brut. Un terminal l’absorbe : le caractère
est donc invisible et la ligne dépasse d’une position la bordure calculée pour elle — d’où
la table déformée que l’affichage du Control Picture permet d’éviter.

Pour éviter d’afficher trop de données dans le terminal, seules les `10,000` premières lignes sont imprimées.
Si le nombre de lignes est supérieur ou égal à `10,000`, le message "Showed first 10 000" s’affiche.

> [!NOTE]
>
> Ce format convient uniquement à l’affichage d’un résultat de la requête, mais pas au parsing des données.

Le format Pretty prend en charge l’affichage des totaux (lors de l’utilisation de `WITH TOTALS`) et des valeurs extrêmes (lorsque 'extremes' est défini sur 1).
Dans ces cas, les totaux et les valeurs extrêmes sont affichés après les données principales, dans des tables distinctes.
Ceci est illustré dans l’exemple suivant, qui utilise le format [`PrettyCompact`](/docs/fr/reference/formats/Pretty/PrettyCompact) :

```sql title="Query" theme={null}
SELECT EventDate, count() AS c 
FROM test.hits 
GROUP BY EventDate 
WITH TOTALS 
ORDER BY EventDate 
FORMAT PrettyCompact
```

```response title="Response" theme={null}
┌──EventDate─┬───────c─┐
│ 2014-03-17 │ 1406958 │
│ 2014-03-18 │ 1383658 │
│ 2014-03-19 │ 1405797 │
│ 2014-03-20 │ 1353623 │
│ 2014-03-21 │ 1245779 │
│ 2014-03-22 │ 1031592 │
│ 2014-03-23 │ 1046491 │
└────────────┴─────────┘

Totals:
┌──EventDate─┬───────c─┐
│ 1970-01-01 │ 8873898 │
└────────────┴─────────┘

Extremes:
┌──EventDate─┬───────c─┐
│ 2014-03-17 │ 1031592 │
│ 2014-03-23 │ 1406958 │
└────────────┴─────────┘
```

## Paramètres de format

Les paramètres suivants sont communs à tous les formats `Pretty` :

| Paramètre | Description | Par défaut |
| - | - | - |
| [`output_format_pretty_max_rows`](/docs/fr/reference/settings/formats/output-format#output_format_pretty_max_rows) | Limite du nombre de lignes pour les formats Pretty. | `10000` |
| [`output_format_pretty_max_column_pad_width`](/docs/fr/reference/settings/formats/output-format#output_format_pretty_max_column_pad_width) | Largeur maximale de remplissage pour toutes les valeurs d'une colonne dans les formats Pretty. | `250` |
| [`output_format_pretty_max_value_width`](/docs/fr/reference/settings/formats/output-format#output_format_pretty_max_value_width) | Largeur maximale de la valeur affichée dans les formats Pretty. Au-delà, elle sera tronquée. | `10000` |
| [`output_format_pretty_color`](/docs/fr/reference/settings/formats/output-format#output_format_pretty_color) | Utilise des séquences d'échappement ANSI pour afficher les couleurs dans les formats Pretty. | `true` |
| [`output_format_pretty_grid_charset`](/docs/fr/reference/settings/formats/output-format#output_format_pretty_grid_charset) | Jeu de caractères utilisé pour afficher les bordures de la grille. Jeux de caractères disponibles : ASCII, UTF-8. | `UTF-8` |
| [`output_format_pretty_row_numbers`](/docs/fr/reference/settings/formats/output-format#output_format_pretty_row_numbers) | Ajoute les numéros de ligne avant chaque ligne dans le format de sortie Pretty. | `true` |
| [`output_format_pretty_display_footer_column_names`](/docs/fr/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names) | Affiche les noms de colonnes dans le pied de page si la table contient de nombreuses lignes. | `true` |
| [`output_format_pretty_display_footer_column_names_min_rows`](/docs/fr/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names_min_rows) | Définit le nombre minimal de lignes à partir duquel un pied de page est affiché si [`output_format_pretty_display_footer_column_names`](/docs/fr/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names) est activé. | `50` |