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.

Exigences en matière de contrôle d’accès¶

Associer et exécuter une DMF système requiert le privilège USAGE sur la DMF système. Vous pouvez accorder le rôle de base de données SNOWFLAKE.DATA_METRIC_USER pour donner aux utilisateurs le privilège USAGE sur toutes les DMFs système. Pour plus d’informations, voir Accorder le privilège USAGE sur les DMFs système.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

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                                                              |
+----------------------------------------------------------------+