Online- und Offline-Prüfungsdaten (Direktpersistenz)
Die Dienste und ihre Parameter in der Direktpersistenz-Implementierung unterscheiden sich von denen in der Datentabellen-Implementierung. In diesem Thema werden Online- und Offline-Prüfungsdaten, die Dienste, die Sie zum Extrahieren der Daten verwenden können, sowie die Parameter erläutert, die in der Direktpersistenz-Implementierung verwendet werden.
Online-Prüfungsdaten
Wenn die Direktpersistenz-Implementierung aktiv ist, werden die Online-Prüfungseinträge online basierend auf den Werten verwaltet, die für den Parameter DaysOnline des Prüfungsuntersystems angegeben wurden. Es werden Dienste bereitgestellt, um die Datenmenge im Online-Prüfungsdatenspeicher zu verwalten:
Archivierungs- und Aufräumoperationen werden durch die zugehörigen Scheduler-Dinge in ThingWorx Platform ausgelöst. Diese Scheduler-Dinge sind für den regelmäßigen Aufruf dieser Dienste verantwortlich. Sie können die Scheduler entsprechend den Anforderungen Ihrer Organisation konfigurieren. Standardmäßig werden diese Dienste täglich ausgeführt. Sie können sie bei Bedarf auch manuell aufrufen. Die Online-Prüfungsmeldungen werden in Dateien persistent gemacht, die im Verzeichnis AuditArchiveDirectPersistence des AuditArchiveFileRepository des Prüfungsuntersystems gespeichert werden. Sie können dieses Repository nicht konfigurieren.
 |
Im Kontext des Prüfungsuntersystems bedeutet "offline", dass die Prüfungsmeldungen nicht mehr gefiltert oder gesucht werden können und nicht mehr in der Online-Datenbank gespeichert sind.
|
Das Aufbewahrungskriterium für Online-Prüfungsdaten ist die Anzahl der Tage zur Online-Aufbewahrung von Prüfungsdaten, die im entsprechenden Konfigurationsparameter für das Prüfungsuntersystem festgelegt ist. Der Dienst ArchiveAuditHistoryDirectPersistence löscht keine Daten, die diesem Aufbewahrungskriterium entsprechen. Stattdessen kann ein separater PurgeAuditData-Dienst nach einem Zeitplan oder manuell ausgeführt werden, um Online-Prüfungsdaten zu löschen, wenn das Kriterium erfüllt ist.
Informationen zum Durchsuchen von Online-Prüfungsdaten mithilfe des Diensts QueryAuditHistoryWithQueryCriteria finden Sie unter
Offline-Prüfdaten
Offline-Prüfdaten sind ein Speicherort für Prüfdaten, auf die Sie nicht häufig zugreifen müssen, aber die Sie zu administrativen Zwecken speichern möchten. Der Dienst ArchiveAuditHistoryDirectPersistence kopiert Online-Prüfungsdaten in Offline-Speicher. Mit den folgenden Diensten können Administratoren die Offline-Daten verwalten:
Der Dienst ExportAuditData ruft den Dienst ArchiveAuditHistoryDirectPersistence auf, der die angeforderten Online-Prüfungsdaten aus dem AuditArchiveFileRepository in die angegebene Exportdatei kopiert. Die Exportoperation verarbeitet und übersetzt die archivierten Daten und speichert sie in der angegebenen Exportdatei.
Der Dienst CleanUpOfflineAudit wird in der Regel basierend auf einem Scheduler ausgeführt. Er kann auch manuell ausgeführt werden. Sie übergeben dem Dienst ein olderThanDate, um die archivierten Dateien anzugeben, die aus dem AuditArchiveFileRepository gelöscht werden sollen.
Offline-Dateien werden ohne Lokalisierung archiviert. Ein Offline-Reader-Dienst namens ExportAuditData ist verfügbar, um sie basierend auf einem bestimmten Gebietsschema abzurufen. Weitere Informationen finden Sie unter Prüfungsdaten exportieren.
Das folgende Diagramm zeigt die Hierarchie von Offline-Archivdateien. Im Absatz unter dem Diagramm wird der Knoten direkt unterhalb des Datei-Repository erläutert: "OfflineAudit-Ordner für aktive Implementierung".
Hierarchie von Offline-Archiv
Im vorstehenden Diagramm stellt der Knoten "OfflineAudit-Ordner für aktive Implementierung" das Hauptverzeichnis im Repository für die aktive Implementierung dar (Direktpersistenz und/oder Datentabelle). Wenn Sie mit der Datentabellen-Implementierung begonnen haben und später zur Direktpersistenz-Implementierung gewechselt sind, gibt es hier zwei Verzeichnisse, AuditArchive für die Datentabellen-Implementierung und AuditArchiveDirectPersistence für die Direktpersistenz-Implementierung. Beide Verzeichnisse haben dieselbe Unterverzeichnisstruktur wie oben dargestellt. Archivierte Prüfungsdaten werden beibehalten, wenn Sie von einer Implementierung zur anderen wechseln.
 | Wenn Sie von einer Implementierung zur anderen wechseln möchten, stellen Sie sicher, dass Sie vor dem Wechsel alle Prüfungsdaten archiviert haben, die Sie beibehalten müssen. |
Die Datumsordner beziehen sich auf das Datum der enthaltenen Prüfungsmeldungen, nicht auf das Datum, an dem das Archiv ausgeführt wurde. Wie im vorstehenden Diagramm dargestellt, ist das Format des Datumsordnernamens YYYY-MM-DD (ISO 8601) mit einem neuen Ordner für jeden Tag mit Prüfmeldungen. Die "Offline-Prüfsegmente" befinden sich in einer gezippten JSON-Datei, die Prüfmeldungen für dieses Datum enthält. Segmente haben eine Standardgröße von 50.000 Zeilen. Beachten Sie, dass die Mindestgröße 10.000 Zeilen beträgt. Ein Systemadministrator kann die Standardgröße von Segmenten in der Konfiguration des Prüfungsuntersystems ändern. Beispielsweise kann der Systemadministrator eine Segmentgröße von 70.000 Zeilen angeben. Eine gezippte Segmentdatei ist für die entsprechende Anzahl von Zeilen mit Meldungen im Datumsordner vorhanden. Wenn jeder Prüfeintrag ca. 1 KB aufweist, würde die Größe einer Segmentdatei bei ca. 70 MB liegen (ungezippt oder im Arbeitsspeicher).
Datenaufbewahrung und Leistung
Um die Leistung zu maximieren, ist eine Kombination aus Online-Prüfdaten und Offline-Datenspeicher erforderlich. Das Prüfungsuntersystem bietet Archivierungs- und Aufräumoperationen, damit Sie das optimale Gleichgewicht für Ihr System erreichen können. Während die Archivierungsoperation den Parameter DaysOnline des Untersystems nicht überprüft, überprüft der Dienst PurgeAuditData ihn.
Wenn der zugehörige Scheduler den Dienst ArchiveAuditHistoryDirectPersistence aufruft, wird das aktuelle Datum als olderThanDate übergeben. Alle Online-Prüfungsmeldungen, die älter als dieses Datum sind, werden archiviert. Dieser Dienst überprüft nicht den Parameter DaysOnline des Prüfungsuntersystems.
Der Dienst PurgeAuditData überprüft den Wert des Parameters DaysOnline des Prüfungsuntersystems, um zu ermitteln, welche Online-Prüfungsmeldungen aufgeräumt werden und welche online verfügbar bleiben sollen. Vor dem Löschen von Prüfungsmeldungen überprüft dieser Dienst, ob Online-Prüfungsmeldungen zum Löschen markiert sind, die nicht archiviert wurden. Wenn dies der Fall ist, ruft dieser Dienst den Dienst ArchiveAuditHistoryDirectPersistence auf. Diese Aktionen stellen sicher, dass alle zu löschenden Daten vor dem Löschen archiviert werden.
| | Wenn der Wert von DaysOnline gleich 0 ist und der Aufräumdienst aufgerufen wird, werden alle Daten in das Offline-Repository verschoben und anschließend aus dem Online-Repository gelöscht. |
Online- und Offline-Prüfungsdaten exportieren
Ab ThingWorx Platform Version 9.0.0 verfügt das Prüfungsuntersystem über zwei Exportdienste, einen nur für Online-Prüfungsdaten und einen für Online- und Offline-Prüfungsdaten. Unter Online-Prüfungsdaten exportieren und Prüfungsdaten exportieren finden Sie Informationen zur Verwendung dieser Dienste zum Exportieren von Prüfungsdaten.