SYSTEM$GET_TABLE_ARCHIVE_METADATA¶

Syntax¶

SYSTEM$GET_TABLE_ARCHIVE_METADATA( '<table_name>' )

Argumente¶

'table_name'

Der Name der Tabelle mit archivierten Daten. Die Tabelle muss Daten enthalten haben, die in die COOL- oder COLD-Speicherklasse archiviert wurden – in der Regel durch eine Storage-Lifecycle-Richtlinie.

Rückgabewerte¶

Gibt einen TEXT-Wert zurück, der JSON mit Metadaten über die archivierten Daten enthält. Die JSON-Struktur umfasst:

• rowCount: Die Anzahl der Zeilen im Archiv.

• columns: Ein Objekt mit Metadaten für jede Spalte:

  • column_id: Die Spalten-ID (wie in der COLUMNS-Ansicht zu sehen).

  • data_type: Den Datentyp der Spalte

  • min: Den Mindestwert für die Spalte, oder``null`` falls nicht zutreffend.

  • max: Den Höchstwert für die Spalte, oder``null`` falls nicht zutreffend.

Die Ausgabe enthält außerdem die archivierte Zeitstempelspalte (METADATA$STORAGE_LIFECYCLE_POLICY_ARCHIVED_TIMESTAMP), die angibt, wann jede Zeile archiviert wurde.

Beispielausgabe:

{
  "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"
    }
  }
}

Nutzungshinweise¶

• Der Tabelleneigentümer oder ein Kontoadministrator (ein Benutzer mit der ACCOUNTADMIN-Rolle), der Zugriff auf die Tabelle hat, kann diese -Funktion ausführen.

• Verwenden Sie diese Funktion, um die Metadaten archivierter Daten zu prüfen, ohne dass die Kosten für das Abrufen von Daten aus der Archivtabelle anfallen.

• Das column_id-Feld hilft dabei, Spalten zu unterscheiden, wenn eine Spalte gelöscht wurde und später eine neue Spalte mit demselben Namen hinzugefügt wurde.

• Um die eigentlich archivierten Daten abzurufen, verwenden Sie den Befehl CREATE TABLE … FROM ARCHIVE OF.

Beispiele¶

Abrufen von Metadaten über archivierte Daten für eine Tabelle:

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

Analysieren Sie die JSON-Ausgabe, um bestimmte Informationen zu extrahieren:

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