# Troubleshooting: Corrigiendo errores de ejecución de queries en el Data Warehouse

Ejecutar consultas excesivamente pesadas puede provocar el bloqueo del contenedor de procesamiento. Como medida reactiva, el sistema realiza hasta tres intentos automáticos de ejecución. Si la falla persiste, el proceso se cierra para proteger la integridad del entorno.

Este artículo te orientará en la investigación de estos errores y en la aplicación de técnicas de optimización para estabilizar tus DataJobs.

### Señales del error

El error se identifica de dos formas:

* **En el Skyone Studio:** El mensaje de error *“Multiple attempts were made to process the query. Optimize the query and run it again”* aparecerá directamente en la interfaz, en la pestaña de Salida (Output), del Data Warehouse.
* **En el Flujo:** El usuario recibirá un correo electrónico automático informando sobre la falla en la ejecución.

#### ¿Qué significa esto

Este mensaje indica que el sistema realizó tres intentos consecutivos para ejecutar la query, pero todos fallaron. Generalmente, esto ocurre porque la consulta es excesivamente pesada (ej: procesamiento de cientos de miles de filas), lo que provoca el bloqueo y el reinicio automático del contenedor de ejecución.

### Investigación y diagnóstico

Para resolver el problema, es necesario identificar si la query que falló es la causa raíz o una víctima colateral. Verifica los siguientes puntos:

#### 1. Revisión de Lógica

El primer paso para la corrección es revisar la lógica de la query y verificar si el volumen de datos excede la capacidad del entorno.

#### 2. Problema de ejecución en paralelo

Muchas queries pueden ejecutarse simultáneamente en el mismo entorno. Una sola query "culpable" puede consumir todos los recursos (Memoria/CPU), derribando el contenedor y generando errores para todas las demás consultas que se estaban ejecutando en ese momento.

* **Acción:** Analiza qué se estaba ejecutando simultáneamente para aislar la query que causó la falla.

### Mejores prácticas para prevención y corrección

Sigue estas recomendaciones de optimización para evitar bloqueos:

#### Optimización de consultas (SQL)

* **Uso de `LIMIT`:** Al realizar pruebas o selecciones en grandes volúmenes, utiliza la cláusula `LIMIT` para restringir la carga inicial de datos.
* **Refactorización de columnas:** Evita el uso de `SELECT *`. Especifica solo las columnas necesarias para reducir la carga de procesamiento.

#### Configuraciones de memoria y DuckDB

* **Gestión de Memoria:** Verifica que la query esté dimensionada correctamente para los límites de memoria del contenedor.
* **Ajustes de parámetros:** Considera añadir configuraciones específicas de DuckDB para mejorar la estabilidad y el rendimiento en operaciones complejas.

{% hint style="info" %}
Lectura recomendada: [Documentácion DuckDB](https://duckdb.org/docs/stable/configuration/pragmas#resource-management) 
{% endhint %}

### Ejemplo práctico de ajuste

#### Escenario de error

A continuación, un ejemplo de una query que puede causar el agotamiento de recursos al intentar cargar datos masivos sin filtros:

```sql
-- Query no optimizada: alto riesgo de bloqueo
SELECT * FROM banco_prueba.tabla_gigante;
```

#### Ajuste recomendado

Al aplicar filtros y limitar el alcance, el riesgo de caída del contenedor se minimiza:

```sql
-- Query optimizada: enfocada en rendimiento y estabilidad
SELECT id, nombre, fecha_procesamiento 
FROM banco_prueba.tabla_gigante 
WHERE fecha_procesamiento >= '2026-01-01'
LIMIT 1000;
```

{% hint style="info" %}
Si el error persiste incluso después de la optimización, realiza una investigación de Troubleshooting por separado para verificar el log de actividades paralelas y la salud del entorno.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skyone.cloud/espanol/skyone-studio/how-to/troubleshooting-corrigiendo-errores-de-ejecucion-de-queries-en-el-data-warehouse.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.