Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configuración de sesión force_*

Estas opciones de configuración están disponibles en system.settings y se generan automáticamente a partir del código fuente.

force_aggregate_partitions_independently

Tipo
Bool
Predeterminado
0

Fuerza el uso de la optimización cuando es aplicable, aunque las heurísticas hayan decidido no usarla

force_aggregation_in_order

Tipo
Bool
Predeterminado
0

Esta configuración la utiliza el propio servidor para admitir consultas distribuidas. No la cambie manualmente, ya que interrumpirá el funcionamiento normal. (Fuerza el uso de la agregación en orden en nodos remotos durante la agregación distribuida).

force_creating_set_partitions_independently

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.80Nueva opción para forzar la predesduplicación por partición al crear conjuntos para `IN (subquery)`, incluso cuando la comprobación de desequilibrio entre particiones la omitiría.

Fuerza la predesduplicación por partición al crear conjuntos para IN (subquery) cuando sea aplicable, pero la comprobación de desequilibrio entre particiones (la partición más grande supera el doble de la media) haya decidido no usarla. Solo omite la comprobación de desequilibrio de allow_creating_set_partitions_independently; las demás condiciones se siguen aplicando.

force_data_skipping_indices

Deshabilita la ejecución de la consulta si no se utilizaron los índices de omisión de datos especificados.

Considere el siguiente ejemplo:

CREATE TABLE data
(
    key Int,
    d1 Int,
    d1_null Nullable(Int),
    INDEX d1_idx d1 TYPE minmax GRANULARITY 1,
    INDEX d1_null_idx assumeNotNull(d1_null) TYPE minmax GRANULARITY 1
)
Engine=MergeTree()
ORDER BY key;

SELECT * FROM data_01515;
SELECT * FROM data_01515 SETTINGS force_data_skipping_indices=''; -- query will produce CANNOT_PARSE_TEXT error.
SELECT * FROM data_01515 SETTINGS force_data_skipping_indices='d1_idx'; -- query will produce INDEX_NOT_USED error.
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='d1_idx'; -- Ok.
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='`d1_idx`'; -- Ok (example of full featured parser).
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='`d1_idx`, d1_null_idx'; -- query will produce INDEX_NOT_USED error, since d1_null_idx is not used.
SELECT * FROM data_01515 WHERE d1 = 0 AND assumeNotNull(d1_null) = 0 SETTINGS force_data_skipping_indices='`d1_idx`, d1_null_idx'; -- Ok.

force_distinct_partitions_independently

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.80Nueva configuración para forzar la evaluación independiente de `DISTINCT` por partición, incluso cuando la heurística de coste la omitiría.

Fuerza la evaluación independiente de DISTINCT por partición cuando sea aplicable, pero la heurística de coste haya decidido no usarla. Solo omite la heurística de coste de allow_distinct_partitions_independently; se siguen aplicando las demás condiciones.

force_grouping_standard_compatibility

Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
22.91Hace que la función GROUPING devuelva el mismo resultado que en el estándar SQL y otros DBMS

Hace que la función GROUPING devuelva 1 cuando el argumento no se utiliza como clave de agregación

force_index_by_date

Tipo
Bool
Predeterminado
0

Desactiva la ejecución de la consulta si el índice no puede usarse con la fecha.

Funciona con tablas de la familia MergeTree.

Si force_index_by_date=1, ClickHouse comprueba si la consulta tiene una condición sobre la clave de fecha que pueda usarse para restringir los rangos de datos. Si no hay una condición adecuada, lanza una excepción. Sin embargo, no comprueba si la condición reduce la cantidad de datos que hay que leer. Por ejemplo, la condición Date != ' 2000-01-01 ' es aceptable incluso cuando coincide con todos los datos de la tabla (es decir, ejecutar la consulta requiere un escaneo completo). Para obtener más información sobre los rangos de datos en las tablas MergeTree, consulte MergeTree.

force_primary_key

Tipo
Bool
Predeterminado
0

Desactiva la ejecución de la consulta si no es posible usar el índice de la clave primaria.

Funciona con tablas de la familia MergeTree.

Si force_primary_key=1, ClickHouse comprueba si la consulta tiene una condición sobre la clave primaria que pueda usarse para restringir los rangos de datos. Si no hay ninguna condición adecuada, lanza una excepción. Sin embargo, no comprueba si la condición reduce la cantidad de datos que se deben leer. Para obtener más información sobre los rangos de datos en las tablas MergeTree, consulte MergeTree.

force_read_through_distributed_cache

Solo para ClickHouse Cloud
Tipo
BoolAuto
Predeterminado
auto
Historial de versiones
VersiónValor predeterminadoComentario
26.9autoNueva configuración que anula la configuración del servidor `enable_read_through_distributed_cache` para una sola consulta.
26.8autoNueva configuración que anula la configuración del servidor `enable_read_through_distributed_cache` para una sola consulta.

Solo tiene efecto en ClickHouse Cloud. Anula la configuración del servidor enable_read_through_distributed_cache para una sola consulta. auto (el valor predeterminado) indica que se debe seguir la configuración del servidor.

force_remove_data_recursively_on_drop

Tipo
Bool
Predeterminado
0

Elimina los datos de forma recursiva al ejecutar la consulta DROP. Evita el error 'Directory not empty', pero puede eliminar silenciosamente datos detached

force_window_partitions_independently

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.80Nueva configuración para forzar la evaluación independiente de las funciones de ventana por partición, incluso cuando la heurística de coste la omitiría.

Fuerza la evaluación independiente de las funciones de ventana por partición cuando sea aplicable, aunque la heurística de coste haya decidido no utilizarla. Solo omite la heurística de coste de allow_window_partitions_independently; las demás condiciones siguen aplicándose.

force_write_through_distributed_cache

Solo para ClickHouse Cloud
Tipo
BoolAuto
Predeterminado
auto
Historial de versiones
VersiónValor predeterminadoComentario
26.9autoNueva configuración que anula la configuración del servidor `enable_write_through_distributed_cache` para una sola consulta.
26.8autoNueva configuración que anula la configuración del servidor `enable_write_through_distributed_cache` para una sola consulta.

Solo tiene efecto en ClickHouse Cloud. Anula la configuración del servidor enable_write_through_distributed_cache para una sola consulta. auto (el valor predeterminado) indica que se debe seguir la configuración del servidor.

Navigation