Catégories :

Schéma d’information, Fonctions de table

DATA_TRANSFER_HISTORY

Cette fonction de table peut être utilisée pour interroger l’historique des données transférées depuis les tables Snowflake vers un réseau d’un autre fournisseur de stockage sur le Cloud (c’est-à-dire depuis Snowflake sur AWS, Google Cloud Platform ou Microsoft Azure vers le réseau de l’autre fournisseur Cloud) et/ou d’une région géographique différente dans une période donnée. La fonction renvoie l’historique de l’ensemble de votre compte Snowflake.

Note

Cette fonction renvoie l’activité de transfert de données au cours des 14 derniers jours.

Syntaxe

DATA_TRANSFER_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ] )

Arguments

Tous les arguments sont facultatifs.

DATE_RANGE_START => expr_constante , . DATE_RANGE_END => expr_constante

La date/l’heure, au cours des 2 dernières semaines, pour laquelle l’historique du transfert de données doit être récupéré :

  • 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 par défaut, les 10 minutes précédentes de l’historique du transfert de données sont affichées). 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é).

Si la plage tombe en dehors des 15 derniers jours, une erreur est renvoyée.

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 plage de temps spécifiée dans laquelle le transfert de données a eu lieu.

END_TIME

TIMESTAMP_LTZ

Fin de la plage de temps spécifiée dans laquelle le transfert de données a eu lieu.

SOURCE_CLOUD

TEXT

Nom du fournisseur Cloud d’où provient le transfert de données : Amazon Web Services, Google Cloud Platform ou Microsoft Azure.

SOURCE_REGION

TEXT

Région d’origine du transfert de données.

TARGET_CLOUD

TEXT

Nom du fournisseur Cloud où les données ont été envoyées : AWS, Google Cloud Platform ou Microsoft Azure.

TARGET_REGION

TEXT

Région où les données ont été envoyées.

BYTES_TRANSFERRED

NUMBER

Nombre d’octets transférés pendant la fenêtre allant de START_TIME à END_TIME.

TRANSFER_TYPE

VARCHAR

Type d’opération qui a provoqué le transfert. “COPY”, “REPLICATION”, EXTERNAL_FUNCTION”.

Exemples

Récupérez l’historique des transferts de données pour une période de 30 minutes, par intervalles de 5 minutes, pour votre compte :

select *
  from table(mydb.information_schema.data_transfer_history(
    date_range_start=>to_timestamp_tz('2017-10-24 12:00:00.000 -0700'),
    date_range_end=>to_timestamp_tz('2017-10-24 12:30:00.000 -0700')));

Récupérez l’historique des transferts de données des 12 dernières heures, par intervalles d’1 heure, pour votre compte :

select *
  from table(information_schema.data_transfer_history(
    date_range_start=>dateadd('hour',-12,current_timestamp())));

Récupérez l’historique des transferts de données des 14 derniers jours, par intervalles d’1 jour, pour votre compte :

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