> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Table système contenant des statistiques échantillonnées sur la sélectivité des filtres et des index recueillies dans les pipelines de lecture `MergeTree` lors de l’exécution des requêtes.

# system.predicate_statistics_log

<Info>
  **Interroger dans ClickHouse Cloud**

  Les données de cette table système sont stockées localement sur chaque nœud de ClickHouse Cloud. Pour obtenir une vue complète de l’ensemble des données, il faut donc utiliser la fonction `clusterAllReplicas`. Consultez [cette page](/fr/reference/system-tables/overview#system-tables-in-clickhouse-cloud) pour plus de détails.
</Info>

<div id="description">
  ## Description
</div>

Contient des statistiques de sélectivité échantillonnées collectées lors de la lecture de tables `MergeTree`. La table n'est renseignée que lorsque [`predicate_statistics_sample_rate`](/fr/reference/settings/session-settings#predicate_statistics_sample_rate) est supérieur à `0`.

Utilisez cette table pour examiner le degré de sélectivité des prédicats utilisateur dans des charges de travail réelles, ainsi que le nombre de granules restant après le filtrage par clé primaire ou index de saut. Ces données sont destinées à alimenter des recommandations d'index et de projections fondées sur les charges de travail.

<div id="row-shapes">
  ## Formes des lignes
</div>

Une même requête peut produire deux types de lignes dans `system.predicate_statistics_log` :

* **Lignes de filtre**, émises à chaque étape prewhere/filter dans `MergeTreeSelectProcessor`. Elles alimentent `predicate_expression`, `input_rows`, `passed_rows`, `filter_selectivity`, ainsi que les colonnes du prédicat complet `total_input_rows`, `total_passed_rows`, `total_selectivity`. Les colonnes liées aux index sont vides.
* **Lignes d’index**, émises à chaque étape de lecture dans `ReadFromMergeTree`. Elles alimentent les tableaux `index_names`, `index_types`, `total_granules`, `granules_after` et `index_selectivities`, avec une entrée par étape d’index (clé primaire, partition, skip indexes). Les colonnes liées aux prédicats sont vides.

Les lignes de filtre et les lignes d’index d’une même requête partagent le même `query_id` et la même `table`, et peuvent donc être jointes lorsque les deux sont nécessaires.

<div id="sampling-and-overhead">
  ## Échantillonnage et surcoût
</div>

L'échantillonnage est contrôlé par [`predicate_statistics_sample_rate`](/fr/reference/settings/session-settings#predicate_statistics_sample_rate) :

* `0` désactive la collecte.
* `1` échantillonne chaque requête.
* `N > 1` échantillonne environ `1 / N` des requêtes, selon un hachage de `query_id`.

Des valeurs plus faibles produisent davantage de données, mais augmentent la charge CPU sur le chemin de lecture ainsi que le nombre d'écritures dans le journal système. Après avoir activé ce paramètre, utilisez [`SYSTEM FLUSH LOGS`](/fr/reference/statements/system#flush-logs) si vous avez besoin que les lignes apparaissent immédiatement.

<div id="columns">
  ## Colonnes
</div>

* `hostname` ([LowCardinality(String)](/fr/reference/data-types/lowcardinality)) — Nom d’hôte du serveur qui exécute la requête.
* `event_date` ([Date](/fr/reference/data-types/date)) — Date de l’événement.
* `event_time` ([DateTime](/fr/reference/data-types/datetime)) — Horodatage de l’écriture de cette entrée de journal.
* `database` ([LowCardinality(String)](/fr/reference/data-types/lowcardinality)) — Nom de la base de données de la table cible.
* `table` ([LowCardinality(String)](/fr/reference/data-types/lowcardinality)) — Nom de la table cible.
* `query_id` ([String](/fr/reference/data-types/string)) — ID de requête permettant de faire le lien avec query\_log.
* `predicate_expression` ([String](/fr/reference/data-types/string)) — Expression de filtre complète prise en charge par cette étape prewhere/filter (dump ActionsDAG).
* `input_rows` ([UInt64](/fr/reference/data-types/int-uint)) — Lignes entrant dans cette étape prewhere/filter.
* `passed_rows` ([UInt64](/fr/reference/data-types/int-uint)) — Lignes conservées après cette étape prewhere/filter.
* `filter_selectivity` ([Float64](/fr/reference/data-types/float)) — Sélectivité de cette étape : passed\_rows / input\_rows.
* `total_input_rows` ([UInt64](/fr/reference/data-types/int-uint)) — Lignes entrant dans la première étape prewhere (nombre total de lignes lues à partir des granules).
* `total_passed_rows` ([UInt64](/fr/reference/data-types/int-uint)) — Lignes conservées après toutes les étapes prewhere (lignes transmises à la requête).
* `total_selectivity` ([Float64](/fr/reference/data-types/float)) — Sélectivité de l’ensemble du prédicat : total\_passed\_rows / total\_input\_rows.
* `index_names` ([Array(LowCardinality(String))](/fr/reference/data-types/array)) — Noms des index appliqués, par ex. \['PrimaryKey', 'idx\_bf\_status'] (lignes d’index uniquement).
* `index_types` ([Array(LowCardinality(String))](/fr/reference/data-types/array)) — Types d’index appliqués : PrimaryKey, Skip, MinMax, Partition (lignes d’index uniquement).
* `total_granules` ([Array(UInt64)](/fr/reference/data-types/array)) — Granules à l’entrée de chaque étape d’index (lignes d’index uniquement).
* `granules_after` ([Array(UInt64)](/fr/reference/data-types/array)) — Granules restants après chaque étape d’index (lignes d’index uniquement).
* `index_selectivities` ([Array(Float64)](/fr/reference/data-types/array)) — Sélectivité par index : granules\_after / total\_granules (lignes d’index uniquement).

<div id="example">
  ## Exemple
</div>

```sql theme={null}
SET predicate_statistics_sample_rate = 1;

SELECT *
FROM hits
WHERE URL LIKE '%/product/%' AND EventDate >= today() - 7
FORMAT Null;

SYSTEM FLUSH LOGS predicate_statistics_log;

SELECT
    query_id,
    predicate_expression,
    round(filter_selectivity, 3) AS step_selectivity,
    round(total_selectivity, 3) AS query_selectivity,
    index_names,
    index_selectivities
FROM system.predicate_statistics_log
WHERE table = 'hits'
ORDER BY event_time DESC
LIMIT 10;
```

<div id="see-also">
  ## Voir aussi
</div>

* [`predicate_statistics_sample_rate`](/fr/reference/settings/session-settings#predicate_statistics_sample_rate)
* [system.query\_log](/fr/reference/system-tables/query_log)