Schéma :

ACCOUNT_USAGE

Vue REPLICATION_GROUP_REFRESH_HISTORY

Cette vue Account Usage peut être utilisée pour interroger l’historique d’actualisation d’un groupe de réplication ou de basculement spécifié.

Voir aussi :

REPLICATION_GROUP_REFRESH_HISTORY (fonction de table d’Information Schema)

Colonnes

Nom de la colonne

Type de données

Description

REPLICATION_GROUP_NAME

TEXT

Nom du groupe de réplication ou de basculement secondaire.

REPLICATION_GROUP_ID

NUMBER

Identificateur interne/généré par le système du groupe de réplication ou de basculement.

PHASE_NAME

TEXT

Phase actuelle de l’opération de réplication. Pour la liste des phases, voir les notes sur l’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

  • La latence de la vue peut atteindre 180 minutes (trois heures).

    Pour voir la progression de l’actualisation en temps réel, utilisez la fonction de table REPLICATION_GROUP_REFRESH_HISTORY.

  • Les résultats sont uniquement renvoyés pour les groupes de basculement ou de réplication secondaires dans le compte actuel (le compte cible).

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

    #

    Nom de la phase

    Description

    1

    SECONDARY_SYNCHRONIZING_MEMBERSHIP

    Le groupe de réplication secondaire ou de basculement reçoit des informations du groupe principal sur les objets inclus dans le groupe et met à jour ses métadonnées d’appartenance.

    2

    SECONDARY_UPLOADING_INVENTORY

    Le groupe de réplication secondaire ou de basculement envoie un inventaire de ses objets dans le compte cible au groupe principal.

    3

    PRIMARY_UPLOADING_METADATA

    Le groupe de réplication ou de basculement principal crée un instantané des métadonnées dans le compte source et l’envoie au groupe secondaire.

    4

    PRIMARY_UPLOADING_DATA

    Le groupe de réplication principal ou de basculement copie les fichiers dont le groupe secondaire a besoin pour réconcilier les deltas entre les objets des comptes source et cible.

    5

    SECONDARY_DOWNLOADING_METADATA

    Le groupe de réplication ou de basculement secondaire applique l’instantané des métadonnées envoyées par le groupe principal. Les mises à jour des métadonnées ne sont pas appliquées de manière atomique mais au fil du temps.

    6

    SECONDARY_DOWNLOADING_DATA

    Le groupe de réplication secondaire ou de basculement copie les fichiers envoyés par le groupe principal vers le compte cible.

    7

    COMPLETED / FAILED / CANCELED

    Actualiser le statut de l’opération.

Exemples

Pour récupérer l’historique d’actualisation du groupe de basculement secondaire myfg, exécutez l’instruction suivante :

SELECT phase_name, start_time, end_time,
       total_bytes, object_count, error
  FROM SNOWFLAKE.ACCOUNT_USAGE.REPLICATION_GROUP_REFRESH_HISTORY
  WHERE replication_group_name = 'MYFG';
Copy

Pour récupérer le dernier enregistrement d’actualisation pour chaque groupe de réplication ou de basculement, exécutez l’instruction suivante :

SELECT replication_group_name, phase_name,
       start_time, end_time,
       total_bytes, object_count, error,
       ROW_NUMBER() OVER (
         PARTITION BY replication_group_name
         ORDER BY end_time DESC
       ) AS row_num
  FROM SNOWFLAKE.ACCOUNT_USAGE.REPLICATION_GROUP_REFRESH_HISTORY
  QUALIFY row_num = 1;
Copy
Langage: Français