paramètres de session force_*

Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du code source.

Force l’utilisation de l’optimisation lorsqu’elle est applicable, même si les heuristiques ont décidé de ne pas l’utiliser

Ce paramètre est utilisé par le serveur lui-même pour prendre en charge les requêtes distribuées. Ne le modifiez pas manuellement, car cela perturberait le fonctionnement normal. (Force l'utilisation de l'agrégation dans l'ordre sur les nœuds distants lors de l'agrégation distribuée).

Force la prédéduplication pour chaque partition lors de la création d'ensembles pour IN (subquery) lorsqu'elle est applicable, mais que la vérification du déséquilibre des partitions (la plus grande partition représente plus du double de la moyenne) a décidé de ne pas l'utiliser. Contourne uniquement la vérification du déséquilibre de allow_creating_set_partitions_independently ; les autres conditions s'appliquent toujours.

Désactive l’exécution de la requête si les indices de saut de données spécifiés n’ont pas été utilisés.

Prenons l’exemple suivant :

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 l'évaluation indépendante de DISTINCT pour chaque partition lorsqu'elle est applicable, mais que l'heuristique de coût a décidé de ne pas l'utiliser. Ne contourne que l'heuristique de coût de allow_distinct_partitions_independently ; les autres conditions restent applicables.

La fonction GROUPING renvoie 1 lorsque l’argument n’est pas utilisé comme clé d’agrégation

Désactive l’exécution de la requête si l’index ne peut pas être utilisé avec une date.

Fonctionne avec les tables de la famille MergeTree.

Si force_index_by_date=1, ClickHouse vérifie si la requête comporte une condition sur la clé de date pouvant être utilisée pour restreindre les plages de données. S’il n’existe aucune condition appropriée, une exception est levée. Cependant, il ne vérifie pas si cette condition réduit la quantité de données à lire. Par exemple, la condition Date != ' 2000-01-01 ' est acceptable même lorsqu’elle correspond à toutes les données de la table (c’est-à-dire que l’exécution de la requête nécessite un parcours complet). Pour plus d’informations sur les plages de données dans les tables MergeTree, consultez MergeTree.

Désactive l’exécution de la requête si l’utilisation de l’index de clé primaire n’est pas possible.

Fonctionne avec les tables de la famille MergeTree.

Si force_primary_key=1, ClickHouse vérifie si la requête comporte une condition sur la clé primaire qui peut être utilisée pour restreindre les plages de données. S’il n’existe pas de condition appropriée, une exception est levée. Cependant, ClickHouse ne vérifie pas si cette condition réduit la quantité de données à lire. Pour plus d’informations sur les plages de données dans les tables MergeTree, voir MergeTree.

N'a d'effet que dans ClickHouse Cloud. Surcharge le paramètre serveur enable_read_through_distributed_cache pour une seule requête. auto (valeur par défaut) indique d'utiliser le paramètre serveur.

Supprime récursivement les données lors d’une requête DROP. Évite l’erreur 'Directory not empty', mais peut supprimer silencieusement des données detached

Force l’évaluation indépendante des fonctions de fenêtre pour chaque partition lorsqu’elle est applicable, mais que l’heuristique de coût a décidé de ne pas l’utiliser. Contourne uniquement l’heuristique de coût de allow_window_partitions_independently ; les autres conditions restent applicables.

N’a d’effet que dans ClickHouse Cloud. Surcharge, pour une seule requête, le paramètre serveur enable_write_through_distributed_cache. auto (valeur par défaut) signifie que le paramètre serveur est utilisé.