Catégories :: Information Schema , Fonctions de table

LISTING_REFRESH_HISTORY¶

Renvoie l’historique d’actualisation des 14 derniers jours pour une annonce d’exécution automatique inter-Cloud. Les informations renvoyées contiennent des détails de réplication des événements d’actualisation au cours desquels l’annonce est synchronisée avec une région cible spécifiée.

Cette fonction est disponible pour les fournisseurs d’annonces qui disposent d’un privilège quelconque sur l’annonce spécifiée.

Syntaxe¶

LISTING_REFRESH_HISTORY(
  LISTING_NAME => '<listing_name>'
  [ , SNOWFLAKE_REGION => '<snowflake_region>' ]
  [ , REGION_GROUP => '<region_group>' ] )

Copy

Arguments¶

Nécessaire

LISTING_NAME => 'listing_name': Identificateur SQL d’une annonce d’exécution automatique inter-Cloud dans ce compte. L’identificateur SQL pour les annonces est disponible dans la colonne des noms renvoyée en affichant les annonces dans l’échange de données <nom_échange>. De même, l’identificateur SQL pour les échanges de données est disponible dans la colonne des noms renvoyée par show data exchanges.

Facultatif

SNOWFLAKE_REGION => 'snowflake_region'

Groupe de régions Snowflake vers lequel l’annonce est répliquée, où vous pouvez afficher l’historique d’actualisation pour cette réplication. Le formatage est le même que celui de la colonne snowflake_region renvoyée par SHOW REGIONS. Si aucune région n’est spécifiée, l’historique de toutes les régions cibles est affiché.

REGION_GROUP => 'region_group'

Groupe de régions Snowflake vers lequel l’annonce est répliquée, où vous pouvez afficher l’historique d’actualisation.

PUBLIC par défaut. Cet argument ne doit être spécifié que si la région cible surveillée se trouve dans une région US gouvernementale ou Virtual Private Snowflake.

Sortie¶

La fonction renvoie les colonnes suivantes :

Nom de la colonne	Type de données	Description
LISTING_NAME	TEXT	Nom de l’annonce d’exécution automatique inter-Cloud dans ce compte.
SNOWFLAKE_REGION	TEXT	Nom de la région Snowflake vers laquelle l’annonce est répliquée. Par exemple, `aws_us_east_1`.
REGION_GROUP	TEXT	Nom du groupe de la région Snowflake vers lequel l’annonce est répliquée. Par exemple, PUBLIC.
PHASE	TEXT	Phase actuelle de l’opération de réplication, représentée par une phase sur un total de X phases. Par exemple, 2/6.
PHASE_NAME	TEXT	Nom des phases de réplication terminées (ou en cours) jusqu’à présent. Pour la liste des phases, voir Notes sur l’utilisation.
PROGRESS	TEXT	Progression de la réplication en pourcentage.
START_TIME	TIMESTAMP_LTZ	Heure à laquelle la phase de réplication a commencé.
END_TIME	TIMESTAMP_LTZ	Heure de fin de la phase, le cas échéant. NULL si la phase est en cours ou s’il s’agit de la phase finale (`COMPLETED/FAILED/CANCELED`).
JOB_UUID	TEXT	ID de requête pour la tâche d’actualisation.
TOTAL_BYTES	VARIANT	Un objet JSON qui fournit des informations détaillées sur les bases de données actualisées : `totalBytesToReplicate` : nombre total d’octets dont la réplication est attendue. `bytesUploaded` : nombre réel d’octets téléchargés. `bytesDownloaded` : nombre réel d’octets téléchargés. `databases` : liste d’objets JSON contenant les champs suivants pour chaque base de données membre : `name` : nom de la base de données. `totalBytesToReplicate` : total des octets prévus pour être répliqués pour la base de données.
OBJECT_COUNT	VARIANT	Un objet JSON qui fournit des informations détaillées sur les objets actualisés : `totalObjects` : nombre total d’objets dans le groupe de réplication ou de basculement. `completedObjects` : nombre total d’objets terminés. `objectTypes` : liste d’objets JSON contenant les champs suivants pour chaque type : `objectType` : type d’objet (par exemple utilisateurs, rôles, accords de privilèges, entrepôts, schémas, tables, colonnes, etc.). `totalObjects` : nombre total d’objets de ce type dans le groupe de réplication ou de basculement. `completedObjects` : nombre total d’objets de ce type qui ont été terminés.
PRIMARY_SNAPSHOT_TIMESTAMP	TIMESTAMP_LTZ	Horodatage de la création de l’instantané principal.
ERROR	VARIANT	NULL si l’opération d’actualisation est réussie. Si l’opération d’actualisation échoue, elle renvoie un objet JSON qui fournit des informations détaillées sur l’erreur : `errorCode` : code d’erreur de l’échec. `errorMessage` : message d’erreur de l’échec.

Notes sur l’utilisation¶

Ne renvoie que les lignes pour un rôle ayant un quelconque privilège sur l’annonce.
Renvoie uniquement les lignes pour une annonce dans le compte actuel.
Lors de l’appel d’une fonction de table Information Schema, 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 d’informations, voir Information Schema.

Liste des phases dans l’ordre de traitement :
1. SECONDARY_SYNCHRONIZING_MEMBERSHIP
2. SECONDARY_UPLOADING_INVENTORY
3. PRIMARY_UPLOADING_METADATA
4. PRIMARY_UPLOADING_DATA
5. SECONDARY_DOWNLOADING_METADATA
6. SECONDARY_DOWNLOADING_DATA
7. COMPLETED / FAILED / CANCELED

La sortie comprendra également l’historique des autres annonces qui font référence à la même base de données, puisqu’elles sont actualisées ensemble. Si l’entrée est une annonce d’applications, elle contient l’historique de toutes les annonces d’application dans la région donnée.
Dans les phases PRIMARY_UPLOADING_DATA et SECONDARY_DOWNLOADING_DATA, la valeur totalBytesToReplicate est estimée avant l’opération de réplication. Cette valeur peut différer de la valeur totalBytesToUpload ou totalBytesToDownload dans la phase respective.

Par exemple, si au cours de la phase PRIMARY_UPLOADING_DATA, une opération de réplication précédente a téléchargé certains octets mais a été annulée avant la fin de l’opération, ces octets ne seront pas téléchargés à nouveau. Dans ce cas, totalBytesToUpload serait inférieur à totalBytesToReplicate.

Exemples¶

Récupérer l’historique de l’annonce my_listing qui s’actualise sur AWS US East-1, une région de Cloud public.

select * from table(information_schema.listing_refresh_history(listing_name=>'my_listing',snowflake_region=>'AWS_US_EAST_1))

Copy