Catégories :

Fonctions système, Fonctions de table

SYSTEM$DATA_METRIC_SCAN

Renvoie les lignes identifiées par une métrique de qualité des données comme contenant des données qui ont échoué à un contrôle de qualité des données. Par exemple, si vous utilisez la fonction de métrique de données NULL_COUNT comme argument, la fonction renvoie les lignes de la table qui contiennent une valeur NULL dans une colonne spécifique.

Syntaxe

SYSTEM$DATA_METRIC_SCAN(
  REF_ENTITY_NAME  => '<object>'
  , METRIC_NAME  => '<data_metric_function>'
  , ARGUMENT_NAME => '<column>'
   [ , AT_TIMESTAMP => '<timestamp>' ] )
Copy

Arguments

Obligatoire :

REF_ENTITY_NAME => 'object'

Nom de la table ou de la vue sur laquelle la fonction de métrique de données spécifiée s’exécutera. La fonction renvoie les lignes de cet objet.

METRIC_NAME => 'data_metric_function'

Nom de la métrique de données système que vous souhaitez exécuter pour évaluer la table ou la vue spécifiée. Seules les fonctions système suivantes sont prises en charge :

  • SNOWFLAKE.CORE.NULL_COUNT

  • SNOWFLAKE.CORE.NULL_PERCENT

  • SNOWFLAKE.CORE.BLANK_COUNT

  • SNOWFLAKE.CORE.BLANK_PERCENT

  • SNOWFLAKE.CORE.DUPLICATE_COUNT

ARGUMENT_NAME => 'column'

Nom de la colonne dans la table ou la vue spécifiée qui est transmise en tant qu’argument à la fonction de métrique de données spécifiée.

Facultatif :

AT_TIMESTAMP => 'timestamp'

Horodatage transmis en tant qu’argument pour vérifier les résultats d’une évaluation DMF sur la table ou la vue dans le passé.

Renvoie

Lignes de la table ou de la vue spécifiée.

Privilèges de contrôle d’accès

L’exécution de cette fonction nécessite les privilèges suivants :

  • SELECT sur la table spécifiée.

  • USAGE sur la fonction de métrique de données spécifiée.

Notes sur l’utilisation

  • Cette fonction ne prend pas en charge les métriques définies par l’utilisateur.

  • Si la table spécifiée est protégée par une politique, telle qu’une politique de masquage ou une politique d’accès aux lignes, la fonction peut renvoyer des données inattendues ou incomplètes car les résultats dépendent du rôle de l’utilisateur lors de l’exécution de la fonction.

Exemples

Comme la métrique système SNOWFLAKE.CORE.NULL_COUNT renvoie le nombre total de valeurs NULL dans une colonne particulière, ce qui suit renvoie les lignes de la table employeesTable qui ont des valeurs NULL dans la colonne SSN.

SELECT *
  FROM TABLE(SYSTEM$DATA_METRIC_SCAN(
    REF_ENTITY_NAME  => 'governance.sch.employeesTable',
    METRIC_NAME  => 'snowflake.core.null_count',
    ARGUMENT_NAME => 'SSN'
  ));
Copy

Comme la métrique système SNOWFLAKE.CORE.BLANK_COUNT renvoie le nombre de valeurs vides dans une colonne, ce qui suit renvoie les lignes de la table employeesTable qui avait une valeur vide dans la colonne name dans la version de la table qui existait à un moment précis dans le passé.

SELECT *
  FROM TABLE(SYSTEM$DATA_METRIC_SCAN(
    REF_ENTITY_NAME  => 'governance.sch.employeesTable',
    METRIC_NAME  => 'snowflake.core.blank_count',
    ARGUMENT_NAME => 'name',
    AT_TIMESTAMP => '2024-08-28 02:00:00 -0700'
  ));
Copy
Langage: Français