Kategorien:: Tabellenfunktionen

ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY¶

Liefert Metadaten und Snapshot-Informationen über die letzte Aktualisierungshistorie für eine angegebene, extern verwaltete- Apache Iceberg™-Tabelle.

Bemerkung

In Snowflake, Version 9.16, wurden Delta-basierte Tabellen für diese Funktion unterstützt. Die Funktion zeigt nur Delta-basierte Tabellenaktualisierungsdaten ab Version 9.16 und höher an.

Siehe auch:: Apache Iceberg™-Tabellen, Metadaten und Speicher für Apache Iceberg™-Tabellen, ALTER ICEBERG TABLE … REFRESH

Syntax¶

ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY(
  TABLE_NAME => '<table_name>'
)

Argumente¶

TABLE_NAME => 'table_name': Der Name der extern verwalteten Iceberg-Tabelle, für die Sie den Snapshot-Aktualisierungsverlauf abrufen möchten.

Ausgabe¶

Die Funktion gibt die folgenden Spalten zurück:


Spaltenname	Datentyp	Beschreibung	Anmerkung zu Delta-basierten Tabellen
REFRESHED_ON	TIMESTAMP_LTZ	Der Zeitstempel, wann die Tabelle zuletzt aktualisiert wurde.
METADATA_FILE_NAME	TEXT	Der vollständige Pfad zur Metadatendatei.	Der vollständige Pfad zur Commit- oder Checkpoint-Datei.
SNAPSHOT_ID	TEXT	Der Snapshot-ID der letzten Aktualisierung.	Die resultierende Commit-ID der letzten Aktualisierung.
SEQUENCE_NUMBER	TEXT	Die Sequenznummer der letzten Aktualisierung; NULL für Iceberg v1.	Nicht anwendbar für Delta-basierte Tabellen; wird als NULL angezeigt.
ICEBERG_SCHEMA_ID	TEXT	Die Schema-ID der Aktualisierung (aus den Metadaten).	Nicht anwendbar für Delta-basierte Tabellen; wird als NULL angezeigt.
QUERY_ID	TEXT	Die ID der Abfrage, die die Aktualisierung durchgeführt hat. Für Tabellen, die automatisierte Aktualisierung verwenden, enthält diese Spalte einen Sentinel-Wert, der anzeigt, dass die Aktualisierung automatisiert war.
IS_CURRENT_SNAPSHOT	BOOLEAN	TRUE wenn die Tabelle in diesem Snapshot aktualisiert wird; andernfalls FALSE.	TRUE, wenn die Tabelle auf diese Version aktualisiert wird (Commit); andernfalls FALSE.
SNAPSHOT_SUMMARY	VARIANT	Die Iceberg Snapshot-Zusammenfassung aus der Datei `metadata.json`. NULL falls nicht in der Metadaten-Datei vorhanden.	Nicht anwendbar für Delta-basierte Tabellen; wird als NULL angezeigt.

Beispiele¶

Abrufen von Informationen zur aktuellen Version einer extern verwalteten Iceberg-Tabelle namens my_iceberg_table:

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY(
    TABLE_NAME => 'my_iceberg_table'
  ));

Ausgabe:

+-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------+
| REFRESHED_ON                  | METADATA_FILE_NAME                                                               | SNAPSHOT_ID         | SEQUENCE_NUMBER | ICEBERG_SCHEMA_ID | QUERY_ID                             | IS_CURRENT_SNAPSHOT | SNAPSHOT_SUMMARY                |
|-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------|
| 2024-12-09 11:00:50.506 -0800 | s3://my-bucket/metadata/00000-e3bf7230-283f-4626-a770-fe97a3ca239e.metadata.json | NULL                | NULL            | 0                 | 01b8ebb4-0002-3a10-0000-012903c7e42a | False               | NULL                            |
| 2024-12-09 11:01:35.543 -0800 | s3://my-bucket/metadata/00001-bf116652-b5b0-479a-947e-6c799e4ca124.metadata.json | 6201065399847600377 | NULL            | 0                 | 01b8ebb5-0002-3a14-0000-012903c7f336 | True                | {                               |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-data-files": "4",      |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-files-size": "144896", |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-records": "150000",    |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-created": "1",     |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-kept": "0",        |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-replaced": "0",    |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-data-files": "4",      |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-files-size": "144896", |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-records": "150000"     |
|                               |                                                                                  |                     |                 |                   |                                      |                     | }                               |
+-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------+