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

# JSONCompactEachRowWithProgress

> Documentación sobre el formato JSONCompactEachRowWithProgress

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

## Descripción

Combina la salida compacta fila por fila de [`JSONCompactEachRow`](https://clickhouse.com/docs/es/reference/formats/JSON/JSONCompactEachRow) con información de progreso en streaming. ClickHouse emite cada evento como un objeto JSON independiente; los valores de las columnas conservan sus tipos JSON nativos.

El formato relacionado `JSONCompactStringsEachRowWithProgress` utiliza los mismos tipos de objeto de nivel superior, pero los valores de los campos se serializan como cadenas.

Comparte el mismo contrato de stream que [`JSONEachRowWithProgress`](https://clickhouse.com/docs/es/reference/formats/JSON/JSONEachRowWithProgress) (`writesProgressConcurrently` / `finalizeImpl`), con la diferencia de que las cargas útiles `row` / `totals` / `min` / `max` son **arrays** de valores en el orden de las columnas, en lugar de objetos con nombre.

## Objetos del stream

Cada línea de la respuesta es un objeto JSON. Los clientes deben determinar cómo procesar cada objeto según su clave de nivel superior:

| Clave de nivel superior | Cuándo aparece | Estructura |
| - | - | - |
| `meta` | Una vez, antes del primer `row` (puede emitirse un objeto `progress` antes) | `{"meta":[{"name":...,"type":...}, ...]}` — nombres y tipos de las columnas |
| `row` | Una vez por cada fila del resultado | `{"row":[...]}` — valores de las columnas en el orden del encabezado |
| `progress` | Periódicamente mientras se ejecuta la consulta | `{"progress":{...}}` — contadores como `read_rows`, `read_bytes`, `total_rows_to_read` |
| `totals` | Cuando hay totales | `{"totals":[...]}` — valores de la fila de totales en el orden del encabezado |
| `min` / `max` | Cuando hay valores extremos | `{"min":[...]}` / `{"max":[...]}` — valores de la fila de extremos en el orden del encabezado |
| `rows_before_limit_at_least` | Cuando la consulta contiene `LIMIT` | `{"rows_before_limit_at_least":N}` — cota inferior estimada de las filas que habría sin `LIMIT` (no demuestra que se hayan descartado filas) |
| `rows_before_aggregation` | Cuando la consulta realiza una agregación y el contador `rows_before_aggregation` está habilitado | `{"rows_before_aggregation":N}` |
| `exception` | Cuando la consulta falla, en la ruta HTTP con `http_write_exception_in_output_format=1` | `{"exception":"..."}` — texto del error como **cadena de nivel superior**, no anidado dentro de `row` |

El objeto `rows_before_limit_at_least` se emite cuando la consulta contiene `LIMIT`, aunque el límite no haya descartado ninguna fila. Es una cota inferior estimada del número de filas que habría sin `LIMIT` (con el mismo significado que en `JSON`); los clientes no deben interpretarlo como prueba de que se descartaron filas.

`meta` se emite una vez antes del primer `row`, pero un objeto `progress` puede llegar antes que `meta`. El objeto `exception` de nivel superior solo se emite en la ruta HTTP cuando `http_write_exception_in_output_format=1`; de lo contrario, el error se notifica a través de la capa de transporte. Cuando se emite, es un objeto de nivel superior independiente, no anidado dentro de `row`.

## Ejemplo de uso

```sql title="Query" theme={null}
SELECT *
FROM generateRandom('a Array(Int8), d Decimal32(4), c Tuple(DateTime64(3), UUID)', 1, 10, 2)
LIMIT 5
FORMAT JSONCompactEachRowWithProgress
```

```response title="Response" theme={null}
{"meta":[{"name":"a","type":"Array(Int8)"},{"name":"d","type":"Decimal(9, 4)"},{"name":"c","type":"Tuple(DateTime64(3), UUID)"}]}
{"row":[[-8], 46848.5225, ["2064-06-11 14:00:36.578","b06f4fa1-22ff-f84f-a1b7-a5807d983ae6"]]}
{"row":[[-76], -85331.598, ["2038-06-16 04:10:27.271","2bb0de60-3a2c-ffc0-d7a7-a5c88ed8177c"]]}
{"row":[[-32], -31470.8994, ["2027-07-18 16:58:34.654","1cdbae4c-ceb2-1337-b954-b175f5efbef8"]]}
{"row":[[-116], 32104.097, ["1979-04-27 21:51:53.321","66903704-3c83-8f8a-648a-da4ac1ffa9fc"]]}
{"row":[[], 2427.6614, ["1980-04-24 11:30:35.487","fee19be8-0f46-149b-ed98-43e7455ce2b2"]]}
{"progress":{"read_rows":"5","read_bytes":"184","total_rows_to_read":"5","elapsed_ns":"335771"}}
{"rows_before_limit_at_least":5}
```

## Ajustes de formato
