ODBC SimApi
„
Technische Daten
- Produkt: ODBC SimApi
- Hersteller: Sartorius Stedim Data Analytics
- Konnektivität: ODBC (Open Database Connectivity)
- Kompatibilität: Funktioniert mit Umetrics Suite und externen Daten
Quellen
Anweisungen zur Produktverwendung
Voraussetzungen
Stellen Sie vor der Verwendung der ODBC SimApi Folgendes sicher:
- Eine strukturierte ODBC-Datenquelle wie eine relationale
Datenbank - Die Datenquelle sollte sich wie ein guter Prozessdatenhistoriker verhalten
- Stellen Sie sicher, dass es in der Datenquelle zu keinen Verzögerungen bei der Datenerfassung kommt
- Die Daten in der Quelle sollten den aktuellen Stand der
Verfahren - Die Datenquelle muss schnell auf Anfragen in Echtzeit reagieren
Überwachung
Installation und Setup
- Installieren Sie die ODBC SimApi-Software auf Ihrem System.
- Konfigurieren Sie die ODBC-Datenquelle für die Verbindung mit dem gewünschten
Datenbank. - Detaillierte Installationsanweisungen finden Sie im Benutzerhandbuch.
von Ihrer Softwarenutzung.
Häufig gestellte Fragen (FAQ)
F: Was ist eine SimApi?
A: Eine SimApi ist die Verbindung zwischen der Umetrics Suite und
externe Datenquellen, insbesondere die Verbindung zu ODBC-Datenquellen
wie relationale Datenbanken.
F: Wie kann ich die Funktion zur synthetischen Prozess-Batch-ID verwenden?
A: Um die Funktion für die synthetische Prozess-Batch-ID zu verwenden, konfigurieren Sie die
Chargenkennung tag als Batch-ID des Batch-Knotens auf dem
Seite mit den Ausführungsbedingungen in SIMCA-online.
F: Kann die ODBC SimApi mit gleichzeitigen Batches verwendet werden?
A: Die Funktion zur synthetischen Prozess-Batch-ID funktioniert nicht mit
gleichzeitige Batches. Im Batch sollte nur ein Batch aktiv sein
Knoten zu einem beliebigen Zeitpunkt.
„`
Fehler! Verwenden Sie die Registerkarte Start, um Headline_1 (Überschriften) auf den Text anzuwenden, der hier erscheinen soll.
ODBC SimApi Benutzerhandbuch
24. Oktober 2024
Einführung
Inhalt
1 Einleitung………………………………………………………………………………………………………….. 3
1.1 Funktionen …………………………………………………………………………………………………………………………………………………………………………………………….. 3 1.1.1 Synthetische Prozess-Batch-ID ………………………………………………………………………………………………………………………………. 4 1.1.2 Generierte synthetische Prozess-Batch-ID tags; eine pro eindeutiger Unit-ID …………………………………………….. 4 1.1.3 Batch-Knoten mit Filterunterstützung ………………………………………………………………………………………………………………………….. 4 1.1.4 Batch-Daten Views……………………………………………………………………………………………………………………………………………………………… 5 1.1.5 Diskrete Daten………………………………………………………………………………………………………………………………………………… 6 1.1.6 Gleichzeitiger SimApi-Zugriff……………………………………………………………………………………………………………………………. 7
2 Voraussetzungen ………………………………………………………………………………………………………… 7
2.1 Anforderungen an die Datenbankstruktur ………………………………………………………………………………………………………………………… 7 2.2 Überlegungen zur Datenbankleistung ………………………………………………………………………………………………………………………………. 7 2.3 Überlegungen zum Netzwerkbetrieb ……………………………………………………………………………………………………………………………………………. 8 2.4 ODBC-Treiber ………………………………………………………………………………………………………………………………………………………………………………………….. 8 2.5 Datenbankauthentifizierung ………………………………………………………………………………………………………………………………………………………………… 8 2.6 Visual C++ Redistributable …………………………………………………………………………………………………………………………………………………….. 8
3 Installation und Einrichtung …………………………………………………………………………………………………….. 9
3.1 Konfigurieren einer ODBC-Datenquellenverbindung in Windows zur Verwendung durch die SimApi …………………………… 9 3.2 Auswählen zwischen zwei Möglichkeiten zum Zugriff auf Prozessdaten……………………………………………………………………………………… 10 3.3 XML-Konfiguration file und log file Standorte……………………………………………………………………………………………………………….. 11 3.4 Globale Verbindungseinstellungen ……………………………………………………………………………………………………………………………………. 11 3.5 Direktmodus für kontinuierliche/Prozess views …………………………………………………………………………………………………………………. 11 3.6 Nachschlagen View Modus für kontinuierlich/Prozess views…………………………………………………………………………………………………….. 12
3.6.1 PDB views und HDB views …………………………………………………………………………………………………………………………………….. 13 3.7 Batch-Knoten…………………………………………………………………………………………………………………………………………………………………………….. 14 3.8 Batch-Daten Views …………………………………………………………………………………………………………………………………………………………………. 15
3.8.1 Synthetische Batch-Dateninstanz tags …………………………………………………………………………………………………………………….. 16 3.8.2 Batch-ID des Syntheseprozesses tags gefiltert nach Spaltenwerten……………………………………………………………………….. 16 3.9 Diskrete Knoten ……………………………………………………………………………………………………………………………………………………………………………… 16 3.9.1 Diskrete Tag Definition View………………………………………………………………………………………………………………………………. 17 3.9.2 Diskrete Daten aus Sicht von SIMCA-online ………………………………………………………………………………………………. 18 3.10 Einige Hinweise zum Rückschreiben von SIMCA-online ………………………………………………………………………………………………………… 18 3.11 XML-Konfiguration File ………………………………………………………………………………………………………………………………… ……… 19
4 Unterstützung ………………………………………………………………………………………………………………………..22
Einführung
1 Einleitung
Dieses Dokument ist das Benutzerhandbuch für die ODBC SimApi von Sartorius Stedim Data Analytics.
Eine SimApi ist die Verbindung zwischen der Umetrics Suite und externen Datenquellen.
Diese SimApi stellt eine Verbindung zu einer ODBC-Datenquelle (Open Database Connectivity) wie einer relationalen Datenbank her. Die Datenquelle muss wie in diesem Dokument beschrieben strukturiert sein.
Um eine SimApi in SIMCA-online zu verwenden, die zur Echtzeitüberwachung verwendet wird, ist es wichtig, dass sich die Datenquelle wie ein guter Prozessdaten-Historiker verhält: Es darf keine Verzögerungen bei der Datenerfassung in der Datenquelle geben: Die aktuellen Daten in der Datenquelle sollten den aktuellen Status des Prozesses widerspiegeln, um in SIMCA-online gut zu funktionieren. Die Datenquelle muss auch schnell auf Datenanfragen reagieren, damit der Server mit der Echtzeitausführung von Projekten Schritt halten kann.
Eine detaillierte Liste der Änderungen in verschiedenen Versionen dieser SimApi finden Sie in der Datei Version Info.txt. file das mit der Installation einhergeht.
Diese SimApi kann von SIMCA oder SIMCA-online oder anderer Software verwendet werden, die SimApis verwenden kann.
Weitere Informationen zu verfügbaren SimApis finden Sie unter sartorius.com/umetrics-simapi.
1.1 Funktionen
· Unterstützt SQL-Dialekte für Microsoft SQL Server, Oracle, Microsoft Access, IBM db2, Denodo, MySQL, PostgreSQL und Standard-SQL.
· ODBC-Verbindungszeichenfolgenauthentifizierung mit einem bereitgestellten Benutzernamen und Kennwort, Windows-Authentifizierung oder den in der ODBC-Verbindung in Windows ODBC-Datenquellen angegebenen Anmeldeinformationen.
· Zugriff auf mehrere Tabellen oder views zum Lesen kontinuierlicher Prozessdaten (aktuell und historisch). Zwei Modi; Lookup view Modus und Direktmodus (direktes Lesen aus einer Datenbank view).
· Mehrere Batchknoten, die die Lebensdauer von Batches definieren. Enthält eine einzelne Zeile für jeden Batch mit Start- und Endzeiten.
· Lesen von Batch-Daten (Batch-Bedingungen) aus zusätzlichen Spalten in Batch-Knoten oder aus Batch-Daten Views, die Batch-Bedingungen in einer schmalen Tabelle mit nur zwei Spalten speichern (tag Name und Wert).
· Unterstützung diskreter Daten: Lesen diskreter Daten von einem oder mehreren Knoten, die unterschiedliche Spaltennamen haben können. · Zurückschreiben von SIMCA-online: historische Prozessdaten und Batchdaten. · Funktioniert mit numerischen Daten oder Textdaten (qualitativen Daten). · Synthetische Prozess-Batch-ID im Batchknoten, die bei der Phasenausführung von SIMCA-online verwendet werden kann
Bedingungen, wenn die Prozessdaten keine Batch-ID haben tag. · Synthetischer Prozess Batch-ID tags in Batchdaten Views, die nach anderen Spalten gefiltert werden können. Kann verwendet werden
in Phasenbedingungen, wenn die Batch-ID sonst nicht in den Prozessdaten verfügbar ist. · Batch-Knoten mit Filterunterstützung. Filterunterstützung ist nützlich, wenn Sie einen Batch-Knoten mit einem Master haben
Liste der Chargen für Ihr gesamtes System, möchten diese aber filtern können, um nur Chargen in einem Teil des Systems anzuzeigen (z. B. Chargen, die in einer einzelnen Einheit ausgeführt werden, oder eine Charge aus einem bestimmten Material oder Typ). · Synthetische Chargendateninstanz tags mehrere Messungen von Batch-Daten pro Batch verarbeiten. Nützlich, wenn Sie Batch-Level-Modelle erstellen möchten, die zwei oder mehr Messungen jeder Batch-Bedingungsvariable pro Batch verwenden. · Mehrere Instanzen der ODBC SimApi können vom selben SIMCA-Online-Server aus konfiguriert und verwendet werden. Dadurch können Sie eine Verbindung zu mehreren Datenbanken auf einem oder mehreren Datenbankservern herstellen. · Verbindungsstabilität: Die SimApi stellt automatisch die Verbindung zu einer Datenquelle wieder her, nachdem die Verbindung getrennt wurde (z. B.ampDatei nach einem Netzwerkfehler). · Threadsicherer gleichzeitiger Zugriff. Die SimApi arbeitet mit der Funktion für gleichzeitigen SimApi-Zugriff, die mit dem SIMCA-online 18-Server eingeführt wurde und die Leistung und Reaktionsfähigkeit verbessern kann. · Unterstützt in der Datenbank als Ortszeit oder UTC gespeicherte Daten.
Jede Funktion (kontinuierlich, Batch oder diskret) kann einzeln konfiguriert und verwendet werden, und alle Funktionen sind optional. Sie müssen Funktionen nur konfigurieren, wenn Sie sie benötigen.
Einführung
1.1.1 Batch-ID des synthetischen Prozesses
In einem Batch-Projekt müssen die Prozessdaten eine Batch-ID haben tag (Spalte), die auf der Seite Ausführungsbedingungen in der Projektkonfiguration in SIMCA-online angegeben ist. Diese tag wird mit dem Batch-Knoten abgeglichen, um zu wissen, ob eine Phase ausgeführt werden soll.
Wenn die Prozessdaten keine Batch-ID haben tagkann die ODBC SimApi-Funktion „Synthetische Prozess-Batch-ID“ verwendet werden. Sie generiert die Prozessdaten-Batch-ID unter Verwendung von Daten aus dem Batch-Knoten.
Um diese Funktion zu nutzen, gehen Sie zur Seite Ausführungsbedingungen und konfigurieren Sie die Batch-ID tag als Batch-ID des Batch-Knotens. Immer wenn der Server die Batch-ID für die Prozessdaten liest, wird die synthetische Batch-ID vom Batch-Knoten zurückgegeben, um sicherzustellen, dass die Einheit ausgeführt wird.
Beachten Sie, dass diese Funktion nicht mit gleichzeitigen (parallelen) Batches funktioniert. Daher darf zu jedem Zeitpunkt nur ein Batch im Batchknoten aktiv sein.
1.1.2 Generierte synthetische Prozess-Batch-ID tags; eine pro eindeutiger Einheiten-ID
Diese Funktion baut auf der oben beschriebenen synthetischen Prozess-Batch-ID auf, verwendet jedoch eine zusätzliche Spalte im Batch-Knoten, die die UnitID enthält. Der Batch-Knoten ist in Batch-Klassen segmentiert, die denselben Wert in der UnitID-Spalte aufweisen. Dies wirkt wie für Batches im Batch-Knoten, die einen bestimmten Wert für die UnitID haben.
Für jeden eindeutigen Wert in der UnitID-Spalte (bei Betrachtung des gesamten Batch-Knotens) erstellt die SimApi eine synthetische tag im Batch-Knoten mit dem Namen BatchID_Unit_[Value].
Zum Beispielample: Wenn die Werte 1 und 2 die beiden eindeutigen Werte in der Spalte UnitID sind, werden zwei synthetische tags; BatchID_Unit_1 und BatchID_Unit_2. Lesen von Prozessdaten aus der synthetischen Batch-ID tag BatchID_Unit_1 gibt nur Batch-IDs für Batches zurück, deren UnitID-Spalte den Wert 1 hat. Batches mit 2 in der UnitID-Spalte werden ignoriert.
Um dies zu nutzen, konfigurieren Sie die Batch-Kennung tag auf der Seite „Ausführungsbedingungen“ für jede Einheit, um den synthetischen Wert BatchID_Unit_[Value] zu verwenden. tags.
Der Name der Unit-ID-Spalte wird in der XML-Datei konfiguriert. file.
Einschränkungen
· Was die oben beschriebene reguläre synthetische Batch-ID betrifft, funktioniert dies im weiteren Sinne nicht mit gleichzeitigen (parallelen) Batches, die den gleichen UnitID-Wert haben (gleichzeitige Batches mit unterschiedlichen UnitIDs funktionieren einwandfrei).
· Alle Unit-IDs müssen im Batch-Knoten angegeben werden, bevor die SimApi gestartet wird (die synthetische tags werden beim Start erstellt). Tipp: Sie können eine Tabelle mit einem Dummy-Batch im Batch-Knoten für jede erforderliche Unit-ID vorab auffüllen.
· Batch-IDs müssen im Batch-Knoten eindeutig sein und es kann nur eine Zeile für jede Batch-ID geben. Daher kann jeder Batch nur einen UnitID-Wert haben.
· Der Wert der UnitID darf sich für eine bestimmte Charge während ihrer Lebensdauer nicht ändern.
Hinweis: Eine Alternative zur Verwendung einer synthetischen Prozess-Batch-ID, die auf diese Weise nach UnitID gefiltert wird, besteht darin, mehrere Batch-Knoten zu verwenden; einen für jeden eindeutigen Wert von UnitID. Bei mehreren Batch-Knoten kann dieselbe Batch-ID natürlich in vielen Batch-Knoten vorhanden sein (anders als bei Verwendung des UnitID-Filters), sodass in einigen Fällen mehrere Batch-Knoten die bevorzugte Lösung sind.
1.1.3 Batch-Knoten mit Filterunterstützung
Zum Ausführen von Batch-Projekten wird in SIMCA-online ein Batch-Knoten benötigt.
Das Filtern ist nützlich, wenn Sie über einen Batch-Knoten mit einer Hauptliste von Batches für Ihr gesamtes System verfügen, diese aber so filtern möchten, dass nur Batches in einem Teil des Systems angezeigt werden (z. B. Batches, die in einer einzelnen Einheit ausgeführt werden, oder Produkte aus einem bestimmten Material oder Typ).
Einführung
Die Filterung ist optional. Um sie zu verwenden, müssen Sie die zu filternde Spalte und eine Liste gültiger Werte für diese Spalte angeben. Für jeden konfigurierten Wert wird von der SimApi ein separater Knoten erstellt, der nur Stapel mit diesem Wert in der Filterspalte enthält.
Hier ist ein Example einer Charge view, in der Datenbank BatchNode genannt, mit einer Unit-Spalte, die zum Filtern von Batches verwendet werden kann.
BatchID Startzeit
Stoppzeit
Einheit (Filterspalte) Batchbedingungsvariable 1
Batch1 2017-01-01 01:00 2017-01-01 11:00 A
34
Batch2 2017-01-02 02:00 2017-01-02 12:00 B
4
Batch3 2017-01-03 03:00 2017-01-01 13:00 A
12
Batch4 2017-01-04 04:00 2017-01-04 14:00 A
4
Batch5 2017-01-05 05:00 2017-01-05 15:00 B
5
Konfiguriert für Einheit A und B würde dies zwei Batch-Knoten mit den Namen BatchNode_A und BatchNode_B ergeben. Jeder dieser Batch-Knoten würde nur Batches zurückgeben, die ihrem Filterwert entsprechen, also würden für BatchNode_A Batch1, Batch3 und Batch4 zurückgegeben und für BatchNode_B Batch2 und Batch5. Die letzte Spalte ist ein BeispielampDatei einer Batch-Bedingungsvariablen, die in diesem Batch-Knoten zum Lesen von Daten auf Batch-Ebene verfügbar sein wird.
Für auf diese Weise konfigurierte Batchknoten werden synthetische Prozess-Batch-IDs unterstützt.
1.1.4 Chargendaten Views
Ein Batch-Daten view ist eine Datenbank view oder Tabelle zum Speichern von Werten für Batch-Bedingungen. Sie sollte drei Spalten haben: Batch-ID, Tag Name und Wert. Eine Zeile in diesem view speichert einen Wert für eine bestimmte tag und Batch. Es wird viele Zeilen in diesem view für jeden Stapel, wenn viele Stapelbedingungsvariablen vorhanden sind.
Hier ist ein ExampDatei einer Batch-Datei view in der Datenbank mit ihren drei Spalten:
Batch-ID
Tag Name
Wert
Stapel7
Ertrag
0.95
Stapel7
Produktqualität
Exzellent
Stapel8
Ertrag
0.90
Stapel8
Produktqualität
Arm
Diese Batchdaten view wird durch die SimApi als zwei tags Ertrag und Produktqualität. Ablesewerte für diese tags für Batch8 ergäben sich die Werte 0.90 bzw. „Schlecht“.
Hinweis: Wenn mehrere Zeilen für die gleiche BatchID vorhanden sind und Tag Namenskombination in der Datenbank view, die SimApi gibt den Wert aus der letzten dieser Zeilen zurück.
In den Batchdaten sind keine Spalten für Batchstart- oder Batchendzeiten vorhanden. views, daher können sie nicht als Batch-Knoten verwendet werden.
Sie können viele verschiedene Batch-Daten konfigurieren views.
Tipp: Alternativ zu Batch Data Views können Batch-Bedingungsdaten auch in einem Batch-Knoten gespeichert werden. In diesem Fall wird für jede Batch-Bedingungsvariable eine Spalte benötigt. Somit gibt es in Batch-Knoten nur eine Zeile für jeden Batch, es werden jedoch mehr Spalten benötigt.
Einführung
Wichtig für die Extraktionsfunktion von SIMCA-online: Um Daten aus einer Batch-Datendatei zu extrahieren view Sie müssen auch eine tag (wie etwa die Batch-Kennung tag) von einem Batch-Knoten, damit SIMCA-online die Batches kennt, für die Daten extrahiert werden sollen.
1.1.4.1 Synthetische Batch-Dateninstanz tags Batchdaten bestehen immer aus einer einzelnen Beobachtung pro Batch1.
Was aber, wenn die Werte einer Batch-Daten tag kann sich ändern (z.B.ample, weil Sie einige Messungen erneut ausführen) und wenn Sie mehrere Messungen pro Stapel in einem SIMCA-Online-Modell auf Stapelebene verwenden möchten?
Dann können Sie die optionale Funktion synthetische Batch-Dateninstanz verwenden tags. Diese sind tags die als zusätzliche tags in den Batchdaten view, die jeweils einer bestimmten Instanz der Batchdaten für den tag.
Hier ist ein Exampauf:
Batch-ID
Zeitspalte
Tag Name
Wert
Stapel7
2015-06-23 09:00 Yield
0.90
Stapel7
2015-06-23 17:00 Yield
0.99
Die SimApi stellt dann diese Batch-Daten bereit view mit zwei tags; Yield_1 und Yield_2. Beim Lesen der Daten für die Charge Batch7 ergeben sich die Werte 0.90 für Yield_1 und 0.99 für Yield_2.
Beachten Sie, dass in diesem Beispiel eine neue TimeColumn hinzugefügt wurdeample, mit einer Zeitamp für jede Zeile. Diese Spalte wird für die synthetische Batchdateninstanz benötigt tag Funktion, damit die SimApi weiß, wie die Werte für die tags in die Instanz tags.
1.1.4.2 Batch-ID des synthetischen Prozesses tags gefiltert nach Spaltenwerten Diese Funktion ist wie die Generierte synthetische Prozess-Batch-ID tags; eine pro eindeutiger Unit-ID mit dem Unterschied, dass diese aus einer Batch-Datenquelle gelesen wird view und die Batch-ID kann nach mehreren Spalten gefiltert werden.
Hier ist ein Exampauf:
Batch-ID
Zeitspalte
Tag Name Wert
Einheit
Linie
Stapel7
2015-06-23 09:00 Yield
0.90
A
1
Stapel8
2015-06-23 09:00 Yield
0.95
B
2
Wenn wir die BatchID nach den Spalten Unit und Line filtern, erhalten wir eine synthetische Batch-ID tag für jede eindeutige Kombination der Werte aus den Spalten Einheit und Linie.
Synthetik tags Erstellt würde: BatchID_A_1, BatchID_B_2
Wenn man BatchID_A_1 für die Zeit in der Tabelle liest, erhält man daher den Wert Batch7, während BatchID_B_2 für die gleiche Zeit den Wert Batch8 ergibt.
Beachten Sie, dass eine Zeitspalte mit einem timestamp Für diese Funktion ist für jede Zeile ein Wert erforderlich.
1.1.5 Diskrete Daten
Diskrete Daten sind selten gemessene Daten, die zwischen den Messungen keine logischen Werte aufweisen. Normalerweise, wieampDie Probe wird in halbregelmäßigen Abständen (z. B. einmal täglich) für jede Charge entnommen. DiesampDie Datei wird dann an ein Labor gesendet, das eine Analyse durchführt.ample und zu einem späteren Zeitpunkttage kehrte mit einem Bericht über die sampDatei für die benötigten Variablen. Diese wird dann in der Datenbank in die diskrete Datentabelle eingetragen.
Weitere Informationen hierzu finden Sie im SimApi-Handbuch und im technischen Handbuch zu SIMCA-Online.
1 Weitere Informationen zu den verschiedenen Datenabrufmodi, darunter auch Batch-Daten, finden Sie im SimApi Guide.pdf.
Voraussetzungen
1.1.5.1 Synthetisches Chargenalter tags für diskrete Datenknoten Für diskrete Datenknoten gibt es vier synthetische tags mit den Namen $BatchAge(d), $BatchAge(h), $BatchAge(m), $BatchAge(s). Beim Lesen ihrer Werte werden sie das Batchalter als Gleitkommazahl für jedes s sein.ample in vier verschiedenen Größenordnungen: Tage, Stunden, Minuten und Sekunden. Diese tags kann als Reifegrad im SIMCA-Modell verwendet werden, wodurch die Notwendigkeit reduziert wird, solche tags zu den diskreten Datentabellen.
1.1.6 Gleichzeitiger SimApi-Zugriff
Der gleichzeitige SimApi-Zugriff ist eine optionale Funktion, die mit dem SIMCA-online 18-Server eingeführt wurde und die Leistung und Reaktionsfähigkeit eines Servers und von Clients verbessern kann.
Die ODBC SimApi ist threadsicher und verwendet einen Pool von Verbindungen zum Server. Die Größe des Pools kann über die Einstellung DatabaseConnectionPoolSize in der Konfiguration konfiguriert werden. file (Standardwert: 10). Dies steuert, wie viele gleichzeitige Anfragen an die Datenbank zulässig sind. Zusätzliche gleichzeitige Anfragen werden in die Warteschlange gestellt und ausgeführt, wenn frühere Anfragen abgeschlossen sind.
Verschiedene Datenbankmodule und Datenbankserver unterstützen möglicherweise eine unterschiedliche Anzahl gleichzeitiger Threads. Für eine optimale Leistung muss die Größe des Verbindungspools möglicherweise angepasst werden.
Weitere Überlegungen und Informationen zur Aktivierung finden Sie in der SIMCA-Onlinehilfe zum gleichzeitigen SimApi-Zugriff.
2 Voraussetzungen
Damit diese SimApi funktioniert, müssen sowohl an den PC, auf dem die SimApi läuft, als auch an die Datenquelle selbst bestimmte Anforderungen in Bezug auf Datenbankstruktur und Leistung erfüllt sein.
2.1 Anforderungen an die Datenbankstruktur
Eine Datenbank kann natürlich fast alle Daten mit beliebiger Struktur enthalten. Die ODBC SimApi dient zum Abrufen von Prozessdaten zur Verwendung in SIMCA-online und SIMCA.
Damit SimApi funktioniert, muss die Datenbank eine bestimmte Struktur oder ein bestimmtes Design aufweisen, wie unten beschrieben.
Hier sind die allgemeinen Anforderungen:
· Alle verwendeten Tabellen haben einen eindeutigen Primärschlüssel. · Die meisten Tabellen in der Datenbank erfordern Datums-/Zeitspalten, damit die SimApi den Zeitpunkt identifizieren kann.amp
für jede Datenzeile. Diese Spalte sollte in der Datenbank indiziert werden, damit die Leistung nicht darunter leidet. · Die SimApi unterstützt zwei Datentypen für Datenspalten: entweder numerische Realwerte (ein Float oder andere
numerischer Datentyp) oder Textzeichenfolgen (z. B.ample varchar in der Datenbank). Fehlende Werte (Nullwerte) sind auch für Datenspalten zulässig. · Der Begriff view und Tabelle werden in diesem Dokument synonym verwendet und bedeuten dasselbe. · Wenn Sie eine view in der Datenquelle und möchten diese in der SimApi verwenden, achten Sie darauf, keine Leistungsprobleme einzuführen: die view muss schnell von der SimApi abgerufen werden können. Das bedeutet, dass Sie normalerweise keine komplexen view das Daten aus vielen anderen Tabellen aggregiert und eine komplizierte Geschäftslogik ausführt, um die Ergebnisse zu berechnen. Ein solches view erfüllt nicht die Leistungsanforderungen der Benutzer der SimApi, wie z. B. SIMCA-online, das zur Echtzeitüberwachung eines Prozesses verwendet wird.
Die SimApi verfügt über viele Funktionen und für jede Funktion sind verschiedene erforderliche Einstellungen erforderlich, die wie in Kapitel 3 beschrieben vorgenommen werden müssen.
2.2 Überlegungen zur Datenbankleistung
Um eine SimApi in SIMCA-online zu verwenden, die zur Echtzeitüberwachung genutzt wird, ist es wichtig, dass sich die Datenquelle wie ein guter Prozessdatenhistoriker verhält.
· Es dürfen keine Verzögerungen bei der Datenerfassung in der Datenquelle auftreten: Die aktuellen Daten in der Datenquelle sollten den aktuellen Status des Prozesses widerspiegeln, damit SIMCA-online gut funktioniert.
Voraussetzungen
· Die Datenquelle muss außerdem schnell auf Datenanforderungen reagieren, damit der Server mit der Echtzeitausführung von Projekten Schritt halten kann.
Dies hat mehrere Auswirkungen:
· Data Warehouses oder Datenbanken, die Datenaggregation durchführen, funktionieren bei der Echtzeit-Projektausführung möglicherweise nicht gut mit SIMCA-online, da es zu Verzögerungen bei der Datenerfassung kommen kann.
· Datenbank views, die komplizierte und zeitaufwändige Abfragen durchführen, sind möglicherweise zu langsam für die Verwendung in SIMCA-online.
2.3 Netzwerküberlegungen
Sie sollten den SIMCA-online-Server in der Nähe der Datenquelle im Netzwerk platzieren. Dies gewährleistet eine schnelle Verbindung zwischen SIMCA-online und seiner Datenquelle. Netzwerkgeräte wie Firewalls können die Verbindung zwischen SIMCA-online und der Datenquelle stören. In diesem Fall müssen möglicherweise die Firewall-Regeln geändert werden. Überprüfen Sie die Konnektivität vom PC, auf dem die SimApi läuft, zur Datenquelle, z. B. mithilfe vonampKlicken Sie in ODBC-Datenquellen auf die Schaltfläche „Verbindung testen“.
2.4 ODBC-Treiber
Die SimApi erfordert, dass auf dem PC, auf dem die SimApi installiert ist, ODBC-Treiber für Ihre Datenquelle installiert werden. ODBC-Treiber erhalten Sie vom Hersteller der Datenbank. Laden Sie die neueste verfügbare Version herunter und installieren Sie sie. Treiber für Microsoft SQL Server sind auf den meisten Windows-Computern häufig bereits installiert. Sie benötigen die Treiber, die zur Plattform der SimApi passen. Normalerweise bedeutet dies 64-Bit-x64-Treiber, die mit 64-Bit-Windows und SIMCA und SIMCA-online verwendet werden können. Für alte 32-Bit-SIMCA-Versionen werden die 32-Bit-ODBC-Treiber benötigt.
2.5 Datenbankauthentifizierung
Datenbanken erfordern eine Authentifizierung, damit die SimApi auf Daten zugreifen kann, sodass nur auf die Daten zugegriffen werden kann, die die SimApi benötigt. Datenbankadministratoren beschränken den Zugriff auf die Datenbank auf einen bestimmten Benutzer, der von der SimApi verwendet wird. Die Benutzerauthentifizierung kann mit der ODBC-SimApi auf eine der drei Arten erfolgen:
1. Angabe von Benutzername und Passwort im SimApi-Konfigurationsdialog. Die Anmeldeinformationen werden verschlüsselt auf dem PC gespeichert.
2. Geben Sie den Benutzernamen und das Passwort in der in ODBC-Datenquellen erstellten ODBC-Verbindung an (siehe unten). Dadurch werden die Anmeldeinformationen in Windows gespeichert.
3. Keine explizite Angabe der Anmeldeinformationen, sondern Verwendung der Windows-Authentifizierung und des Benutzerkontos, unter dem die SimApi ausgeführt wird. Bei Desktop-SIMCA ist dies der Benutzer, der SIMCA ausführt, und bei SIMCA-Online ist dies das in den Windows-Diensten konfigurierte SIMCA-Online-Dienstkonto.
Kapitel 3 zeigt, wie die SimApi konfiguriert wird.
2.6 Visual C++ Redistributable
Um die SimApi auf einem Computer verwenden zu können, muss die folgende Software installiert sein:
· Das Microsoft Visual C++ Redistributable für Visual Studio 2015-2022. Dieses ist bereits auf allen Computern mit aktuellen Versionen von SIMCA oder SIMCA-online verfügbar. Um die SimApi in anderen Kontexten auszuführen, finden Sie die neueste Version unter https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vcredist?view=msvc-170#visual-studio-2015-2017-2019-and-2022
Installation und Einrichtung
3 Installation und Einrichtung
Der SimApi-Leitfaden, der unter sartorius.com/umetrics-simapi heruntergeladen werden kann, enthält gute Hintergrundinformationen zu SimApis, wie man eine SimApi installiert, konfiguriert, Fehler behebt und testet. Sie können in diesem Dokument nachschlagen, um mehr über verschiedene Themen zu erfahren. Um diese SimApi zu installieren und zu konfigurieren, führen Sie diese Schritte aus:
1. Installieren Sie ODBC-Treiber für Ihre Datenbank-Engine (siehe Kapitel 2). 2. Richten Sie eine ODBC-Datenbankverbindung in Windows ODBC Data Sources ein und testen Sie diese, um sicherzustellen, dass sie
funktioniert (detaillierte Schritte im nächsten Abschnitt). 3. Installieren Sie die SimApi auf dem PC mit dem Installationsprogramm: (detaillierte Anweisungen finden Sie in Kapitel 5 in
der SimApi-Leitfaden): a. Deinstallieren Sie zunächst alle vorherigen Versionen in Windows Apps und Features, bevor Sie die neue installieren. b. Entpacken Sie die Zip-Datei file, siehe Version Info.txt file und das Benutzerhandbuch (das Sie gerade lesen…). c. Führen Sie die Setup-Exe aus file um die SimApi zu installieren.
4. Wenn das Visual C++ Redistributable auf dem PC nicht auf dem neuesten Stand ist, installieren Sie die neueste Version (siehe 2.6). 5. Fügen Sie die SimApi zu SIMCA oder SIMCA-online hinzu, wie in Kapitel 5 im SimApi-Handbuch beschrieben.
a. Wenn Sie auf die Schaltfläche zum Konfigurieren der SimApi klicken, wird dieser Dialog angezeigt, in dem Sie die zu verwendenden Anmeldeinformationen angeben können (weitere Informationen zu den Optionen finden Sie im vorherigen Kapitel):
b. Alle weiteren Einstellungen für diese SimApi werden manuell in einer XML-Datei vorgenommen. file mit einem Texteditor. Wie Sie die einzelnen Funktionen konfigurieren, wird später in diesem Kapitel beschrieben.
6. Testen Sie die SimApi. Siehe Kapitel 6 im SimApi-Handbuch.
3.1 Konfigurieren einer ODBC-Datenquellenverbindung in Windows zur Verwendung durch die SimApi
Damit die SimApi funktioniert, ist eine konfigurierte ODBC-Datenquellenverbindung erforderlich. Diese erstellen Sie in der Systemsteuerung „ODBC-Datenquellen“ in Windows. Es gibt zwei Versionen dieses Tools unter 64-Bit-Windows: eine für 32-Bit-Anwendungen und eine für 64-Bit-Anwendungen. Verwenden Sie die Version, die zu der von Ihnen verwendeten SimApi passt, normalerweise 64-Bit, da alle aktuellen Versionen von SIMCA-online und SIMCA 64-Bit sind und die 64-Bit-Varianten von SimApi erfordern. Dieser Screenshot zeigt diese Anwendung unter Windows. In diesem Beispiel gibt es drei verschiedene Datenbankverbindungen.ampDer folgende Dialog zeigt die erste Seite des Konfigurationsassistenten für die SQL Server-Verbindung zum Server se01wssuite01:
Installation und Einrichtung
Nutzungsrichtlinien: · Wir empfehlen, dass Sie Ihre Datenquellen als System-DSNs konfigurieren, wie im Screenshot dargestellt. Dadurch wird sichergestellt, dass sie für alle Benutzer des PCs verfügbar sind, einschließlich Diensten wie SIMCA-online. · Klicken Sie auf Hinzufügen, um eine neue Verbindung hinzuzufügen. Wählen Sie den zu verwendenden Treiber aus, den Sie wie im vorherigen Kapitel beschrieben installiert haben und der zu Ihrer Datenbank passt, und klicken Sie sich durch den Assistenten und konfigurieren Sie die Einstellungen für die Verbindung mit Ihrem Datenbankserver. · Am Ende des Assistenten können Sie mit der Schaltfläche Datenquelle testen versuchen, die Verbindung zur Datenbank zu überprüfen. Dies funktioniert natürlich nicht, wenn Sie den Benutzernamen und das Kennwort im ODBC selbst angeben (siehe vorheriges Kapitel).
3.2 Auswahl zwischen zwei Möglichkeiten zum Zugriff auf Prozessdaten
Es gibt zwei Möglichkeiten, auf Prozessdaten in dieser SimApi zuzugreifen: 1. Direktmodus. In diesem Modus geben Sie die view Namen, die über die SimApi verfügbar gemacht werden sollen. Jeder view wird zu einem Knoten in der SimApi und alle Spalten in einem view werden tags. Der Direktmodus wird empfohlen, da er relativ einfach zu verwenden ist.
Installation und Einrichtung
2. Nachschlagen View Modus. Dieser Modus ist komplexer und erfordert eine bestimmte view in der Datenbank, genannt Lookup View. Das view definiert die tags die über die SimApi verfügbar gemacht werden sollen, aber die Daten werden aus zusätzlichen verwandten views für jede Datenzeile in der Suche angegeben view.
Im Folgenden erfahren Sie mehr darüber, wie Sie diese und alle anderen Funktionen der SimApi einrichten. Weitere Informationen zu den Funktionen dieser SimApi, die Sie im Folgenden konfigurieren, finden Sie in Kapitel 1.1.
3.3 XML-Konfiguration file und log file Standorte
Eine SimApi speichert ihr Log files im versteckten Programmdatenordner2: %programdata%UmetricsSimApi, wobei %programdata% dem tatsächlichen Ordner auf Ihrem Computer entspricht. Der Standardwert ist C:ProgramData.
Dieses enthält die SimApi Einstellungen in einer XML file mit dem Namen ODBCSimApi_ .xml. Sie können diese bearbeiten file Nehmen Sie Änderungen manuell mit einem Texteditor wie Notepad vor.
Jede SimApi verwendet normalerweise ihr eigenes Protokoll file, das ähnlich wie das SIMCA-Online-Serverprotokoll file enthält Daten, die von einer Protokollebene-Einstellung abhängen. file ist für die Fehlerbehebung hilfreich.
Das Protokoll file heißt ODBCSimApi_ .Protokoll.
ist der Name der SimApi-Instanz, die Sie in den SIMCA-Online-Serveroptionen oder in der Standardeinstellung für Desktop-SIMCA hinzugefügt haben. Zum Beispielample, wenn Sie die Instanz mit dem Namen „MyDB“ hinzugefügt haben, file Name lautet ODBCSimApi_MyDB.log. Weitere Informationen hierzu finden Sie in 4.2 4.3 im SimApi-Handbuch.
3.4 Globale Verbindungseinstellungen
Der erste Abschnitt der XML-Konfiguration file sind die Verbindungseinstellungen, die beschreiben, wie eine Verbindung zu Ihrer Datenbank hergestellt wird.
Erforderliche Einstellungen sind:
· DSN
der Name der Datenquelle. Er sollte mit dem Namen des System-DSN in Windows übereinstimmen
ODBC-Datenquellen, die Sie oben konfiguriert haben.
· SQLDialect
so eingestellt, dass es mit dem von Ihnen verwendeten Datenbankserver übereinstimmt.
Möglicherweise müssen Sie auch die Einstellungen LeftPunctuation und RightPunctuation festlegen, wenn Sie reservierte SQL-Schlüsselwörter als Namen von Bezeichnern verwenden oder Leerzeichen in Bezeichnernamen Ihrer views/Tabellen/Spalten in der Datenbank.
Die anderen Verbindungseinstellungen sind optional.
Diese und alle weiteren Einstellungen werden auch in der Tabelle am Ende des Kapitels beschrieben.
Wichtig: Einige Datenbanken unterscheiden zwischen Groß- und Kleinschreibung bei Datenbank-, Tabellen- und views, Spalten, also stellen Sie sicher, dass Sie das richtige c verwenden.asing wird in Ihrer Datenbank im XML verwendet file.
3.5 Direktmodus für kontinuierliche/Prozess views
Jede Zeile in einem Direktmodus view ist eine Beobachtung.
Die Spalten in der view Variablen darstellen:
· Es muss eine einzelne Spalte mit Datums-/Zeitdaten vorhanden sein. Diese Spalte sollte der Primärschlüssel sein und darf keine Nullwerte enthalten. Der Name dieser Spalte sollte mit der konfigurierten TimeField-Einstellung in der Konfiguration übereinstimmen. fileDie Werte für diese Spalte sind die Zeit,amp für die Beobachtungen.
· Die Datums-/Zeitspalte muss vom Datentyp datetime oder datetime2 sein. · Die restlichen Spalten werden über die SimApi bereitgestellt als tags mit den gleichen Namen wie die Spalte
Namen. Werte für diese Spalten sind Prozessdaten.
2 Dieser Ordner ist in Windows standardmäßig ausgeblendet. Um ihn in File Explorer konfigurieren Sie es zeigen versteckte files. Beachten Sie, dass Sie zu einem versteckten Ordner navigieren können, indem Sie eine Adresse eingeben File Adressleiste des Explorers.
Installation und Einrichtung
· Writeback wird für alle unterstützt tags, allerdings müssen die richtigen Berechtigungen in der ODBC-Datenquelle festgelegt sein. Um fehlende Werte zurückschreiben zu können, müssen Nullen für die Spalte unterstützt werden.
Die Konfiguration im XML file ist unkompliziert: views und Direktmodus views: –> ”/>
Hinweis: Die SimApi zählt die Spalten nur beim Start auf. Das bedeutet, dass, wenn neue Spalten zu einem view Damit die SimApi sie verfügbar macht, muss sie neu gestartet werden.
Abbildung 1. Tabelle für den Direktmodus, Beispielample.
3.6 Nachschlagen View Modus für kontinuierlich/Prozess views
Das view kann anstelle oder zusätzlich zum Direktmodus verwendet werden views wie oben beschrieben. Die Lookup View ist eine indirekte Möglichkeit anzugeben, welche Datenspalten in anderen views, die kompiliert und über die SimApi bereitgestellt werden sollen. Die anderen views sind entweder HDB-Quellen (historische Daten) oder PDB-Quellen (aktuelle Daten). Die PDB-Quelle ist optional. Die von der Suche angezeigten Daten View wird von der SimApi als Knoten dargestellt, der immer ODBCProcess heißt:
Jede Zeile im Lookup view definiert einen tag über die SimApi verfügbar gemacht werden und welche anderen views, aus denen die Daten entnommen werden sollen tagDie Suche view enthält daher viele Zeilen. Außerdem wird angegeben, ob ein tag ist schreibbar, d.h. wenn SIMCA-online Werte zurückschreiben kann, tag.
Es können mehrere PDB-Quellen und mehrere HDB-Quellen aus dem Lookup verwendet werden. View. Somit kann die ODBC SimApi Daten aus mehreren views in einen Knoten mit tags die über die SimApi verfügbar gemacht werden.
Die Suche view muss die folgenden Spalten enthalten (in der Konfiguration als Felder bezeichnet) file):
· Name
Der Name eines tag (Primärschlüssel, varchar, nicht null).
· PDB_Source
Der Name des view das die aktuellen Daten für die tag (varchar). Wenn diese
einen leeren Wert enthält, liest das Programm alle Daten aus der HDB_Source.
· PDB_Field
Der Spaltenname der tag in der PDB-Quelle view Wenn die
Der PDB_Source-Wert wird weggelassen, diese Spalte wird nicht gelesen.
· HDB_Quelle
Der Name des view das die historischen Daten für die tag (varchar).
· HDB_Field
Der Spaltenname der tag in der HDB-Quelle view (varchar).
Installation und Einrichtung
· Beschreibbar
Wenn SIMCA-online Daten in diese tag oder nicht (Bit).
Beachten Sie, dass in der obigen Beschreibung für jede Spalte auch angegeben ist, welche Zeilen Primärschlüssel sein sollen und welcher Datentyp für jede Spalte gilt.
Die Namen der Spalten sind beliebig, da die Namen in der Konfiguration angegeben werden. file.
Abbildung 2. BspampDatei eines Lookups view in Form einer Datenbanktabelle. Im Screenshot sehen Sie, dass eine PDB-Quelle und eine HDB-Quelle verwendet werden. Die Spalte Name bestimmt die tag Namen, die die SimApi verwenden wird, und in diesem Fall verwenden die _Field-Spalten dieselben Spaltennamen. Nur eine tag ist beschreibbar.
3.6.1 PDB views und HDB views
Wenn Sie eine Suche verwenden View Sie benötigen außerdem mindestens eine HDB view. Der views für die historischen Daten (HDB) und die optionalen views für aktuelle Daten PDB haben beide die gleiche Datenstruktur (Spalten).
Jede Zeile im PDB oder HDB views stellt eine Beobachtung mit Werten für jede tag in diesem PDB/HDB view wie in der Suche angegeben view.
Die Unterschiede zwischen PDB und HDB sind:
· Ein PDB view enthält nur eine Datenzeile für die tags angegeben in der Suche viewEs sollte auch eine Zeitangabe gebenamp in der Spalte „Zeitpunkt der letzten Aktualisierung“ angezeigt.
· Eine HDB view enthält mehrere Datenzeilen für die tags in der Lookup-Tabelle angegeben. Jede Zeile hat eine Zeitangabeamp enthält die historische Zeitamp für eine bestimmte Beobachtung.
Die PDB und die HDB views sollten die folgenden Spalten haben,
· Datum/Uhrzeit
Für einen PDB: Der Zeitpunkt der letzten Aktualisierung der Tabelle (Primärschlüssel, Datum/Uhrzeit oder
datetime2, nicht null).
Für eine HDB: Die historische Zeit für die tag Werte (Primärschlüssel, Datum/Uhrzeit oder
datetime2, nicht null).
· [Spaltenname] Es sollte eine Spalte für jede tag das in der Nachschlagetabelle angegeben wurde.
Enthält die Daten für die tag in jeder Reihe.
Beachten Sie, dass in der obigen Beschreibung für jede Spalte auch angegeben ist, welche Zeilen Primärschlüssel sein sollen und welcher Datentyp für jede Spalte gilt.
Die Namen der Spalten sind in der Datenbank beliebig, da die Namen in der Konfiguration angegeben werden file.
Die folgenden Spalten sind nicht obligatorisch, aber sinnvoll, wenn Chargen mit mehreren Phasen modelliert werden und mehrere Einheiten im Prozess vorhanden sind:
· UnitBatchID
Eine Spalte pro Einheit, die die Batch-ID innerhalb einer bestimmten Einheit enthält (varchar).
Das tag kann in der Chargenkennung verwendet werden tag Feld für diese Einheit auf der Seite Ausführungsbedingungen von
die Konfiguration dieses Projektes in SIMCA-online.
Installation und Einrichtung
· PhaseID
Eine Spalte pro Einheit, die die Phaseninformationen für die Einheit enthält (int, float oder varchar).
Das tag kann in logischen Ausdrücken im Feld „Phasenausführungsbedingung“ in der Konfiguration dieser
Projekt in SIMCA-online.
Die maximal zulässige Anzahl von tags (Spalten) beträgt 255.
Abbildung 4. PDB example.
Abbildung 3. HDB example.
3.7 Batch-Knoten
Ein Batch-Knoten enthält Metainformationen zu Batches wie Startzeit, Stoppzeit und optional Batch-Bedingungen. Ein Batch-Knoten wird von SIMCA-online zur Analyse von Batch-Daten benötigt, kann aber für ein kontinuierliches (nicht-Batch-)Projekt weggelassen werden. Der Name eines Batch-Knotens aus SIMCA-online oder SIMCA ist der ursprüngliche Name des view oder Tabelle in der Datenbank, in diesem Beispielampdie „BatchData“:
Jede Zeile in einem Batchknoten stellt einen Batch dar.
Installation und Einrichtung
Eine Charge view muss die folgenden Spalten haben:
· Batch-ID
Der Name des Stapels (Primärschlüssel, varchar, ungleich null).
· BatchStart
Die Startzeit der Charge, wenn sie zum ersten Mal in den gesamten Prozess eintritt (nicht, wenn sie
startet in einer Einheit (einem Teil davon) im Prozess) (datetime oder datetime2, ungleich null).
· BatchStop
Der Zeitpunkt, zu dem die gesamte Charge im System (nicht in einer Einheit) abgeschlossen ist, null, wenn
nicht abgeschlossen (datetime oder datetime2).
Beachten Sie, dass die Spalte „BatchID“ der Primärschlüssel sein sollte.
Darüber hinaus können für jede Batch-Bedingungsvariable die folgenden optionalen Spalten vorhanden sein:
· [Name der Batchbedingung]
Eine Spalte für jede Batchbedingung. Der Spaltenname lautet
verwendet als tag Name. (Float für numerische Werte oder varchar für Text wie die Konfigurations-ID).
· Einheiten-ID
Der Name der Einheit, zu der die Charge gehört
(varchar).
Die Namen der Batchknoten und Spalten sind in der Datenbank beliebig, da die Namen in der Konfiguration angegeben werden. file.
Abbildung 5. Batch-Knoten exampDatei mit zwei Batch-Bedingungen (bc1 und bc2) und einer UnitID-Spalte.
3.8 Chargendaten Views
Die einzelnen Chargendaten view muss diese drei Spalten enthalten (zusätzliche Spalten werden ignoriert):
· Batch-ID · Tag Name · Wert
Text oder Float3).
Name des Batches (varchar, nicht null) Name der Batch-Bedingungsvariable (varchar, nicht null) Wert der Batch-Bedingungsvariable (float für numerische Werte oder varchar für
Die Kombination aus BatchID und Tag Name sollte der Primärschlüssel sein (es sei denn, Sie möchten die Funktion für mehrere Batch-Dateninstanzen verwenden).
Die einzelnen Chargendaten view wird von der SimApi als Knoten bereitgestellt. Der Name des Knotens ist der view Name in der Datenbank. Der view Name und Spaltennamen werden in der XML-Konfiguration konfiguriert file Verwendung der Attribute einer einzelnen BatchDataView Element wie folgt:
3 Mit einer varchar-Textspalte können Sie Text speichern (Daten für qualitative Variablen in einem SIMCA-Projekt). Sie können jedoch auch numerische Zahlen im Textformat speichern, und die SimApi konvertiert diese in Zahlen. Auf diese Weise können Sie einige tags die numerisch sind und einige, die Text enthalten.
Installation und Einrichtung
<BatchDataView ViewName=”DatenbankViewOderTabellenname“ BatchIDColumn=“BatchID“ TagNameColumn=”Tag Name“ ValueColumn=“Wert“ />
Beachten Sie, dass die hier verwendeten Werte mit der Tabelle in Abbildung 5 übereinstimmen. Mehrere Batchdaten hinzufügen views durch Hinzufügen weiterer BatchDataView Elemente.
3.8.1 Synthetische Batch-Dateninstanz tags
So konfigurieren Sie die optionale Batchdateninstanz tagsfügen Sie die Attribute NumSyntheticBatch hinzuTags und TimeColumn zu den BatchDataView Element:
<BatchDataView ViewName=”DatenbankViewOderTabellenname“ BatchIDColumn=“BatchID“ TagNameColumn=”Tag Name“ ValueColumn=“Wert“ TimeColumn=“ZeitColumn“ NumSyntheticBatchTags=”3″ />
TimeColumn ist der Name der Zeitspalte in Ihrer Datenbank viewDiese Spalte muss für Batchdateninstanzen bereitgestellt werden tags.
Zulässiger Wert für NumSyntheticBatchTags sind numerische Werte zwischen 1 und 10. Dies steuert, wie viele synthetische Instanzen tags werden pro real erstellt tag. Zum Beispielample, für die tag „tag" neu tags „tag_1”, “tag_2”, … “tag_N” wird erstellt, bis N= NumSyntheticBatchTags.
3.8.2 Batch-ID des synthetischen Prozesses tags gefiltert nach Spaltenwerten
So konfigurieren Sie den optionalen Batch-ID-Filter tags die für den kontinuierlichen Datenabrufmodus verwendet werden können, fügen Sie die Attribute FilterColumns und TimeColumn zum BatchData hinzu.View Element:
<BatchDataView ViewName=”DatenbankViewOderTabellenname“ BatchIDColumn=“BatchID“ TagNameColumn=”Tag Name“ ValueColumn=“Wert“ FilterColumns=“Spalte1|Spalte2“ TimeColumn=“Zeitspalte“/>
FilterColumns sollten ein oder mehrere Spaltennamen in Ihrer Datenbank sein view. Wenn mehrere Spaltennamen verwendet werden, trennen Sie diese mit dem Pipe-Zeichen (|).
TimeColumn sollte der Name der Zeitspalte in Ihrer Datenbank sein viewDiese Spalte muss für Batchdateninstanzen bereitgestellt werden tags.
3.9 Diskrete Knoten
Optionale diskrete Knoten enthalten diskrete Datenmessungen. Jede Zeile in einem diskreten Knoten stellt eine Messung für einen Stapel dar und tag zu einem bestimmten Zeitpunkt.
Ein diskreter Knoten muss die folgenden Spalten haben:
· Batch-ID · TagName · Zeit · Wert
Der Name des Batches (varchar, nicht null). Der Name des tag (varchar, nicht null). Der Zeitpunkt, zu dem die sampDatei wurde erstellt (datetime oder datetime2, nicht null). Der Messwert (Float). Diskrete Daten können keine Zeichenfolgendaten sein.
Beachten Sie, dass die Kombination aus BatchID+TagName+Zeit sollten der Primärschlüssel sein.
Jeder konfigurierte diskrete Knoten wird von der SimApi als Knoten angezeigt. Der Name des Knotens ist der view Name in der Datenbank, sofern er nicht überschrieben wird. Der Knotenname, view Name, Nachschlagen viewund die Spaltennamen werden in der XML-Konfiguration konfiguriert file Verwenden Sie die Attribute eines DiscreteNode-Elements wie folgt:
<DiscreteNode NodeName=”ODBCDiscrete” ViewName=”Diskret” TagNachschlagenView=”DiskretTags” BatchIDField=”BatchID” TimeField=”Zeit” TagNameField=”TagName“ ValueField=“Wert“/>
Das obige Beispielample stellt einen Knoten namens ODBCDiscrete durch die SimApi bereit, es listet die tags mit dem diskretenTags Tisch/view. Daten werden aus der diskreten Tabelle gelesen/view unter Verwendung der konfigurierten Spalten.
Installation und Einrichtung
Die Namen der diskreten Knoten und ihrer Spalten sind in der Datenbank beliebig, da die Namen in der Konfiguration angegeben werden. file.
Abbildung 6. Diskreter Knoten example mit zwei tags sampdreimal (im Abstand von etwa 24 Stunden) pro Charge durchgeführt.
3.9.1 Diskret Tag Definition View
Dieses optionale view wird von der SimApi verwendet, um die diskreten tags das sollte über die SimApi verfügbar sein. Dies geschieht beim Start der SimApi. Sie können dies verwenden view für Performance-Optimierungen beim Laden der SimApi oder wenn Sie kontrollieren möchten, was tags werden von der SimApi bereitgestellt. Wenn Sie beispielsweise bereitstellen möchten tags das noch keine Messungen hat, wenn die SimApi gestartet wird.
Abbildung 7. Einfache diskrete tag Nachschlagen view welches die diskrete Tabelle verwendet.
Installation und Einrichtung
3.9.2 Diskrete Daten aus Sicht von SIMCA-online
Im Folgenden wird gezeigt, wie die diskreten Daten in Abbildung 6. Diskreter Knoten example mit zwei tags sampdreimal (im Abstand von etwa 24 Stunden) pro Batch geführt.Abbildung 6 Abbildung 2Fehler! Referenzquelle nicht gefunden.wird in SIMCAonline angezeigt, wenn es mit den Batches in Abbildung 5 kombiniert wird.
Abbildung 8. Diskrete Daten, wie sie von SIMCA-online angezeigt werden. Beachten Sie, dass das generierte Batch-Alter tags stellen das Alter der Charge für jede Beobachtung darample.
3.10 Einige Hinweise zum SIMCA-online Write Back
Mit dem Zurückschreiben in SIMCA-online können Daten aus SIMCA-online in die ODBC-Datenquelle geschrieben werden. Das Schreiben kontinuierlicher Prozessdaten (aus kontinuierlichen Konfigurationen, der Batch-Evolutionsebene oder aus Control Advisor) und Batch-Daten (aus der Batch-Ebene) wird unterstützt. Es wird nicht empfohlen, in dieselben Knoten zurückzuschreiben, die Sie zum Lesen von Daten verwenden, da dadurch versucht würde, doppelte Zeilen mit denselben Primärschlüsseln in der Datenbank hinzuzufügen. views wegen der Primärschlüssel, die wir für die Datums-/Zeitspalte und die Batch-ID-Spalten empfehlen (siehe oben). Erstellen Sie stattdessen einen oder mehrere Direct Mode views für kontinuierliche/Evolutionsdaten oder Batchknoten für Batchdaten, die zum Zurückschreiben verwendet werden sollen. Der Grund für dieses Problem ist, dass die ODBC SimApi SQL INSERT-Anweisungen verwendet, um für jede Beobachtung oder für jeden Batch auf Batchebene eine neue Datenzeile hinzuzufügen.
· Bei kontinuierlichen Daten wird der Zeitpunkt der Beobachtung zusammen mit den Werten aus SIMCAonline zurückgeschrieben.
· Bei Batchdaten wird die Batch-ID zusammen mit den Werten aus SIMCA-online zurückgeschrieben. · Wenn fehlende Werte zurückgeschrieben werden, werden diese als Null geschrieben, daher muss die Datenbank Nullwerte unterstützen
damit dies funktioniert. Da die Zeit einer Beobachtung oder die Batch-ID eines Batches zurückgeschrieben wird, würde dies die Primärschlüsselbeschränkung in den Datenbanken verletzen, wenn dieselben Werte bereits vorhanden wären (wie es der Fall wäre, wenn Daten von denselben Knoten gelesen würden). Abgesehen von diesen Primärschlüsselunterschieden gilt für Knoten zum Zurückschreiben dasselbe Datenbankschema (weitere Informationen finden Sie oben):
Installation und Einrichtung
· Für kontinuierliche Knoten sollte eine Datums-/Zeitspalte und für Batchknoten eine Batch-ID-Spalte vorhanden sein. · Fügen Sie für jeden Knoten eine Datenspalte hinzu. tag die für das Zurückschreiben verfügbar sein sollen. Verwenden Sie den Float-Datentyp für
numerische Daten und varchar für Textdaten (z. B. beim Zurückschreiben der Konfigurations-ID einer Konfiguration). Zum BeispielampWenn Sie also 20 verschiedene Datenvektoren von SIMCA-online zurückschreiben möchten, müssen Sie der Datenbank 20 Datenspalten hinzufügen. view· Die Spalten müssen Nullen zulassen, um das Zurückschreiben fehlender Werte zu unterstützen
3.11 XML-Konfiguration File
Diese Tabelle listet alle Einstellungen in der XML-Konfiguration auf file. Verwenden Sie diese Informationen und die obigen Beschreibungen, um die SimApi zu konfigurieren.
Verbindungsspezifische Einstellungen
Erläuterung
DSN
Name der Datenquelle wie in der Systemsteuerung des Windows-ODBC-Administrators eingerichtet.
SQLDialect
Der zu verwendende SQL-Dialekt. Einer dieser Werte: Standard, PostgreSQL, DB2, MSSQL, MySQL, Oracle, Access, Denodo. Wenn das Feld leer gelassen wird, wird Standard verwendet, aber der Standardwert für eine neue XML-file ist mssql.
Qualifikationen
Der ODBC-Benutzername und das ODBC-Passwort werden verschlüsselt gespeichert. Verwenden Sie die Schaltfläche „Konfigurieren“, um den Benutzernamen und das Passwort anzugeben.
AbfrageTimeout
Die Zeit, bevor eine Abfrage oder Verbindung zur Datenbank abläuft und fehlschlägt.
DBSchema
Das Datenbankschema in der Datenbank (falls zutreffend). Ein Datenbankschema ist eine Möglichkeit, Objekte wie Tabellen logisch zu gruppieren, views, gespeicherte Prozeduren usw. Stellen Sie sich ein Schema als einen Container von Objekten vor. Sie können einem Benutzer Anmeldeberechtigungen für ein einzelnes Schema zuweisen, sodass der Benutzer nur auf die Objekte zugreifen kann, für die er eine Zugriffsberechtigung hat. Schemata können in einer Datenbank erstellt und geändert werden, und Benutzern kann der Zugriff auf ein Schema gewährt werden. Ein Schema kann jedem beliebigen Benutzer gehören, und der Schemabesitz ist übertragbar.
Linke Zeichensetzung
SQL-Dialektspezifisches linkes Trennzeichen, das verwendet wird, um Bezeichner von anderen SQL-Befehlen zu trennen. Der Standardwert ist leer, was bedeutet, dass keine linke Interpunktion verwendet wird. Sie müssen einen nicht leeren Wert angeben, wenn die Bezeichner in der Datenbank Leerzeichen oder reservierte SQL-Schlüsselwörter verwenden. Für SQL Server oder Access verwenden Sie „[“, aber für Oracle und andere Datenbanken, die den SQL-Standard verwenden, sollten Sie diese Einstellung auf „"“ setzen (dies ist die XML-Escape-Sequenz für das doppelte Anführungszeichen „).
Richtige Zeichensetzung
SQL-Dialektspezifisches rechtes Trennzeichen, das verwendet wird, um Bezeichner von SQL-Befehlen zu trennen. Für SQL Server oder Access verwenden Sie „]“, aber für Oracle und andere Datenbanken, die den SQL-Standard verwenden, sollten Sie diese Einstellung wie oben für LeftPunctuation auf „"“ setzen.
SelectStatementTerminator
SQL-Dialektspezifisch. Zeichen, das zum Beenden von Select-Anweisungen verwendet wird. Für einige Dialekte und Versionen muss dies auf eine leere Zeichenfolge „“ gesetzt werden. Der Standardwert ist „;“.
Größe des Datenbankverbindungspools
Die maximale Anzahl gleichzeitiger Verbindungen zur Datenbank, die zulässig sind. Der Standardwert ist 10. Diese Einstellung kann die Leistung verbessern, indem sie mehreren Threads gleichzeitigen Zugriff auf die Datenbank ermöglicht. Weitere Informationen finden Sie in Kapitel 1.
Installation und Einrichtung
Datenbankspezifische Einstellungen
LokaleZeit verwenden
Gibt an, ob Daten in der Datenbank als Ortszeit oder UTC gespeichert werden. Der Standardwert ist „1“, was bedeutet, dass die Ortszeit verwendet wird.
Direktmodusspezifische Einstellungen
Tabellen
Der Name des views, die kontinuierliche/Prozessdaten enthalten. Mehrere views können angegeben werden, indem ihre Namen durch ein Pipe-Zeichen (|) getrennt werden. Zum Beispielample: Tabelle1|Tabelle2|Tabelle3|View1. Der TimeField-Name muss in allen views.
Nachschlagen view spezifische Einstellungen
Nachschlagetabelle
Der Name der Suche view oder Tisch.
TagNamensfeld
Der Name der Spalte, in der die tag Namen werden angegeben.
PDBTableField
Der Name einer Spalte in der Suche view. Für jede Zeile enthält diese Spalte den Namen eines PDBs viewDer Name eines view mit PDB-Daten. Kann leer gelassen werden. In diesem Fall wird stattdessen die aktuellste Zeile des HDB für die aktuellen Daten verwendet.
PDBTagFeld
Der Spaltenname in der PDB-Tabelle, in der die Daten für die tag gefunden werden kann (wird nicht verwendet, wenn PDBTableField weggelassen wird).
HDBTableField
Der Name einer Spalte in der Suche view. Für jede Zeile enthält diese Spalte den Namen eines HDB view.
HDBTagFeld
Der Name einer Spalte in der Suche view. Für jede Zeile enthält diese Spalte den Namen eines tag in der HDB view.
Schreibbares Feld
Der Spaltenname gibt an, ob die tag beschreibbar ist oder nicht.
Direktmodus und HDB/PDB view spezifische Einstellungen
Zeitfeld
Der Name der Datums-/Zeitspalte im Continuous/Process View und die PDB- bzw. HDB-views (oder Tabellen).
Batchknotenspezifische Einstellungen
Stapeltabelle
Der Name des view oder Tabelle, die die Batch-Daten enthält. Mehrere Batch- view können angegeben werden, indem ihre Namen durch ein Pipe-Zeichen (|) getrennt werden. Zum Beispielample: BT1|BT2|BT3. Die folgenden Spalten müssen in allen views.
BatchIDFeld
Der Spaltenname der Batch-ID im Batch-Knoten.
StartZeitfeld
Der Spaltenname der Startzeit für den Stapel.
Stoppzeitfeld
Der Spaltenname der Stoppzeit für den Stapel.
BatchIDUnitField
Der Spaltenname der Einheiten-ID im Batch-Knoten. Dieses Feld kann verwendet werden, um synthetische Batch-ID-Prozesse zu generieren. tags gefiltert nach Einheiten-ID.
Batch-Knoten mit Filterunterstützung Eins Element mit den folgenden Attributen, die steuern
Einstellungen
die Einstellungen für den synthetisch gefilterten Batchknoten.
Installation und Einrichtung
ViewName BatchID-Spalte StartzeitSpalte StoppzeitSpalte Filterspalte
Filterwerte
Chargendaten view Einstellungen Diskrete knotenspezifische Einstellungen
Knotenname ViewName TagNachschlagenView
BatchIDFeld ZeitFeld TagNameField ValueField Protokoll file spezifische Einstellungen LogFileGröße LogLevel
Der Name des view oder Tabelle, die die Batchdaten enthält.
Der Spaltenname der Batch-ID des Batches.
Der Spaltenname der Startzeit für den Stapel.
Der Spaltenname der Stoppzeit für den Stapel.
Der Name der Spalte, die die Filterwerte im Batchknoten enthält. Diese Einstellung kann leer gelassen werden, wenn Sie die Filterfunktion nicht benötigen.
Die Werte, die zum Filtern von Batches verwendet werden sollen. Mehrere Filterwerte werden durch das Pipe-Zeichen (|) getrennt. Lassen Sie das Feld leer, wenn Sie keine Filterung benötigen. Zum Beispielample: Filterwert1| Filterwert2| Filterwert3. Dies ist ein BeispielampAbbildung wie es in der Konfiguration aussehen könnte file: ViewName=”BatchNode” BatchIDColumn=”BatchID” StartTimeColumn=”StartTime” StopTimeColumn=”StopTime” FilterColumn=”Unit FilterValues=”FilterValue1| FilterValue2″ /> Mehrere Elemente werden unterstützt. Beachten Sie, dass die Spaltennamen zwischen den Batchknoten unterschiedlich sein können.
Gespeichert in einem oder mehrerenView> Elemente. Siehe 3.8 Batchdaten Views.
Ein Element für jeden diskreten Knoten mit den folgenden Attributen. Siehe 3.9 Diskret .
Der Name des Knotens, wie er von der SimApi angezeigt wird. Wenn leer gelassen, wird der Wert des ViewDer Name wird verwendet.
Der Name des view/Tabelle, die die diskreten Daten enthält. Wenn leer gelassen, ist der Knoten deaktiviert.
Der Name des view/table, das die diskreten tags zu verwenden. Wenn leer gelassen, ViewDer Name wird beim Start analysiert, um alle aufzuzählen tags Dort.
Der Spaltenname der Identität des Batches, der gemessen wurde.
Der Spaltenname des Zeitpunktes der Messung.
Der Spaltenname der tag das wurde gemessen.
Der Spaltenname des Messwerts.
Die maximal zulässige Größe des Protokolls file vor dem file wird abgeschnitten.
Je höher der Wert, desto mehr Informationen werden in das Protokoll gedruckt. file. Der Maximalwert ist 4 und der Minimalwert ist 0. (0=Kritisch, 1=Fehler, 2=Warnung, 3=Information, 4=Debug).
Unterstützung
4 Unterstützung
Diese SimApi wurde von Sartorius Data Analytics entwickelt. Für Support besuchen Sie bitte sartorius.com/umetrics-support.
Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Schweden
Telefon: +46 90-18 48 00 www.sartorius.com
Die in dieser Anleitung enthaltenen Informationen und Abbildungen entsprechen dem unten angegebenen Versionsdatum. Sartorius behält sich das Recht vor, ohne Ankündigung Änderungen an Technik, Funktionen, Spezifikationen und Design des Geräts vorzunehmen. In dieser Anleitung werden zur besseren Lesbarkeit männliche oder weibliche Formen verwendet, die immer alle Geschlechter gleichzeitig bezeichnen.
Urheberrechtshinweis: Diese Anleitung einschließlich aller Bestandteile ist urheberrechtlich geschützt. Jede Verwertung außerhalb der Grenzen des Urheberrechtsgesetzes ist ohne unsere Zustimmung nicht gestattet. Dies gilt insbesondere für Nachdruck, Übersetzung und Bearbeitung unabhängig von der Art der verwendeten Medien.
Unterstützung
Dokumente / Ressourcen
 |
SARTORIUS ODBC SimApi [pdf] Benutzerhandbuch ODBC SimApi, SimApi |