> ## 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.

> Documentación sobre el formato Pretty

# Pretty

| Entrada | Salida | Alias |
| - | - | - |
| ✗ | ✔ | |

## Descripción

El formato `Pretty` muestra los datos como tablas con caracteres Unicode,
utilizando secuencias de escape ANSI para mostrar colores en la terminal.
Se dibuja una cuadrícula completa de la tabla, y cada fila ocupa dos líneas en la terminal.
Cada bloque de resultados se muestra como una tabla independiente.
Esto es necesario para que los bloques puedan mostrarse sin almacenar en búfer los resultados (sería necesario almacenarlos en búfer para calcular de antemano el ancho visible de todos los valores).

[NULL](https://clickhouse.com/docs/es/reference/syntax.md) se muestra como `ᴺᵁᴸᴸ`.

## Ejemplo de uso

Ejemplo (mostrado con el formato [`PrettyCompact`](https://clickhouse.com/docs/es/reference/formats/Pretty/PrettyCompact)):

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

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

Las filas no usan secuencias de escape en ninguno de los formatos `Pretty`. En su lugar, los caracteres de control no imprimibles (controles C0 `0x00`-`0x1F` y `DEL` `0x7F`) que aparecen en los valores y en los nombres de las columnas se muestran de forma predeterminada como los "Control Pictures" de Unicode correspondientes (`U+2400`-`U+2421`), de modo que sigan siendo visibles y no deformen la tabla. Por ejemplo, un NUL se muestra como `␀`:

```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`, el salto de línea y `ESC` son excepciones: siempre se imprimen tal cual, porque el terminal los interpreta en lugar de descartarlos (una tabulación avanza hasta la siguiente posición de tabulación, y una secuencia de escape ANSI es lo que permite que los datos incluyan una visualización). Un salto de línea también sigue partiendo la línea: dentro de una celda de la tabla cuando [`output_format_pretty_multiline_fields`](https://clickhouse.com/docs/es/reference/settings/formats#output_format_pretty_multiline_fields) está habilitado, y tal cual en caso contrario. El nombre de una columna es la excepción a esa excepción: el encabezado y el pie ocupan una sola línea, por lo que un salto de línea en un nombre se reemplaza como cualquier otro carácter de control.

Para imprimir, en cambio, los caracteres de control literalmente, deshabilite [`output_format_pretty_display_control_characters`](https://clickhouse.com/docs/es/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
```

En ese caso, la respuesta contiene el byte `NUL` sin procesar. Un terminal lo omite, por lo que el carácter
resulta invisible y la fila queda una posición más ancha que el borde calculado para ella: precisamente la
tabla deformada que se evita al mostrar el Control Picture.

Para evitar mostrar demasiados datos en el terminal, solo se imprimen las primeras `10,000` filas.
Si el número de filas es mayor o igual que `10,000`, se imprime el mensaje "Showed first 10 000".

> [!NOTE]
>
> Este formato solo es apropiado para mostrar el resultado de una consulta, pero no para parsear datos.

El formato Pretty permite mostrar valores totales (al usar `WITH TOTALS`) y valores extremos (cuando 'extremes' está establecido en 1).
En estos casos, los valores totales y los valores extremos se muestran después de los datos principales, en tablas separadas.
Esto se ilustra en el siguiente ejemplo, que utiliza el formato [`PrettyCompact`](https://clickhouse.com/docs/es/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 │
└────────────┴─────────┘
```

## Ajustes de formato

Los siguientes ajustes son comunes a todos los formatos `Pretty`:

| Configuración | Descripción | Predeterminado |
| - | - | - |
| [`output_format_pretty_max_rows`](https://clickhouse.com/docs/es/reference/settings/formats/output-format#output_format_pretty_max_rows) | Límite de filas para los formatos Pretty. | `10000` |
| [`output_format_pretty_max_column_pad_width`](https://clickhouse.com/docs/es/reference/settings/formats/output-format#output_format_pretty_max_column_pad_width) | Ancho máximo de relleno para todos los valores de una columna en los formatos Pretty. | `250` |
| [`output_format_pretty_max_value_width`](https://clickhouse.com/docs/es/reference/settings/formats/output-format#output_format_pretty_max_value_width) | Ancho máximo del valor que se mostrará en los formatos Pretty. Si lo supera, se recortará. | `10000` |
| [`output_format_pretty_color`](https://clickhouse.com/docs/es/reference/settings/formats/output-format#output_format_pretty_color) | Usa secuencias de escape ANSI para mostrar colores en los formatos Pretty. | `true` |
| [`output_format_pretty_grid_charset`](https://clickhouse.com/docs/es/reference/settings/formats/output-format#output_format_pretty_grid_charset) | Juego de caracteres para imprimir los bordes de la cuadrícula. Juegos de caracteres disponibles: ASCII, UTF-8. | `UTF-8` |
| [`output_format_pretty_row_numbers`](https://clickhouse.com/docs/es/reference/settings/formats/output-format#output_format_pretty_row_numbers) | Agrega números de fila antes de cada fila en el formato de salida Pretty. | `true` |
| [`output_format_pretty_display_footer_column_names`](https://clickhouse.com/docs/es/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names) | Muestra los nombres de las columnas en el pie si la tabla contiene muchas filas. | `true` |
| [`output_format_pretty_display_footer_column_names_min_rows`](https://clickhouse.com/docs/es/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names_min_rows) | Establece el número mínimo de filas a partir del cual se mostrará un pie si [`output_format_pretty_display_footer_column_names`](https://clickhouse.com/docs/es/reference/settings/formats/output-format#output_format_pretty_display_footer_column_names) está habilitado. | `50` |