Catégories :

Information Schema , Fonctions de table

AVAILABLE_LISTING_REFRESH_HISTORY

Renvoie l’historique d’actualisation des 14 derniers jours pour une annonce disponible ou une base de données montée à partir d’une annonce grâce à l’exécution automatique inter-Cloud. Les informations renvoyées contiennent les détails de la réplication des données ajoutées à la base de données de l’annonce lors de chaque événement d’actualisation. Cette fonction est disponible pour les consommateurs d’annonces qui disposent d’un privilège quelconque sur l’annonce disponible ou la base de données montée.

Syntaxe

AVAILABLE_LISTING_REFRESH_HISTORY(
  OBJECT_TYPE => '<object_type>',
  OBJECT_NAME => '<object_name>' )
Copy

Arguments

OBJECT_TYPE => 'object_type'

Le type de l’objet peut être listing ou database.

OBJECT_NAME => 'object_name'

Le nom de l’objet peut être le nom global de l’annonce ou le nom de la base de données montée, selon le type d’objet.

Sortie

La fonction renvoie les colonnes suivantes :

Nom de la colonne

Type de données

Description

OBJECT_TYPE

TEXT

Répertorie le type d’objet Snowflake. Par exemple, annonce.

OBJECT_NAME

TEXT

Nom de l’annonce ou de la base de données montée.

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

PRIMARY_UPLOADING_DATA : pourcentage du total des octets répliqués.

SECONDARY_DOWNLOADING_METADATA : pourcentage du nombre total d’objets répliqués.

SECONDARY_DOWNLOADING_DATA : pourcentage du total des octets répliqués.

Vide pour les phases restantes.

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.

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 des lignes pour un rôle ayant un privilège quelconque sur l’annonce, si l’annonce est visible pour le compte.

  • Lorsque object_type est défini sur database (par opposition à listing), seules les lignes correspondant à des rôles dotés d’un quelconque privilège dans cette base de données sont renvoyées.

  • 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

Exemples

Récupérer l’historique de la base de données my_mounted_database.

SELECT * FROM TABLE(
  INFORMATION_SCHEMA.AVAILABLE_LISTING_REFRESH_HISTORY(
    OBJECT_TYPE=>'database',
    OBJECT_NAME=>'my_mounted_database'
  )
);
Copy
OSZAR »