Catégories :

Information Schema , Fonctions de table

DATABASE_REPLICATION_USAGE_HISTORY

Cette fonction de table peut être utilisée pour interroger l’historique de réplication d’une base de données spécifiée dans une plage de dates spécifiée. Les informations renvoyées par la fonction incluent le nom de la base de données, les crédits utilisés et les octets transférés pour la réplication.

Note

Cette fonction renvoie l’activité d’utilisation de la réplication de base de données au cours des 14 derniers jours.

Syntaxe

DATABASE_REPLICATION_USAGE_HISTORY(
  [ DATE_RANGE_START => <constant_expr> ]
  [ , DATE_RANGE_END => <constant_expr> ]
  [ , DATABASE_NAME => '<string>' ] )
Copy

Arguments

Tous les arguments sont facultatifs.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

La plage de date/heure pour afficher l’historique de réplication de la base de données :

  • 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).

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.

DATABASE_NAME => 'string'

Nom de la base de données. Si spécifié, affiche uniquement l’historique de la base de données spécifiée.

Si aucun nom n’est spécifié, les résultats incluent les données de chaque base de données répliquée dans la plage de temps spécifiée.

Sortie

La fonction renvoie les éléments suivants dans un objet JSON :

Nom de la colonne

Type de données

Description

START_TIME

TIMESTAMP_LTZ

Début de l’intervalle de temps spécifié.

END_TIME

TIMESTAMP_LTZ

Fin de l’intervalle de temps spécifié.

DATABASE_NAME

TEXT

Nom de la base de données.

CREDITS_USED

TEXT

Nombre de crédits facturés pour la réplication de la base de données durant la fenêtre allant de START_TIME à END_TIME.

BYTES_TRANSFERRED

NUMBER

Nombre d’octets transférés pour la réplication de bases de données durant la fenêtre allant de START_TIME à END_TIME.

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 de Snowflake.

Exemples

Récupérer l’historique de réplication d’une durée de 30 minutes pour votre compte :

select database_name, credits_used, bytes_transferred
  from table(information_schema.database_replication_usage_history(
    date_range_start=>'2023-03-28 12:00:00.000 +0000',
    date_range_end=>'2023-03-28 12:30:00.000 +0000'));
Copy

Récupérer l’historique des 12 dernières heures pour votre compte :

select database_name, credits_used, bytes_transferred
  from table(information_schema.database_replication_usage_history(
    date_range_start=>dateadd(H, -12, current_timestamp)));
Copy

Récupérer l’historique de la semaine passée pour votre compte :

select start_time, end_time, database_name, credits_used, bytes_transferred
  from table(information_schema.database_replication_usage_history(
    date_range_start=>dateadd(d, -7, current_date),
    date_range_end=>current_date));
Copy

Récupérez l’historique de réplication de la semaine écoulée pour une base de données mydb dans votre compte :

select start_time, end_time, database_name, credits_used, bytes_transferred
  from table(information_schema.database_replication_usage_history(
    date_range_start=>dateadd(d, -7, current_date),
    date_range_end=>current_date,
    database_name=>'mydb'));
Copy