Benutzerdefinierte Archivgruppen

Wie erstelle ich eine Benutzerdefinierte Archivgruppe

1. Überprüfen Sie, dass der Config-Eintrag useRDBArchive = 1 in der Config-Datei gesetzt ist. Benutzerdefinierte Archivgruppen können nur für die Archivierung in die Datenbank und nicht für die Verwendung von Value Archiven verwendet werden.

2. Überlegen Sie sich eine Datenpunktstruktur und erstellen Sie diese über das PARA-Modul. In diesem Beispiel wird der Datenpunkttyp "Test" erstellt. Die Datenpunkt-Struktur enthält einen Hauptknoten (RootNode) und zwei Elemente "Element1" und "Element2". Der Datenpunkt "ArchiveGroup_DP" wurde erstellt.

1. Erstellen Sie eine Vorlage. Öffnen Sie das RDB Dateiselektor-Panel (siehe unten) über System Management -> Datenbank -> RDB-Archivgruppen und klicken Sie auf Verwaltung Templates Schaltfläche.

Das Panel für die Erstellung von Vorlagen (Templates) wird geöffnet:

Erstellen Sie eine neue Vorlage über die Neue Vorlage Schaltfläche. Das Panel für die Erstellung von neuen Vorlagen (Templates) wird geöffnet. Selektieren Sie den Hauptknoten des Datenpunktes, der vorher erstellt wurde, über den Datenpunktselektor. Die Unterknoten werden in der Spalte Tabellenspalten und die Knotentypen in der Typ-Spalte angezeigt. Der Index macht Datenbank-Abfragen schneller. Klicken Sie auf Erstellen. In diesem Beispiel wird die Vorlage ARCHIVEGROUP_DP_ROOTN erstellt.

1. Öffnen Sie das Panel für die Erstellung einer neuen Archivgruppe über die Schaltfläche Neue Archivgruppe.

Das Panel für die Erstellung neuer Archivgruppen wird geöffnet.

Geben Sie den Gruppennamen an. Die Managernummer ist die Nummer des RDB Archivmanagers in der Konsole. Aktivieren Sie die Checkbox Benutzerdefinierte Archivgruppe (User Defined Archive Group) und selektieren Sie die erstellte Vorlage aus der Combobox. Klicken Sie auf OK. Die Archivgruppe "Group1" wird erstellt und wird im RDB Dateiselektor-Panel angezeigt. (siehe Abbildung oberhalb).

1. Öffnen Sie das PARA-Modul. Fügen Sie ein Archiv-Konfig zu dem Knoten des erstellten Datenpunktes "ArchiveGroup_DP". Selektieren Sie die erstellte Archivgruppe "Group1" aus der Combobox und aktivieren Sie die Checkbox "Originalwert speichern". Klicken Sie auf OK. Überprüfen Sie, dass der RDB Archivmanager mit der Nummer 99 in der Konsole läuft.

1. Eine Datenbank-Tabelle mit der gewünschten Struktur wird erstellt.

Die folgende Abbildung zeigt Ihnen die Werte von einzelnen Elementen (der group1.History-Ansicht) wenn der Config-Eintrag sendUDAGNullValues sowohl auf 0 als auch auf 1 gesetzt wurde.

Die Zeilen 3 und 4 zeigen eine Wertänderung wenn sendUDAGNullValues auf 0 gesetzt wurde (der Wert eines einzelnen Elements wurde geändert und der Wert von anderen Elementen wurde auf den Letztwert gesetzt). Die Zeile 5 wiederum zeigt eine Wertänderung eines einzelnen Elements wenn sendUDAGNullValues auf 1 gesetzt wurde. Der Wert des anderen Elements wurde auf 0 gesetzt.

Abfragen

main()
{
  dyn_dyn_anytype ret;
  DebugN(runRealSQLQuery("select
  el.element_name,h.element_id,h.ts, h.Element1, 
  h.Element2 from elements el, GROUP1HISTORY h where 
  el.element_id = h.element_id order by h.ts,h.element_id
  desc",ret));
  for (int i = 1; i <= dynlen(ret); i++)
  {
    string val = ret[i];
    DebugN(val);
  }
}

/*

Selektiert den Element-Namen, die Element-ID, den Zeitstempel sowie die Elemente "Element1" und "Element2" (Datenpunkt-Elemente die bei der Erstellung vom Template verwendet wurden. Siehe weiter oben), aus der Elements-Tabelle "el" und [archiveGroupName] h-Tabelle = "GROUP1HISTORY h" wo die Element-ID der Elements-Tabelle gleich wie die Element-ID der ArchiveGroupName-Tabelle ist. Sortiere nach Zeitstempel und Element-ID.

"GROUP1HISTORY" ist der Name der Benutzerdefinierten Archivgruppe, die vorher erstellt wurde.

In der Elements-Tabelle sind alle Datenpunktelemente des WinCC OA Projektes mit Zusatzinformationen enthalten. Eine genauere Beschreibung der Elements-Table finden Sie im Kapitel Beschreibung der Tabellen und Views)

ELEMENT_ID und TS (Zeitstempel) (welche Primärschlüssel sind) sowie SYS_ID 
(für Partitionierung) und BASE

letzter Wert (Bodensatz) vom zuvor ausgelagerten Zeitbereich. Zusätzlich gibt es die
Spalten:

ARCHIVE# = Die Nummer des Archivsatzes und

ROWID = Die Zeilen-ID.

Die Funktion runRealSQLQuery funktioniert wie dpGetPeriod. Der Vorteil ist, dass Sie kein Password eingeben müssen wie bei der Verwendung vom ADO */

Manuelle Bereinigung des RDB Schemas nach fehlgeschlagenem UDAG

1. Bei Erfolg wird 0 geliefert. Die Gruppe wurde erstellt und das erste Archiv in der Gruppe.

2. Das erste Archiv in der Gruppe bekommt die Default-Startzeit 1.1.1970.

3. Wenn die Gruppe nicht erstellt werden kann, wird -1 zurückgeliefert.

4. Wenn die Gruppe erstellt wurde, aber nicht das erste Archiv, wird -2 zurückgeliefert. Prüfen Sie in diesem Fall die Tabelle ARC_LOG. In der Tabelle ARC_LOG werden detailliertere Fehlermeldungen ausgegeben.

5. Wenn Sie die Gruppe löschen wollen, führen Sie die DB-Funktion "ArchiveControl.DeleteArcGroup" direkt aus der Datenbank durch.

6. Wenn die Erstellungsstartzeit des ersten Archivs nicht auf 1.1.1970 gesetzt wurde, wird -3 zurückgeliefert. Dies könnte später beim Eintragen oder Lesen der Werte Probleme verursachen. Prüfen Sie in diesem Fall die Tabelle ARC_LOG. In der Tabelle ARC_LOG werden detailliertere Fehlermeldungen ausgegeben.

7. Wenn das Archiv gelöscht werden sollte, löschen Sie es über die DB-Funktion ArchiveControl.DeleteArcGroupTable direkt aus der Datenbank.

8. Wenn eine ganze Gruppe gelöscht werden sollte, führen Sie ArchiveControl.DeleteArcGroup aus.

Speichern von Strings, die mehr als 4000 Zeichen enthalten in der Datenbank

• Es können Strings nur in Benutzerdefinierten Archivgruppen gespeichert werden.

• Es muss der Eintrag „maxStringUDAG“ in der Tabelle ARC_CONFIG gesetzt werden. Der Defaultwert ist 4000. Der Wert sollte ein Vielfaches von 4000 sein (8000, 20000, 32000, …).

• Die maximale String-Größe ist 64000 Zeichen.

• Bestehende UDAG-Tabellen können nicht konvertiert werden.

Um Strings zu parametrieren, öffnen Sie das Panel „RDB Erstellung und Parametrierung benutzerdefinierter Templates“ über das System Management-Panel->Datenbank->RDB Archive-Gruppen->Verwaltung Templates-Schaltfläche -> Neues Template-Schaltfläche).

Für jede DB-Tabellen-Spalte des Typs ‚STRING’ kann in der Spalte „LongString“ angegeben werden, ob es sich um einen erweiterten String handelt. In der Datenbank werden dann beispielsweise für „maxStringUDAG=12000“ folgende Spalten angelegt:

LONGTEXT Varchar2(4000), LONGTEXT_1 Varchar2(4000) und

LONGTEXT_2 Varchar2(4000)

Die Spaltenbezeichnung ist mit 27 Zeichen begrenzt. Beim Schreiben werden die „LongStrings“ auf 4000-Byte große aufgeteilt und in den entsprechenden Datenbankspalten gespeichert.

Da es keine RDB-Lesefunktion für UDAGs gibt, sind Sie selbst verantwortlich beim Lesen der „LongString“-Spalten die betroffenen Spalten auszulesen (z.B. Beispiel: „Select LONGTEXT || LONGTEXT_1 from UDAG where ….“).