Skip to main content
Estos ajustes están disponibles en system.settings y se generan automáticamente a partir del código fuente.

distributed_plan_default_reader_bucket_count

Número predeterminado de tareas para la lectura paralela en una consulta distribuida. Las tareas se reparten entre las réplicas. Lo utiliza el planificador distribuido basado en reglas. El optimizador basado en costos elige el grado de paralelismo de lectura según el costo estimado y no utiliza esta configuración.

distributed_plan_default_shuffle_join_bucket_count

Número predeterminado de buckets para distributed shuffle-hash-join. Lo utiliza el planificador distribuido basado en reglas. El optimizador basado en costos elige el grado de paralelismo según el costo estimado y no utiliza esta configuración.

distributed_plan_execute_locally

Ejecuta localmente todas las tareas de un plan de consulta distribuida. Útil para pruebas y depuración.

distributed_plan_fallback_to_local_execution

Cuando un plan de consulta contiene un paso que no admite la ejecución distribuida, se registra el motivo y la consulta se ejecuta en el iniciador en lugar de lanzarse una excepción. Desactívela si prefiere que se lance una excepción. Solo surte efecto cuando make_distributed_plan (private preview) está habilitado.

distributed_plan_force_exchange_kind

Fuerza el tipo especificado de operadores Exchange entre las etapas de una consulta distribuida. Valores posibles:
  • ” - no forzar ningún tipo de operadores Exchange; dejar que el optimizador elija,
  • ‘Persisted’ - usar archivos temporales en almacenamiento de objetos,
  • ‘Streaming’ - transmitir los datos de Exchange a través de la red.

distributed_plan_force_shuffle_aggregation

Usa la estrategia de agregación Shuffle en lugar de PartialAggregation + Merge en el plan de consulta distribuida. Se ignora cuando la estrategia Shuffle no puede producir un resultado correcto, por ejemplo para GROUPING SETS o cuando la agregación debe producir los resultados en orden de bucket.

distributed_plan_max_rows_to_broadcast

Número máximo de filas para usar un broadcast join en lugar de un shuffle join en el plan de consulta distribuida. Una heurística para el planificador distribuido basado en reglas. Cuando el optimizador basado en costos está habilitado, la elección entre broadcast y shuffle se realiza según el costo estimado y esta configuración no tiene efecto.

distributed_plan_optimize_exchanges

Elimina intercambios innecesarios del plan de consulta distribuida. Desactívelo para depuración.

distributed_plan_prefer_replicas_over_workers

Serializa el plan de consulta distribuida para su ejecución en las réplicas.

distributed_plan_read_in_order

Habilita la optimización de lectura en orden para ORDER BY en un plan de consulta distribuido, de modo que una lectura ordenada según la clave de ordenación de la tabla pueda omitir la ordenación y detenerse antes, en lugar de escanear y ordenar. Desactivada de forma predeterminada: la reescritura que distribuye una ordenación asume que la ordenación que envuelve no depende de que su entrada ya esté ordenada, y una ordenación que sí depende de ello puede recibir filas a través de un intercambio que no preserva el orden. Por ahora, solo son seguras las formas en las que no queda ningún intercambio entre la lectura y la ordenación.

distributed_plan_workers_num

Cuántos workers sin estado se usarán para ejecutar esta consulta. Cero desactiva la reserva de workers sin estado para los planes distribuidos.

distributed_plan_workers_provisioning_timeout_ms

Tiempo total de reloj, en milisegundos, que una consulta puede dedicar al aprovisionamiento de workers sin estado antes de ejecutarse: reservarlos desde el servicio de descubrimiento y comprobar que sean accesibles. La consulta se bloquea hasta este límite de tiempo para que los workers reservados estén listos; cuando se agota, la consulta continúa con los workers verificados hasta ese momento o falla si ninguno está disponible. El valor cero espera únicamente la pasada inicial de reserva y verificación (sin reintentos).
Última modificación el 26 de septiembre de 2026