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 } ]
)
Copy

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_expr

Zeitraum (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 => integer

Eine 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

NAME

TEXT

Name der Online-Feature-Tabelle.

SCHEMA_NAME

TEXT

Name des Schemas, das die Online-Feature-Tabelle enthält.

DATABASE_NAME

TEXT

Name der Datenbank, die die Online-Feature-Tabelle enthält.

QUALIFIED_NAME

TEXT

Vollqualifizierter Name der Online-Feature-Tabelle.

STATE

TEXT

Status der Aktualisierung der Online-Feature-Tabelle. Folgende Status sind verfügbar:

  • EXECUTING: Aktualisierung ist in Ausführung.

  • SUCCEEDED: Aktualisierung erfolgreich abgeschlossen.

  • FAILED: Aktualisierung während der Ausführung fehlgeschlagen.

  • CANCELLED: Aktualisierung vor der Fertigstellung abgebrochen.

REFRESH_START_TIME

TIMESTAMP_LTZ

Zeitpunkt, zu dem der Aktualisierungsjob gestartet wurde.

REFRESH_END_TIME

TIMESTAMP_LTZ

Zeitpunkt, zu dem die Aktualisierung abgeschlossen wurde.

REFRESH_TRIGGER

TEXT

Eine der folgenden Optionen:

  • SCHEDULED: Normale Hintergrundaktualisierung, um die Zielverzögerung zu erreichen.

  • MANUAL: Benutzer/Aufgabe hat den Befehl ALTER ONLINE FEATURE TABLE <name> REFRESH ausgeführt.

  • CREATION: Aktualisierung, die während der Erstellungs-DDL-Anweisung ausgeführt wurde, ausgelöst durch die Erstellung der Online-Feature-Tabelle.

REFRESH_ACTION

TEXT

Eine der folgenden Optionen:

  • NO_DATA: Keine neuen Daten in Basistabellen. Gilt nicht für die erstmalige Aktualisierung von neu erstellten Online-Feature-Tabellen, unabhängig davon, ob die Basistabellen Daten enthalten oder nicht.

  • REINITIALIZE: Basistabelle wurde geändert.

  • FULL: Vollständige Aktualisierung, da der Aktualisierungsmodus der Online-Feature-Tabelle auf FULL festgelegt ist.

  • INCREMENTAL: Normale inkrementelle Aktualisierung.

QUERY_ID

TEXT

ID der SQL-Anweisung, die die Ergebnisse für die Online-Feature-Tabelle erzeugt hat.

STATE_CODE

TEXT

Code, der den aktuellen Status der Aktualisierung angibt.

STATE_MESSAGE

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());
Copy

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

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

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