- Kategorien:
EXTERNAL_TABLE_FILES¶
Mit dieser Tabellenfunktion können Informationen zu den in den Metadaten enthaltenen bereitgestellten Datendateien für eine angegebene externe Tabelle abgefragt werden.
Syntax¶
EXTERNAL_TABLE_FILES(
TABLE_NAME => '<string>' )
Argumente¶
Benötigt:
TABLE_NAME => 'string'Eine Zeichenfolge, die den Namen einer externen Tabelle angibt.
Nutzungshinweise¶
Die Funktion gibt die Ergebnisse für den Eigentümer der externen Tabelle (d. h. für die Rolle mit der Berechtigung OWNERSHIP für die externe Tabelle) oder eine höhere Rolle zurück, oder für eine Rolle mit der Berechtigung USAGE für die Datenbank und das Schema, die eine externe Tabelle und eine beliebige Berechtigung für die externe Tabelle enthalten.
Mit der Tabellenfunktion können Metadaten zu Staging-Datendatei erst abgerufen werden, wenn die externe Tabelle aktualisiert (d. h. synchronisiert) wurde. Erst danach können die Datendateien den Metadaten hinzugefügt werden.
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 Snowflake Information Schema.
Ausgabe¶
Die Funktion gibt die folgenden Spalten zurück:
Spaltenname |
Datentyp |
Beschreibung |
|---|---|---|
FILE_NAME |
TEXT |
Name der Quelldatei und relativer Pfad zur Stagingdatei |
REGISTERED_ON |
TIMESTAMP_LTZ |
Zeitstempel des Zeitpunkts, zu dem die Dateimetadaten einer externen Tabelle hinzugefügt wurden (d. h. als die Metadaten der externen Tabelle mit den Dateidetails aktualisiert wurden) |
FILE_SIZE |
NUMBER |
Größe der Datei (in Byte) |
LAST_MODIFIED |
TIMESTAMP_LTZ |
Zeitstempel des Zeitpunkts, wann die Datei im Stagingbereich zuletzt aktualisiert wurde |
ETAG |
HEX |
ETag-Header für die Datei |
MD5 |
HEX |
MD5-Prüfsumme für die Datei |
Beispiele¶
Rufen Sie die Metadaten ab, die für alle Datendateien gespeichert sind, auf die in der externen Tabelle mytable verwiesen wird:
select * from table(information_schema.external_table_files(TABLE_NAME=>'MYTABLE'));