Catégories :

Fonctions de métrique des données

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

Renvoie l’horodatage de l’exécution planifiée d’une DMF ou l’horodatage actuel si la fonction est appelée manuellement.

Vous pouvez utiliser cette DMF pour définir des métriques personnalisées afin de mesurer le niveau d’actualisation de vos données ou de définir des métriques incrémentielles en conjonction avec les DMFs qui existent déjà.

Syntaxe

SNOWFLAKE.CORE.DATA_METRIC_SCHEDULED_TIME()
Copy

Arguments

Aucun.

Renvoie

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

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

L’appel manuel de cette fonction dans une requête SELECT renvoie la même valeur que la fonction CURRENT_TIMESTAMP.

Exemple

Créez une fonction de métrique des données personnalisée pour déterminer le niveau d’actualisation des données d’une table au cours de la dernière heure :

CREATE OR REPLACE DATA METRIC FUNCTION data_freshness_hour(
  ARG_T TABLE (ARG_C TIMESTAMP_LTZ))
  RETURNS NUMBER AS
  'SELECT TIMEDIFF(
     minute,
     MAX(ARG_C),
     SNOWFLAKE.CORE.DATA_METRIC_SCHEDULED_TIME())
   FROM ARG_T';
Copy

Appelez manuellement la fonction de métrique des données :

SELECT data_freshness_hour(SELECT last_updated FROM hr.tables.empl_info) < 60;
Copy

L’instruction renvoie True si la table n’a pas été mise à jour depuis une heure (60 minutes).

L’instruction renvoie False si la table a été mise à jour il y a plus d’une heure.

Langage: Français