Catégories :

Information Schema , Fonctions de table

AUTO_REFRESH_REGISTRATION_HISTORY

Cette fonction de table permet d’interroger l’historique des fichiers de données enregistrés dans les métadonnées des objets spécifiés et les crédits facturés pour ces opérations. La fonction de table renvoie l’historique de facturation dans une plage de dates spécifiée pour l’ensemble de votre compte Snowflake.

Note

Cette fonction renvoie l’activité de facturation au cours des 14 derniers jours.

Syntaxe

AUTO_REFRESH_REGISTRATION_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ]
      [, OBJECT_TYPE => '<string>' [, OBJECT_NAME => '<string>'] ])

Arguments

Tous les arguments sont facultatifs.

DATE_RANGE_START => expr_constante , . DATE_RANGE_END => expr_constante

Plage de dates/heures de la fenêtre de facturation :

  • Si aucune date de fin n’est spécifiée, CURRENT_DATE est utilisée comme date de fin de plage.

  • Si aucune date de début n’est spécifiée, la plage commence 10 minutes avant le début de DATE_RANGE_END ; c’est-à-dire que la valeur par défaut est d’afficher les 10 minutes précédentes de l’historique de facturation. Par exemple, si DATE_RANGE_END est CURRENT_DATE, alors le DATE_RANGE_START par défaut est 11h50 PM le jour précédent.

L’historique est affiché par incréments de 5 minutes, 1 heure ou 24 heures (selon la durée de l’intervalle spécifié).

OBJECT_TYPE => chaîne

Type d’objet pour lequel les crédits sont facturés. La valeur suivante est prise en charge :

EXTERNAL_TABLE

Tables externes configurées pour l’actualisation automatique des métadonnées.

OBJECT_NAME => chaîne

Une chaîne de caractères spécifiant le nom de l’objet pour lequel des crédits sont facturés.

Notes sur l’utilisation

  • Renvoie les résultats uniquement pour le rôle ACCOUNTADMIN ou tout rôle auquel le privilège global MONITOR USAGE a été explicitement accordé.

  • Lors de l’appel d’une fonction de la table de schémas d’informations, la session doit avoir un schéma INFORMATION_SCHEMA en cours d’utilisation ou le nom de la fonction doit être complètement qualifié. Pour plus de détails, voir Schéma d’information.

Sortie

La fonction renvoie les colonnes suivantes :

Nom de la colonne

Type de données

Description

START_TIME

TIMESTAMP_LTZ

Début de la fenêtre de facturation spécifiée.

END_TIME

TIMESTAMP_LTZ

Fin de la fenêtre de facturation spécifiée.

OBJECT_NAME

TEXT

Nom de l’objet pour lequel des crédits sont facturés.

OBJECT_TYPE

TEXT

Type d’objet pour lequel les crédits sont facturés.

CREDITS_USED

TEXT

Nombre de crédits facturés pour les fichiers de données enregistrés dans les métadonnées de l’objet ou du type d’objet spécifié pendant la fenêtre START_TIME et END_TIME.

FILES_REGISTERED

NUMBER

Nombre de fichiers enregistrés pendant la fenêtre comprise entre START_TIME et END_TIME.

Exemples

Récupérez l’historique de facturation pour toutes les tables externes de votre compte qui sont configurées pour les actualisations automatiques des métadonnées. La requête récupère l’historique pour une période de 30 minutes, par intervalles de 5 minutes :

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>to_timestamp_tz('2021-06-17 12:00:00.000 -0700'),
    date_range_end=>to_timestamp_tz('2021-06-17 12:30:00.000 -0700'),
    object_type=>'external_table'));

Identique à l’exemple précédent, mais récupère l’historique de facturation des 14 derniers jours, par périodes de 1 jour :

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('day',-14,current_date()),
    date_range_end=>current_date())
    object_type=>'external_table'));

Identique au premier exemple, mais récupère l’historique de facturation des 14 derniers jours, par périodes de 1 jour :

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('day',-14,current_date()),
    date_range_end=>current_date(),
    object_type=>'external_table'));

Récupérez l’historique de facturation d’une table externe nommée myexttable dans le schéma actif de la session pour les 12 dernières heures, par périodes de 1 heure :

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('hour',-12,current_timestamp()),
    object_type=>'external_table',
    object_name=>'myexttable'));

Récupérez l’historique de facturation d’une table externe nommée myexttable dans le schéma mydb.myschema pour les 12 dernières heures, par périodes de 1 heure :

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('hour',-12,current_timestamp()),
    object_type=>'external_table',
    object_name=>'mydb.myschema.myexttable'));