Kategorien:: Information Schema, Tabellenfunktionen

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'));