Catégories :

Information Schema , Fonctions de table

REPLICATION_GROUP_REFRESH_HISTORY

Renvoie l’historique de réplication pour un groupe de réplication ou de basculement secondaire au cours des 14 derniers jours.

Syntaxe

REPLICATION_GROUP_REFRESH_HISTORY( '<secondary_group_name>' )
Copy

Arguments

secondary_group_name

Nom du groupe secondaire. Notez que le nom entier doit être entre guillemets simples.

Sortie

La fonction renvoie les colonnes suivantes :

Nom de la colonne

Type de données

Description

PHASE_NAME

TEXT

Phase actuelle de l’opération de réplication. Pour la liste des phases, voir les notes d’utilisation.

START_TIME

TIMESTAMP_LTZ

Heure à laquelle l’opération de réplication a commencé.

END_TIME

TIMESTAMP_LTZ

Heure à laquelle l’opération de réplication s’est terminée, le cas échéant. NULL si elle est toujours en cours.

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 le groupe de réplication ou de basculement.

  • Renvoie uniquement les lignes pour un groupe de réplication ou de basculement secondaire 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 de détails, voir Schéma d’information de Snowflake.

  • Voici la liste des phases de traitement dans l’ordre :

    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

Exemples

Récupérer l’historique des actualisations pour le groupe secondaire myfg.

select *
from table(information_schema.replication_group_refresh_history('myfg'));
Copy