- Kategorien:
EXTERNAL_TABLE_FILE_REGISTRATION_HISTORY¶
Mit dieser Tabellenfunktion können Informationen zum Metadatenverlauf für eine externe Tabelle abgefragt werden, darunter:
Dateien, die im Rahmen einer Metadatenaktualisierung automatisch hinzugefügt oder entfernt wurden.
Fehler beim Aktualisieren der Metadaten.
Syntax¶
EXTERNAL_TABLE_FILE_REGISTRATION_HISTORY (
TABLE_NAME => '<string>'
[, START_TIME => <constant_expr> ] )
Argumente¶
Benötigt:
TABLE_NAME => 'Zeichenfolge'
Eine Zeichenfolge, die den Namen einer externen Tabelle angibt.
Optional:
START_TIME => Konstantenausdruck
Zeitstempel (im Format TIMESTAMP_LTZ) innerhalb der letzten 14 Tage, der den Beginn des Zeitbereichs zum Abrufen von Metadatenaktualisierungsereignissen markiert.
Bemerkung
Wenn keine Startzeit angegeben ist, gibt die Funktion alle Aktualisierungsereignisse innerhalb der letzten 14 Tage zurück.
Wenn die Startzeit außerhalb der letzten 14 Tage liegt, gibt die Funktion leere Ergebnisse zurück.
Nutzungshinweise¶
Die Tabellenfunktion kann keine Metadaten zu bereitgestellten Datendateien abrufen, bis die externe Tabelle aktualisiert (d. h. synchronisiert) wurde, um die Datendateien in ihre Metadaten aufzunehmen.
Beim Aufrufen einer Tabellenfunktion des Information Schema muss die Sitzung über ein aktives INFORMATION_SCHEMA-Schema verfügen oder der Funktionsname muss vollqualifiziert sein. Weitere Details dazu finden Sie unter Information Schema.
Ausgabe¶
Die Funktion gibt die folgenden Spalten zurück:
Spaltenname |
Datentyp |
Beschreibung |
---|---|---|
JOB_CREATED_TIME |
TIMESTAMP_LTZ |
Zeitstempel des Zeitpunkts, zu dem der Vorgang ausgeführt wurde |
FILE_NAME |
TEXT |
Name der bereitgestellten Quelldatei und relativer Pfad zur Datei |
OPERATION_STATUS |
TEXT |
Status: REGISTERED_NEW, REGISTERED_UPDATE, REGISTER_SKIPPED, REGISTER_FAILED, UNREGISTERED oder UNREGISTER_FAILED. |
MESSAGE |
TEXT |
Begleitende Meldung zum Betriebsstatus |
FILE_SIZE |
NUMBER |
Größe der Datei (in Byte), die der externen Tabelle hinzugefügt wurde |
LAST_MODIFIED |
TIMESTAMP_LTZ |
Zeitstempel des Zeitpunkts, wann die Datei im Stagingbereich zuletzt aktualisiert wurde |
Beispiele¶
Abrufen der Metadaten, die für alle Datendateien gespeichert sind, auf die in der externen Tabelle mytable
verwiesen wird:
select * from table(information_schema.external_table_file_registration_history(TABLE_NAME=>'MYTABLE'));
Abrufen der Registrierungsereignisse für die externe Tabelle mydb.public.external_table_name
, die in der letzten Stunde gestartet wurden:
select * from table(information_schema.external_table_file_registration_history( start_time=>dateadd('hour',-1,current_timestamp()), table_name=>'mydb.public.external_table_name'));