Catégories :

Fonctions système (Informations système)

SYSTEM$CLUSTERING_RATIO — Obsolète

Renvoie le rapport de clustering pour une table sur la base d’une ou plusieurs colonnes de la table. Le rapport est un nombre compris entre 0 et 100. Plus le ratio est élevé, plus le clustering de la table est bon.

Le taux de clustering d’une table peut être calculé à l’aide de toutes les colonnes de la table ou de colonnes explicitement définies comme clé de clustering pour la table. une clé de clustering peut être définie pour une table à l’aide de CREATE TABLE ou ALTER TABLE.

Pour plus d’informations sur le taux de clustering et les clés de clustering, voir Fonctionnement des structures de table dans Snowflake.

Syntaxe

SYSTEM$CLUSTERING_RATIO( '<table_name>' , '( <col1> [ , <col2> ... ] )' [ , '<predicate>' ] )

Arguments

nom_table

Table pour laquelle vous souhaitez calculer le taux de clustering.

col1 [ , col2 ... ]

Colonne(s) de la table utilisée(s) pour calculer le taux de clustering :

  • Pour une table sans clé de clustering, cet argument est requis. Si cet argument est omis, une erreur est renvoyée.

  • Pour une table avec une clé de clustering, cet argument est facultatif. Si l’argument est omis, Snowflake utilise la clé de clustering définie pour calculer le taux.

Note

Vous pouvez utiliser cet argument pour calculer le taux de toutes les colonnes de la table, quelle que soit la clé de clustering définie pour la table.

prédicat

Clause qui filtre la plage de valeurs dans les colonnes pour lesquelles le taux de clustering doit être calculé. Notez que prédicat n’utilise pas de mot clé WHERE au début de la clause.

Notes sur l’utilisation

  • Tous les arguments sont des chaînes de caractères ; ils doivent donc être compris entre des guillemets simples.

  • Si prédicat contient une chaîne, celle-ci doit être placée entre guillemets simples, qui doivent ensuite être échappés à l’aide de guillemets simples. Par exemple :

    SYSTEM$CLUSTERING_RATIO( ... , 'col1 = 100 and col2 = ''A''' )

Exemples

Calculez le taux de clustering d’une table à l’aide de deux colonnes :

SELECT SYSTEM$CLUSTERING_RATIO('t2', '(col1, col3)');

+-------------------------------+
| SYSTEM$CLUSTERING_RATIO('T2') |
|-------------------------------|
|                          77.1 |
+-------------------------------+

Calculez le taux de clustering d’une table à l’aide de deux colonnes et d’un prédicat sur l’une des colonnes :

SELECT SYSTEM$CLUSTERING_RATIO('t2', '(col1, col2)', 'col1 = ''A''');

+-------------------------------+
| SYSTEM$CLUSTERING_RATIO('T2') |
|-------------------------------|
|                          87.7 |
+-------------------------------+

Calculez le taux de clustering d’une table à l’aide de la clé de clustering définie pour la table :

SELECT SYSTEM$CLUSTERING_RATIO('t1');

+-------------------------------+
| SYSTEM$CLUSTERING_RATIO('T1') |
|-------------------------------|
|                         100.0 |
+-------------------------------+