- Kategorien:
ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY¶
Liefert Metadaten und Snapshot-Informationen über die letzte Aktualisierungshistorie für eine angegebene, extern verwaltete- Apache Iceberg™-Tabelle.
- 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 |
|---|---|---|
REFRESHED_ON |
TIMESTAMP_LTZ |
Der Zeitstempel, wann die Tabelle zuletzt aktualisiert wurde. |
METADATA_FILE_NAME |
TEXT |
Der vollständige Pfad zur Metadatendatei. |
SNAPSHOT_ID |
TEXT |
Der Snapshot-ID der letzten Aktualisierung. |
SEQUENCE_NUMBER |
TEXT |
Die Sequenznummer der letzten Aktualisierung; NULL für Iceberg v1. |
ICEBERG_SCHEMA_ID |
TEXT |
Die Schema-ID der Aktualisierung (aus den Metadaten). |
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. |
SNAPSHOT_SUMMARY |
VARIANT |
Die Iceberg Snapshot-Zusammenfassung aus der Datei |
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" |
| | | | | | | | } |
+-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------+