- Catégories :
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 au cours des 14 derniers jours.
Syntaxe¶
REPLICATION_USAGE_HISTORY(
[ DATE_RANGE_START => <constant_expr> ]
[ , DATE_RANGE_END => <constant_expr> ]
[ , DATABASE_NAME => '<string>' ] )
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 laDATE_RANGE_START
par défaut est 23h50 (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 * from table(information_schema.replication_usage_history( date_range_start=>'2019-02-10 12:00:00.000 +0000', date_range_end=>'2019-02-10 12:30:00.000 +0000'));
Récupérer l’historique des 12 dernières heures pour votre compte :
select * from table(information_schema.replication_usage_history( date_range_start=>dateadd(H, -12, current_timestamp)));
Récupérer l’historique de la semaine passée pour votre compte :
select * from table(information_schema.replication_usage_history( date_range_start=>dateadd(d, -7, current_date), date_range_end=>current_date));
Récupérez l’historique de réplication de la semaine écoulée pour une base de données spécifiée dans votre compte :
select * from table(information_schema.replication_usage_history( date_range_start=>dateadd(d, -7, current_date), date_range_end=>current_date, database_name=>'mydb'));