ONLINE_FEATURE_TABLE_REFRESH_HISTORY¶
Diese Tabellenfunktion gibt Informationen über jede Aktualisierung (abgeschlossen und in Ausführung) von Online-Feature-Tabellen zurück.
Diese Tabellenfunktion gibt alle in Ausführung befindlichen Aktualisierungen sowie alle Aktualisierungen zurück, die einen REFRESH_START_TIME-Wert innerhalb von 7 Tagen nach dem aktuellen Zeitpunkt haben.
- Siehe auch:
CREATE ONLINE FEATURE TABLE, ALTER ONLINE FEATURE TABLE, DESCRIBE ONLINE FEATURE TABLE, DROP ONLINE FEATURE TABLE, SHOW ONLINE FEATURE TABLES
Syntax¶
ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
[ REFRESH_START_TIMESTAMP => <constant_expr> ]
[ , REFRESH_END_TIMESTAMP => <constant_expr> ]
[ , RESULT_LIMIT => <integer> ]
[ , NAME => '<string>' ]
[ , NAME_PREFIX => '<string>' ]
[ , ERROR_ONLY => { TRUE | FALSE } ]
)
Argumente¶
Alle Argumente sind optional. Werden keine Argumente angegeben, werden 100 Aktualisierungen aus allen Online-Feature-Tabellen des Kontos zurückgegeben.
REFRESH_START_TIMESTAMP => constant_expr,REFRESH_END_TIMESTAMP => constant_exprZeitraum (im Format TIMESTAMP_LTZ), in dem die Aktualisierungen stattgefunden haben. Wenn kein Enddatum angegeben ist, wird CURRENT_TIMESTAMP als Ende des Bereichs verwendet.
RESULT_LIMIT => integerEine Zahl, die die maximale Anzahl von Zeilen angibt, die von der Funktion zurückgegeben werden. Wenn die Anzahl der übereinstimmenden Zeilen größer als dieser Grenzwert ist, werden die Aktualisierungen mit der jüngsten Endzeit (oder Aktualisierungen, die noch ausgeführt werden) zurückgegeben – bis zum angegebenen Grenzwert.
Reichweite: 1 bis 10.000
Standard: 100.
NAME => 'string'Der Name einer Online-Feature-Tabelle.
Sie können den nicht qualifizierten Namen (
online_feature_table_name), den teilweise qualifizierten Namen (schema_name.online_feature_table_name) oder den vollqualifizierten Namen (database_name.schema_name.online_feature_table_name) angeben.Weitere Informationen zur Auflösung von Objektnamen finden Sie unter Auflösung von Objektnamen.
Die Funktion gibt die Aktualisierungen für diese Tabelle zurück.
NAME_PREFIX => 'string'Ein Präfix für Online-Feature-Tabellen.
Die Funktion liefert Aktualisierungen für Tabellen, deren Namen mit diesem Präfix beginnen.
Sie können dieses Argument verwenden, um die Aktualisierungen für Online-Feature-Tabellen in einer bestimmten Datenbank oder einem bestimmten Schema zurückzugeben.
ERROR_ONLY => { TRUE | FALSE }Wenn diese Funktion auf TRUE gesetzt ist, werden nur Aktualisierungen zurückgegeben, die fehlgeschlagen sind oder abgebrochen wurden.
Standard: FALSE
Ausgabe¶
Die Ausgabe des Befehls enthält die folgenden Spalten, die die Eigenschaften und Metadaten des Objekts beschreiben:
Spalte |
Datentyp |
Beschreibung |
|---|---|---|
|
TEXT |
Name der Online-Feature-Tabelle. |
|
TEXT |
Name des Schemas, das die Online-Feature-Tabelle enthält. |
|
TEXT |
Name der Datenbank, die die Online-Feature-Tabelle enthält. |
|
TEXT |
Vollqualifizierter Name der Online-Feature-Tabelle. |
|
TEXT |
Status der Aktualisierung der Online-Feature-Tabelle. Folgende Status sind verfügbar:
|
|
TIMESTAMP_LTZ |
Zeitpunkt, zu dem der Aktualisierungsjob gestartet wurde. |
|
TIMESTAMP_LTZ |
Zeitpunkt, zu dem die Aktualisierung abgeschlossen wurde. |
|
TEXT |
Eine der folgenden Optionen:
|
|
TEXT |
Eine der folgenden Optionen:
|
|
TEXT |
ID der SQL-Anweisung, die die Ergebnisse für die Online-Feature-Tabelle erzeugt hat. |
|
TEXT |
Code, der den aktuellen Status der Aktualisierung angibt. |
|
TEXT |
Beschreibung des aktuellen Status der Aktualisierung. |
Anforderungen an die Zugriffssteuerung¶
Berechtigung |
Objekt |
Anmerkungen |
|---|---|---|
MONITOR |
Online-Feature-Tabelle |
Rolle, die über die MONITOR-Berechtigung für die Online-Feature-Tabelle verfügt. |
Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.
Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.
Nutzungshinweise¶
Diese Funktion ist im INFORMATION_SCHEMA verfügbar.
Die von dieser Funktion zurückgegebenen Informationen sind aktuell. Der Aktualisierungsverlauf der Online-Feature-Tabelle in der Ansicht ACCOUNT_USAGE.ONLINE_FEATURE_TABLE_REFRESH_HISTORY kann sich bis zu 3 Stunden verzögern.
Beispiele¶
Das folgende Beispiel gibt den Aktualisierungsverlauf für alle Online-Feature-Tabellen im Konto zurück:
SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY());
Das folgende Beispiel gibt den Aktualisierungsverlauf für eine bestimmte Online-Feature-Tabelle namens my_feature_table zurück:
SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
NAME => 'my_feature_table'
));
Das folgende Beispiel gibt nur fehlgeschlagene Aktualisierungen der letzten 24 Stunden zurück:
SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
REFRESH_START_TIMESTAMP => CURRENT_TIMESTAMP - INTERVAL '1 DAY',
ERROR_ONLY => TRUE
));
Das folgende Beispiel gibt Aktualisierungen für Online-Feature-Tabellen zurück, deren Namen mit feature_ beginnen, und begrenzt die Ergebnisse auf 50 Zeilen:
SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
NAME_PREFIX => 'feature_',
RESULT_LIMIT => 50
));