= value`. |
| `data type` | [Tipo de dato](/es/reference/data-types) del parámetro.
Por ejemplo, una estructura de datos como `(integer, ('string', integer))` puede tener el tipo de dato `Tuple(UInt8, Tuple(String, UInt8))` (también puede usar otros tipos [integer](/es/reference/data-types/int-uint)).
También es posible pasar como parámetros el nombre de la tabla, el nombre de la base de datos y los nombres de columna; en ese caso, deberá usar `Identifier` como tipo de dato. |
### Ejemplos
```bash theme={null}
$ clickhouse-client --param_tuple_in_tuple="(10, ('dt', 10))" \
--query "SELECT * FROM table WHERE val = {tuple_in_tuple:Tuple(UInt8, Tuple(String, UInt8))}"
$ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="number" --param_alias="top_ten" \
--query "SELECT {col:Identifier} as {alias:Identifier} FROM {db:Identifier}.{tbl:Identifier} LIMIT 10"
```
## Generación de SQL con IA
Cliente de ClickHouse incluye asistencia de IA integrada para generar consultas SQL a partir de descripciones en lenguaje natural. Esta función ayuda a los usuarios a escribir consultas complejas sin necesidad de tener conocimientos avanzados de SQL.
La asistencia de IA funciona de forma predeterminada si tienes configurada la variable de entorno `OPENAI_API_KEY` o `ANTHROPIC_API_KEY`. Para una configuración más avanzada, consulta la sección [Configuración](#ai-sql-generation-configuration).
### Uso
Para usar generación de SQL con IA, antepone `??` a tu consulta en lenguaje natural:
```bash theme={null}
:) ?? show all users who made purchases in the last 30 days
```
La IA hará lo siguiente:
1. Explorará automáticamente el esquema de tu base de datos
2. Generará el SQL adecuado en función de las tablas y columnas descubiertas
3. Ejecutará de inmediato la consulta generada
### Ejemplo
```bash theme={null}
:) ?? count orders by product category
Starting AI SQL generation with schema discovery...
──────────────────────────────────────────────────
🔍 list_databases
➜ system, default, sales_db
🔍 list_tables_in_database
database: sales_db
➜ orders, products, categories
🔍 get_schema_for_table
database: sales_db
table: orders
➜ CREATE TABLE orders (order_id UInt64, product_id UInt64, quantity UInt32, ...)
✨ SQL query generated successfully!
──────────────────────────────────────────────────
SELECT
c.name AS category,
COUNT(DISTINCT o.order_id) AS order_count
FROM sales_db.orders o
JOIN sales_db.products p ON o.product_id = p.product_id
JOIN sales_db.categories c ON p.category_id = c.category_id
GROUP BY c.name
ORDER BY order_count DESC
```
### Configuración
La generación de SQL con IA requiere configurar un proveedor de IA en el archivo de configuración de Cliente de ClickHouse. Puede utilizar OpenAI, Anthropic o cualquier servicio de API compatible con OpenAI.
#### fallback basado en variables de entorno
Si no se especifica ninguna configuración de IA en el archivo de configuración, ClickHouse Client intentará usar automáticamente variables de entorno:
1. Primero, comprueba la variable de entorno `OPENAI_API_KEY`
2. Si no la encuentra, comprueba la variable de entorno `ANTHROPIC_API_KEY`
3. Si no encuentra ninguna de las dos, las funciones de IA se desactivarán
Esto permite una configuración rápida sin necesidad de archivos de configuración:
```bash theme={null}
# Usando OpenAI
export OPENAI_API_KEY=your-openai-key
clickhouse-client
# Usando Anthropic
export ANTHROPIC_API_KEY=your-anthropic-key
clickhouse-client
```
#### Archivo de configuración
Para tener un mayor control sobre la configuración de la IA, configúrala en el archivo de configuración de tu ClickHouse Client, ubicado en:
* `$XDG_CONFIG_HOME/clickhouse/config.xml` (o `~/.config/clickhouse/config.xml` si `XDG_CONFIG_HOME` no está definido) (formato XML)
* `$XDG_CONFIG_HOME/clickhouse/config.yaml` (o `~/.config/clickhouse/config.yaml` si `XDG_CONFIG_HOME` no está definido) (formato YAML)
* `~/.clickhouse-client/config.xml` (formato XML, ubicación heredada)
* `~/.clickhouse-client/config.yaml` (formato YAML, ubicación heredada)
* O especifica una ubicación personalizada con `--config-file`
```xml theme={null}
{/* Obligatorio: Tu clave de API (o configúrala mediante una variable de entorno) */}
your-api-key-here
{/* Obligatorio: Tipo de proveedor (openai, anthropic) */}
openai
{/* Modelo que se usará (los valores predeterminados varían según el proveedor) */}
gpt-4o
{/* Opcional: endpoint de API personalizado para servicios compatibles con OpenAI */}
{/* https://openrouter.ai/api */}
{/* Configuración de exploración del esquema */}
true
{/* Parámetros de generación */}
0.0
1000
30
10
{/* Opcional: prompt del sistema personalizado */}
{/* You are an expert ClickHouse SQL assistant... */}
```
```yaml theme={null}
ai:
# Obligatorio: Tu clave de API (o configúrala mediante una variable de entorno)
api_key: your-api-key-here
# Obligatorio: Tipo de proveedor (openai, anthropic)
provider: openai
# Modelo que se usará
model: gpt-4o
# Opcional: endpoint de API personalizado para servicios compatibles con OpenAI
# base_url: https://openrouter.ai/api
# Habilita el acceso al esquema: permite que la IA consulte información de la base de datos y las tablas
enable_schema_access: true
# Parámetros de generación
temperature: 0.0 # Controla la aleatoriedad (0.0 = determinista)
max_tokens: 1000 # Longitud máxima de la respuesta
timeout_seconds: 30 # Tiempo de espera de la solicitud
max_steps: 10 # Número máximo de pasos de exploración del esquema
# Opcional: prompt del sistema personalizado
# system_prompt: |
# Eres un asistente experto en ClickHouse SQL. Convierte lenguaje natural en SQL.
# Prioriza el rendimiento y utiliza optimizaciones específicas de ClickHouse.
# Devuelve siempre SQL ejecutable sin explicaciones.
```
**Uso de API compatibles con OpenAI (p. ej., OpenRouter):**
```yaml theme={null}
ai:
provider: openai # Usar 'openai' para compatibilidad
api_key: your-openrouter-api-key
base_url: https://openrouter.ai/api/v1
model: anthropic/claude-3.5-sonnet # Usar la nomenclatura de modelos de OpenRouter
```
**Ejemplos mínimos de configuración:**
```yaml theme={null}
# Configuración mínima: usa la variable de entorno para la clave de API
ai:
provider: openai # Usará la variable de entorno OPENAI_API_KEY
# Sin configuración: fallback automático
# (Sección ai vacía o ausente: intentará OPENAI_API_KEY y luego ANTHROPIC_API_KEY)
# Solo sobreescribir el modelo: usa la variable de entorno para la clave de API
ai:
provider: openai
model: gpt-3.5-turbo
```
### Parámetros
* `api_key` - Tu clave de API para el servicio de IA. Puede omitirse si se define mediante una variable de entorno:
* OpenAI: `OPENAI_API_KEY`
* Anthropic: `ANTHROPIC_API_KEY`
* Nota: la clave de API del archivo de configuración tiene prioridad sobre la variable de entorno
* `provider` - El proveedor de IA: `openai` o `anthropic`
* Si se omite, se selecciona automáticamente según las variables de entorno disponibles
* `model` - El modelo que se va a usar (predeterminado: específico del proveedor)
* OpenAI: `gpt-4o`, `gpt-4`, `gpt-3.5-turbo`, etc.
* Anthropic: `claude-3-5-sonnet-20241022`, `claude-3-opus-20240229`, etc.
* OpenRouter: usa su nomenclatura de modelos, como `anthropic/claude-3.5-sonnet`
* `base_url` - Endpoint de API personalizado para servicios compatibles con OpenAI (opcional)
* `timeout_seconds` - Tiempo de espera de la solicitud, en segundos (predeterminado: `30`)
* `enable_schema_access` - Permite que la IA explore los esquemas de la base de datos (predeterminado: `true`)
* `max_steps` - Número máximo de pasos de invocación de herramientas para explorar esquemas (predeterminado: `10`)
* `temperature` - Controla la aleatoriedad: 0.0 = determinista, 1.0 = creativo (predeterminado: `0.0`)
* `max_tokens` - Longitud máxima de la respuesta en tokens (predeterminado: `1000`)
* `system_prompt` - Instrucciones personalizadas para la IA (opcional)
### Cómo funciona
El generador de SQL con IA utiliza un proceso de varios pasos:
1. **Descubrimiento del esquema**
La IA utiliza herramientas integradas para explorar su base de datos
* Enumera las bases de datos disponibles
* Detecta tablas dentro de las bases de datos relevantes
* Examina la estructura de las tablas mediante sentencias `CREATE TABLE`
2. **Generación de consultas**
A partir del esquema descubierto, la IA genera SQL que:
* Refleja su intención expresada en lenguaje natural
* Utiliza los nombres correctos de tablas y columnas
* Aplica las operaciones JOIN y las agregaciones adecuadas
3. **Ejecución**
El SQL generado se ejecuta automáticamente y se muestran los resultados
### Limitaciones
* Requiere una conexión a internet activa
* El uso de la API está sujeto a límites de uso y costos del proveedor de IA
* Las consultas complejas pueden requerir varios ajustes
* La IA tiene acceso de solo lectura a la información del esquema, no a los datos reales
### Seguridad
* Las claves de API nunca se envían a los servidores de ClickHouse
* La IA solo ve información del esquema (nombres de tablas/columnas y tipos), no datos reales
* Todas las consultas generadas respetan los permisos actuales de tu base de datos
## Cadena de conexión
### Uso
El ClickHouse Client también admite conectarse a un servidor de ClickHouse mediante una cadena de conexión similar a las de [MongoDB](https://www.mongodb.com/docs/manual/reference/connection-string/), [PostgreSQL](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING) y [MySQL](https://dev.mysql.com/doc/refman/8.0/en/connecting-using-uri-or-key-value-pairs.html#connecting-using-uri). Tiene la siguiente sintaxis:
```text theme={null}
clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters]
```
| Componente (todos opcionales) | Descripción | Predeterminado |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| `user` | Nombre de usuario de la base de datos. | `default` |
| `password` | Contraseña del usuario de la base de datos. Si se especifica `:` y la contraseña está vacía, el cliente solicitará la contraseña del usuario. | - |
| `hosts_and_ports` | Lista de hosts y, opcionalmente, puertos `host[:port] [, host:[port]], ...`. | `localhost:9000` |
| `database` | Nombre de la base de datos. | `default` |
| `query_parameters` | Lista de pares clave-valor `param1=value1[,¶m2=value2], ...`. Para algunos parámetros, no se requiere ningún valor. Los nombres y valores distinguen entre mayúsculas y minúsculas. | - |
### Notas
Si el nombre de usuario, la contraseña o la base de datos se especifican en la cadena de conexión, no pueden especificarse mediante `--user`, `--password` o `--database` (y viceversa).
La parte del host puede ser un nombre de host o una dirección IPv4 o IPv6.
Las direcciones IPv6 deben ir entre `[]`:
```text theme={null}
clickhouse://[2001:db8::1234]
```
Las cadenas de conexión pueden contener varios hosts.
ClickHouse Client intentará conectarse a estos hosts en el orden indicado (de izquierda a derecha).
Una vez establecida la conexión, no se intentará conectar a los hosts restantes.
La cadena de conexión debe especificarse como el primer argumento de `clickHouse-client`.
La cadena de conexión puede combinarse con cualquier número de otras [opciones de línea de comandos](#command-line-options), excepto `--host` y `--port`.
Se permiten las siguientes claves para `query_parameters`:
| Clave | Descripción |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `secure` (o `s`) | Si se especifica, el cliente se conectará al servidor mediante una conexión segura (TLS). Consulte `--secure` en las [opciones de línea de comandos](#command-line-options). |
**Codificación porcentual**
Los caracteres no ASCII de EE. UU., los espacios y los caracteres especiales de los siguientes parámetros deben [codificarse con porcentaje](https://en.wikipedia.org/wiki/URL_encoding):
* `user`
* `password`
* `hosts`
* `database`
* `query parameters`
### Ejemplos
Conéctese a `localhost` por el puerto 9000 y ejecute la consulta `SELECT 1`.
```bash theme={null}
clickhouse-client clickhouse://localhost:9000 --query "SELECT 1"
```
Conéctese a `localhost` como el usuario `john`, con la contraseña `secret`, el host `127.0.0.1` y el puerto `9000`
```bash theme={null}
clickhouse-client clickhouse://john:secret@127.0.0.1:9000
```
Conéctese a `localhost` como el usuario `default`, con la dirección IPV6 `[::1]` y el puerto `9000`.
```bash theme={null}
clickhouse-client clickhouse://[::1]:9000
```
Conéctese a `localhost` por el puerto 9000 en modo multilínea.
```bash theme={null}
clickhouse-client clickhouse://localhost:9000 '-m'
```
Conéctese a `localhost` usando el puerto 9000 con el usuario `default`.
```bash theme={null}
clickhouse-client clickhouse://default@localhost:9000
# equivalente a:
clickhouse-client clickhouse://localhost:9000 --user default
```
Conéctese a `localhost` por el puerto 9000 y utilice `my_database` como base de datos predeterminada.
```bash theme={null}
clickhouse-client clickhouse://localhost:9000/my_database
# equivalente a:
clickhouse-client clickhouse://localhost:9000 --database my_database
```
Conéctese a `localhost` en el puerto 9000, use de forma predeterminada la base de datos `my_database` especificada en la cadena de conexión y establezca una conexión segura mediante el parámetro abreviado `s`.
```bash theme={null}
clickhouse-client clickhouse://localhost/my_database?s
# equivalente a:
clickhouse-client clickhouse://localhost/my_database -s
```
Conéctese al host predeterminado con el puerto, el usuario y la base de datos predeterminados.
```bash theme={null}
clickhouse-client clickhouse:
```
Conéctese al host predeterminado usando el puerto predeterminado, con el usuario `my_user` y sin contraseña.
```bash theme={null}
clickhouse-client clickhouse://my_user@
# Usar una contraseña en blanco entre : y @ significa pedirle al usuario que introduzca la contraseña antes de iniciar la conexión.
clickhouse-client clickhouse://my_user:@
```
Conéctese a `localhost` usando el correo electrónico como nombre de usuario. El símbolo `@` se codifica como `%40`.
```bash theme={null}
clickhouse-client clickhouse://some_user%40some_mail.com@localhost:9000
```
Conéctese a uno de los dos hosts: `192.168.1.15`, `192.168.1.25`.
```bash theme={null}
clickhouse-client clickhouse://192.168.1.15,192.168.1.25
```
## Formato del ID de la consulta
En modo interactivo, ClickHouse Client muestra el ID de la consulta para cada consulta. De forma predeterminada, el ID tiene este formato:
```sql theme={null}
Query id: 927f137d-00f1-4175-8914-0dd066365e96
```
Se puede especificar un formato personalizado en un archivo de configuración dentro de una etiqueta `query_id_formats`. El marcador `{query_id}` de la cadena de formato se sustituye por el ID de la consulta. Se permiten varias cadenas de formato dentro de la etiqueta.
Esta funcionalidad puede utilizarse para generar URL que faciliten el perfilado de consultas.
**Ejemplo**
```xml theme={null}
http://speedscope-host/#profileURL=qp%3Fid%3D{query_id}
```
Con la configuración anterior, el ID de una consulta se muestra con el siguiente formato:
```response theme={null}
speedscope:http://speedscope-host/#profileURL=qp%3Fid%3Dc8ecc783-e753-4b38-97f1-42cddfb98b7d
```
## Archivos de configuración
ClickHouse Client utiliza el primer archivo existente de la siguiente lista:
* Un archivo definido con el parámetro `-c [ -C, --config, --config-file ]`.
* `./clickhouse-client.[xml|yaml|yml]`
* `$XDG_CONFIG_HOME/clickhouse/config.[xml|yaml|yml]` (o `~/.config/clickhouse/config.[xml|yaml|yml]` si `XDG_CONFIG_HOME` no está definido)
* `~/.clickhouse-client/config.[xml|yaml|yml]`
* `/etc/clickhouse-client/config.[xml|yaml|yml]`
Consulta el archivo de configuración de ejemplo en el repositorio de ClickHouse: [`clickhouse-client.xml`](https://github.com/ClickHouse/ClickHouse/blob/master/programs/client/clickhouse-client.xml)
```xml theme={null}
username
password
true
/etc/ssl/cert.pem
```
```yaml theme={null}
user: username
password: 'password'
secure: true
openSSL:
client:
caConfig: '/etc/ssl/cert.pem'
```
## Opciones de variables de entorno
El nombre de usuario, la contraseña y el host se pueden establecer mediante las variables de entorno `CLICKHOUSE_USER`, `CLICKHOUSE_PASSWORD` y `CLICKHOUSE_HOST`.
Los argumentos de línea de comandos `--user`, `--password` o `--host`, o una [cadena de conexión](#connection_string) (si se especifica), tienen prioridad sobre las variables de entorno.
## Opciones de la línea de comandos
Todas las opciones de la línea de comandos pueden especificarse directamente en la línea de comandos o definirse como valores predeterminados en el [archivo de configuración](#configuration_files).
### Opciones generales
| Opción | Descripción | Predeterminado |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| `-c [ -C, --config, --config-file ] ` | La ubicación del archivo de configuración del cliente, si no se encuentra en una de las ubicaciones predeterminadas. Consulte [Archivos de configuración](#configuration_files). | - |
| `--help` | Muestra un resumen de uso y sale. Combínelo con `--verbose` para mostrar todas las opciones posibles, incluida la configuración de la consulta. | - |
| `--history_file ` | Ruta al archivo que contiene el historial de comandos. | - |
| `--history_max_entries` | Número máximo de entradas en el archivo de historial. | `1000000` (1 millón) |
| `--prompt ` | Especifica un prompt personalizado. | El `display_name` del servidor |
| `--verbose` | Aumenta el nivel de detalle de la salida. | - |
| `-V [ --version ]` | Muestra la versión y sale. | - |
### Opciones de conexión
| Opción | Descripción | Predeterminado |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--connection ` | El nombre de los detalles de conexión preconfigurados del archivo de configuración. Consulta [Credenciales de conexión](#connection-credentials). | - |
| `-d [ --database ] ` | Selecciona la base de datos que se usará de forma predeterminada para esta conexión. | La base de datos actual de la configuración del servidor (`default` de forma predeterminada) |
| `-h [ --host ] ` | El nombre de host del servidor de ClickHouse al que conectarse. Puede ser un nombre de host o una dirección IPv4 o IPv6. Se pueden pasar varios hosts mediante varios argumentos. | `localhost` |
| `--jwt ` | Usa JSON Web Token (JWT) para la autenticación.
La autorización JWT del servidor solo está disponible en ClickHouse Cloud. | - |
| `login` | Invoca el flujo OAuth de concesión de dispositivo para autenticarse mediante un IdP.
En los hosts de ClickHouse Cloud, las variables de OAuth se infieren automáticamente; en caso contrario, deben proporcionarse con `--oauth-url`, `--oauth-client-id` y `--oauth-audience`. | - |
| `--no-warnings` | Desactiva la visualización de advertencias de `system.warnings` cuando el cliente se conecta al servidor. | - |
| `--no-server-client-version-message` | Suprime el mensaje de incompatibilidad de versiones entre el servidor y el cliente cuando el cliente se conecta al servidor. | - |
| `--password ` | La contraseña del usuario de la base de datos. También puedes especificar la contraseña de una conexión en el archivo de configuración. Si no especificas la contraseña, el cliente la solicitará. | - |
| `--port ` | El puerto en el que el servidor acepta conexiones. Los puertos predeterminados son 9440 (TLS) y 9000 (sin TLS).
Nota: el cliente usa el protocolo nativo, no HTTP(S). | `9440` si se especifica `--secure`; en caso contrario, `9000`. Siempre usa `9440` de forma predeterminada si el nombre de host termina en `.clickhouse.cloud`. |
| `-s [ --secure ]` | Indica si se debe usar TLS.
Se habilita automáticamente al conectarse al puerto 9440 (el puerto seguro predeterminado) o a ClickHouse Cloud.
Puede que necesites configurar tus certificados de CA en el [archivo de configuración](#configuration_files). Los ajustes de configuración disponibles son los mismos que para la [configuración de TLS del lado del servidor](/es/reference/settings/server-settings/settings#openssl). | Se habilita automáticamente al conectarse al puerto 9440 o a ClickHouse Cloud |
| `--ssh-key-file ` | Archivo que contiene la clave privada SSH para autenticarse con el servidor. | - |
| `--ssh-key-passphrase ` | Frase de contraseña de la clave privada SSH especificada en `--ssh-key-file`. | - |
| `--tls-sni-override ` | Si se usa TLS, el nombre del servidor (SNI) que se enviará en el handshake. | El host proporcionado mediante `-h` o `--host`. |
| `-u [ --user ] ` | El usuario de la base de datos con el que conectarse. | `default` |
En lugar de las opciones `--host`, `--port`, `--user` y `--password`, el cliente también admite [cadenas de conexión](#connection_string).
### Opciones de consulta
| Opción | Descripción |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--param_=` | Valor de sustitución para un parámetro de una [consulta con parámetros](#cli-queries-with-parameters). |
| `-q [ --query ] ` | La consulta que se ejecutará en modo batch. Puede especificarse varias veces (`--query "SELECT 1" --query "SELECT 2"`) o una sola vez con varias consultas separadas por punto y coma (`--query "SELECT 1; SELECT 2;"`). En este último caso, las consultas `INSERT` con formatos distintos de `VALUES` deben separarse con líneas en blanco.
También puede especificarse una sola consulta sin parámetro: `clickhouse-client "SELECT 1"`
No puede usarse junto con `--queries-file`. |
| `--queries-file ` | Ruta de un archivo que contiene consultas. `--queries-file` puede especificarse varias veces; por ejemplo, `--queries-file queries1.sql --queries-file queries2.sql`.
No puede usarse junto con `--query`. |
| `-m [ --multiline ]` | Si se especifica, permite consultas multilínea (no envía la consulta al pulsar Enter). Las consultas solo se enviarán cuando terminen con punto y coma. |
| `--inline-insert-data` | Envía `INSERT ... VALUES` (y otros formatos inline) tal cual en el texto de la consulta, en lugar de convertir los datos en bloques en el formato nativo. El servidor analiza por sí mismo los datos inline, evitando el recorrido de ida y vuelta necesario para enviar al cliente la estructura de la tabla y los valores predeterminados de las columnas. Esto puede mejorar el rendimiento de muchas inserciones pequeñas a través del protocolo nativo. Establece automáticamente [`send_table_structure_on_insert_with_inline_data`](/es/reference/settings/session-settings#send_table_structure_on_insert_with_inline_data) en `0`. No puede combinarse con datos inline ni con datos externos (desde stdin o `INFILE`). |
### Configuración de consultas
La configuración de las consultas puede especificarse como opciones de línea de comandos en el cliente, por ejemplo:
```bash theme={null}
$ clickhouse-client --max_threads 1
```
Consulta [Configuración](/es/reference/settings/session-settings) para ver la lista de ajustes.
### Opciones de formato
| Opción | Descripción | Predeterminado |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| `-f [ --format ] ` | Use el formato especificado para mostrar el resultado.
Consulte [Formatos para datos de entrada y salida](/es/reference/formats) para ver una lista de formatos compatibles. | `TabSeparated` |
| `--pager ` | Canalice toda la salida a este comando. Normalmente `less` (p. ej., `less -S` para mostrar conjuntos de resultados anchos) o similar. | - |
| `-E [ --vertical ]` | Use el [formato Vertical](/es/reference/formats/Vertical) para mostrar el resultado. Equivale a `–-format Vertical`. En este formato, cada valor se imprime en una línea independiente, lo que resulta útil para mostrar tablas anchas. | - |
### Detalles de ejecución
| Opción | Descripción | Predeterminado |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| `--enable-progress-table-toggle` | Permite alternar la tabla de progreso al pulsar la tecla de control (Espacio). Solo se aplica en modo interactivo cuando está habilitada la impresión de la tabla de progreso. | `enabled` |
| `--hardware-utilization` | Imprime información de uso del hardware en la barra de progreso. | - |
| `--memory-usage` | Si se especifica, imprime el uso de memoria en `stderr` en modo no interactivo.
Posibles valores:
• `none` - no imprime el uso de memoria
• `default` - imprime el número de bytes
• `readable` - imprime el uso de memoria en un formato legible para humanos | - |
| `--print-profile-events` | Imprime paquetes `ProfileEvents`. | - |
| `--progress` | Imprime el progreso de ejecución de la consulta.
Posibles valores:
• `tty\|on\|1\|true\|yes` - envía la salida al terminal en modo interactivo
• `err` - envía la salida a `stderr` en modo no interactivo
• `off\|0\|false\|no` - desactiva la impresión del progreso | `tty` en modo interactivo, `off` en modo no interactivo (por lotes) |
| `--progress-table` | Imprime una tabla de progreso con métricas variables durante la ejecución de la consulta.
Posibles valores:
• `tty\|on\|1\|true\|yes` - envía la salida al terminal en modo interactivo
• `err` - envía la salida a `stderr` en modo no interactivo
• `off\|0\|false\|no` - desactiva la tabla de progreso | `tty` en modo interactivo, `off` en modo no interactivo (por lotes) |
| `--stacktrace` | Imprime las trazas de pila de las excepciones. | - |
| `-t [ --time ]` | Imprime el tiempo de ejecución de la consulta en `stderr` en modo no interactivo (para benchmarks). | - |