SYSTEM$GET_TABLE_ARCHIVE_METADATA¶

Syntaxe¶

SYSTEM$GET_TABLE_ARCHIVE_METADATA( '<table_name>' )

Arguments¶

'table_name'

Nom de la table contenant les données archivées. Les données de la table doivent avoir été archivées au niveau COOL ou COLD, généralement par une politique de cycle de vie du stockage.

Renvoie¶

Renvoie une valeur TEXT contenant JSON avec des métadonnées relatives aux données archivées. La structure JSON comprend :

• rowCount : Nombre de lignes dans l’archive.

• columns : Objet contenant des métadonnées pour chaque colonne :

  • column_id : ID de colonne (comme indiqué dans la vue COLUMNS).

  • data_type : Type de données de la colonne

  • min : La valeur minimale de la colonne, ou null si non applicable.

  • max : La valeur maximale de la colonne, ou null si non applicable.

La sortie comprend également la colonne d’horodatage archivée (METADATA$STORAGE_LIFECYCLE_POLICY_ARCHIVED_TIMESTAMP), qui indique quand chaque ligne a été archivée.

Exemple de sortie :

{
  "rowCount": 2304,
  "columns": {
    "CUSTOMER_ID": {
      "column_id": 10283,
      "data_type": "fixed",
      "min": -23,
      "max": 54032
    },
    "CUSTOMER_NAME": {
      "column_id": 10284,
      "data_type": "text",
      "min": null,
      "max": null
    },
    "METADATA$STORAGE_LIFECYCLE_POLICY_ARCHIVED_TIMESTAMP": {
      "data_type": "timestampltz",
      "min": "2025-01-02T03:04:05.6789Z",
      "max": "2025-11-12T13:14:15.1617Z"
    }
  }
}

Notes sur l’utilisation¶

• Le propriétaire de la table ou un administrateur de compte (un utilisateur avec le rôle ACCOUNTADMIN) qui a accès à la table peut exécuter cette fonction.

• Utilisez cette fonction pour inspecter les métadonnées des données archivées sans encourir de coûts liés à la récupération des données à partir du niveau d’archivage.

• Le champ column_id permet de distinguer les colonnes lorsqu’une colonne a été supprimée et qu’une nouvelle colonne avec le même nom a été ajoutée ultérieurement.

• Pour récupérer les données archivées réelles, utilisez la commande CREATE TABLE … FROM ARCHIVE OF.

Exemples¶

Récupérer les métadonnées relatives aux données archivées pour une table :

SELECT SYSTEM$GET_TABLE_ARCHIVE_METADATA('my_database.my_schema.my_table');

Analyser la sortie JSON pour extraire des informations spécifiques :

SELECT PARSE_JSON(SYSTEM$GET_TABLE_ARCHIVE_METADATA('my_database.my_schema.my_table')):rowCount AS archived_row_count;