Catégories :

Fonctions de métrique des données

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

Renvoie la différence en secondes entre la valeur maximale d’une colonne d’horodatage et l’heure prévue lors de l’exécution de la fonction de métrique des données.

Syntaxe

SNOWFLAKE.CORE.FRESHNESS(<query>)
Copy

Arguments

query

Spécifie une requête SQL sur une table ou une vue.

Types de données autorisés

Les colonnes référencées dans la query doivent être de l’un des types de données suivants :

  • DATE

  • TIMESTAMP_LTZ

  • TIMESTAMP_TZ

Renvoie

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

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

Pour utiliser une DMF système, choisissez l’une des approches de contrôle d’accès suivantes :

  • Attribuez le rôle de base de données DATA_METRIC_USER au rôle de propriétaire de la table, qui est le rôle disposant du privilège OWNERSHIP sur la table. Ce rôle de base de données dispose du privilège USAGE sur le schéma SNOWFLAKE.CORE et du privilège USAGE sur toutes les DMFs systèmes dans le schéma SNOWFLAKE.CORE.

    En outre, accordez les privilèges de cette table au rôle de propriétaire de la table :

    Privilège

    Objet

    Remarques

    EXECUTE DATA METRIC FUNCTION

    Compte

    Ce privilège vous permet de contrôler les rôles qui ont accès aux ressources de calcul sans serveur pour appeler la DMF système.

    USAGE

    Base de données, schéma

    Ces objets sont la base de données et le schéma qui contiennent la table à laquelle est fait référence dans query.

  • Accordez les privilèges de la table précédente au rôle de propriétaire de la table. De plus, accordez les privilèges suivants au propriétaire de la table :

  • Utilisez le rôle ACCOUNTADMIN.

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.

Exemple

Déterminez le niveau d’actualisation des données, 300 secondes ou 5 minutes, dans la table en mesurant la colonne TIMESTAMP :

SELECT SNOWFLAKE.CORE.FRESHNESS(
  SELECT
    timestamp
  FROM hr.tables.empl_info
) < 300;
Copy
+---------------------------------------------------------------------+
| SNOWFLAKE.CORE.FRESHNESS(SELECT timestamp FROM hr.tables.empl_info) |
+---------------------------------------------------------------------+
| True                                                                |
+---------------------------------------------------------------------+
Langage: Français