Catégories :

Fonctions de métrique des données

NULL_COUNT (fonction de métrique des données système)

Renvoie le nombre total de valeurs NULL pour les colonnes spécifiées d’une table.

Cette rubrique fournit la syntaxe pour appeler la fonction directement. Pour savoir comment associer la fonction à une table ou à une vue afin qu’elle s’exécute à intervalles réguliers, voir Association d’une DMF pour automatiser les contrôles de qualité des données.

Syntaxe

SNOWFLAKE.CORE.NULL_COUNT(<query>)
Copy

Arguments

query

Spécifie une requête SQL qui projette une seule colonne.

Types de données autorisés

La colonne projetée par query doit posséder l’un des types de données suivants :

  • DATE

  • FLOAT

  • NUMBER

  • TIMESTAMP_LTZ

  • TIMESTAMP_NTZ

  • TIMESTAMP_TZ

  • VARCHAR

Renvoie

La fonction renvoie une valeur scalaire d’un type de données NUMBER.

Notes sur l’utilisation

Lorsque vous appelez manuellement une DMF système, vous n’avez pas besoin de spécifier le type de données autorisé que vous utilisez. Il vous suffit de spécifier la requête pour la colonne que vous souhaitez mesurer. Snowflake met en correspondance le type de données autorisé pour la fonction avec le type de données de la colonne.

Exemple

Mesurez le nombre de valeurs NULL de la colonne SSN (numéro de Sécurité sociale US) :

SELECT SNOWFLAKE.CORE.NULL_COUNT(
  SELECT
    ssn
  FROM hr.tables.empl_info
);
Copy
+----------------------------------------------------------------+
| SNOWFLAKE.CORE.NULL_COUNT(SELECT ssn FROM hr.tables.empl_info) |
+----------------------------------------------------------------+
| 5                                                              |
+----------------------------------------------------------------+