Beruflich Dokumente
Kultur Dokumente
Datenbank-Beschreibung GridVis-4-Struktur
(gültig ab Datenbankversion 21)
Dok. Nr.: 2.047.008.0
Smart Energy &
Power Quality Solutions
Alle Rechte vorbehalten. Kein Teil des Handbuches sowie des dazugehörigen Programms darf ohne schriftliche
Genehmigung des Urhebers reproduziert oder vervielfältigt werden. Zuwiderhandlungen sind strafbar und wer-
den mit allen juristischen Mitteln verfolgt. Für die Fehlerfreiheit des Handbuchs kann keine Haftung übernom-
men werden. Da sich Fehler trotz aller Bemühungen nie vollständig vermeiden lassen, sind wir für Hinweise
dankbar. Wir sind bestrebt, uns bekanntgewordene Fehler so schnell wie möglich zu beheben.
2
Smart Energy &
Power Quality Solutions
Inhalt
1. Datenbankmodell 4
2. Unterschiede zwischen Version 16 und 21 5
3. Tabellenbeschreibungen 5
3.1. Tabelle: pasw_device 5
3.2. Tabelle: device_config 7
3.3. Tabelle: device_value 7
3.4. Tabelle: event 8
3.5. Tabelle: pasw_global 8
3.6. Tabelle: pasw_last_synced 9
3.7. Tabelle: plugin_config 9
3.8. Tabelle: transient 10
3.9. Tabelle: flag 11
3.10. Tabelle: value_desc 11
3.11. Tabelle: value_data_time 12
3.12. Tabelle: sequence 12
4. Beispiel-Queries 14
5. Anhang 15
5.1 EventTypes 15
5.2 Input 16
5.3 Transient Types 18
5.4 Sequence Types 18
5.4 Sequence Reason 18
5.6 Flag Types 19
5.7 Wie können die Registeradressen der GridVis berechnet werden? 20
3
<<table>> <<table>> <<table>> <<table>>
pasw_global pasw_device value_desc value_data_time
+value_id: INTEGER NOT NULL
+db_version: INTEGER NOT NULL +dev_id:INTEGER NOT NULL PRIMARY +value_id: INTEGER NOT NULL PRIMARY
+license: VARCHAR(16383) +from_ns: LONG NOT NULL
+dev_type: VARCHAR(255) NOT NULL +dev_id: INTEGER NOT NULL
+to_ns LONG NOT NULL
+dev_connection: VARCHAR(255) NOT NULL +type: INTEGER NOT NULL
+value_min: FLOAT
+dev_name: VARCHAR(255) +timebase: INTEGER NOT NULL
+value_avg: FLOAT
+dev_description: VARCHAR(255) +online: INTEGER NOT NULL
+value_max: FLOAT
+dev_default: BOOLEAN NOT NULL
+dev_deleted: BOOLEAN NOT NULL <<table>>
+dev_synced_ns: LONG event
+dev_auto_sync: VARCHAR(255)
+event_id: LONG NOT NULL PRIMARY
+dev_check_evt: INTEGER
+dev_id: INTEGER NOT NULL
+dev_check_trns: INTEGER
+line: INTEGER NOT NULL PASW Internal Tables
+dev_server_id: INTEGER
+type: INTEGER NOT NULL
+dev_serialNr: VARCHAR(255)
+from_ns: LONG NOT NULL
+dev_enabled: BOOLEAN <<table>>
+to_ns:LONG NOT NULL
value_time_cache
+evt_min: FLOAT
<<table>>
+evt_avg: FLOAT +value_id: INTEGER NOT NULL
pasw_last_synced +from_ns: LONG NOT NULL
+evt_max: FLOAT
+evt_limit: FLOAT +to_ns: LONG NOT NULL
+dev_id: INTEGER NOT NULL
+ls_name: VARCHAR(64) NOT NULL
+ls_time_ns: LONG <<table>>
transient
<<table>> +trans_id: LONG NOT NULL PRIMARY
plugin_config +dev_id: INTEGER NOT NULL
+line: INTEGER NOT NULL
+plugin_name: VARCHAR(255) NOT NULL
+type: INTEGER NOT NULL
+config_name: VARCHAR(255)
+from_ns: LONG NOT NULL
+dev_id: INTEGER
+to_ns: LONG NOT NULL
+config_text: CLOB
GridVis:Server Tables
+trns_max: FLOAT
+trns_energy: FLOAT
<<table>> <<table>> <<table>>
device_value server active_online_value
<<table>>
+server_id: INTEGER NOT NULL PRIMARY +ovalue_id: INTEGER NOT NULL PRIMARY
+dev_id: INTEGER NOT NULL
sequence
+server_name: VARCHAR(255) NOT NULL +dev_id: INTEGER NOT NULL
+dev_value_id: INTEGER NOT NULL +seq_id: LONG NOT NULL PRIMARY +server_type: VARCHAR(255) NOT NULL +type: INTEGER NOT NULL
+dev_value_name: VARCHAR(32) +dev_id: INTEGER NOT NULL +server_adress: VARCHAR(255) NOT NULL +timebase: INTEGER NOT NULL
+dev_unit: VARCHAR(16) +line: INTEGER NOT NULL +server_heartbeat: LONG
+dev_user_name: VARCHAR(64) +type: INTEGER NOT NULL
+reason: INTEGER NOT NULL <<table>>
<<table>> +pretrigger: INTEGER NOT NULL
server_log
device_config +from_ns: LONG NOT NULL
+log_id: INTEGER NOT NULL PRIMARY
+to_ns: LONG NOT NULL
+server_id: INTEGER NOT NULL
+dev_id: INTEGER NOT NULL +sample_rate: FLOAT NOT NULL
+log_time: LONG NOT NULL
+from_ns: LONG NOT NULL +data: BLOB NOT NULL
+log_type: VARCHAR(255) NOT NULL
+config_text: CLOB NOT NULL
+log_text: VARCHAR(16383) NOT NULL
1. Datenbankmodell
Version: 20
Aktualisiert: 17.01.2013
4
Smart Energy &
Power Quality Solutions
• Die Tabellen ‚value_time‘ und ‚value_data‘ wurden zu einer Tabelle ‚value_data_time‘ zusammengefasst.
• ‚from_ns‘ in der Tabelle ‚value_data_time‘ ist indiziert.
•
m Einige Wertetypen wurden verschoben.
Bitte prüfen Sie ob, Sie in Ihrem Programm noch die korrekten Werte erhalten!
3. Tabellenbeschreibungen
m Rechtliche Hinweise:
Janitza electronics GmbH behält sich das Recht vor, jederzeit und ohne jegliche vorherige Bekannt-
machung das Datenbankschema zu ändern und haftet nicht für Schäden, die daraufhin durch Ihre
eigenen Programme entstehen können.
Selbst verfasste Programme unterliegen generell Ihrer Verantwortung und werden auf eigene Ge-
fahr betrieben.
5
Smart Energy &
Power Quality Solutions
Achtung
Wird nicht verwendet.
dev_deleted BOOLEAN Gibt an ob das Gerät als ge-
NOT NULL löscht markiert ist
dev_synced_ns LONG Der UTC - Zeitpunkt der
aktuellen Daten die aus dem
Gerät ausgelesen wurden (in
Nanosekunden seit 1.1.1970).
(0: noch nicht ausgelesen)
dev_auto_sync VARCHAR(255) Der Name des Zeitplans mit
dem dieses Gerät ausgelesen
werden soll.
dev_check_evt INTEGER Gibt an ob das Gerät auf
neue Events untersucht wer-
den soll.
Achtung
Noch nicht genutzt.
dev_check_trns INTEGER Gibt an ob das Gerät auf
neue Transienten untersucht
werden soll.
Achtung
Noch nicht genutzt.
dev_server_id INTEGER Die ID der GridVis die für die-
ses Gerät verantwortlich ist.
dev_serialNr VARCHAR(255) Die Seriennummer des Ge-
rätes.
dev_enabled BOOLEAN Gibt an ob auf das Gerät
zugegriffen werden darf.
Achtung
Noch nicht genutzt.
6
Smart Energy &
Power Quality Solutions
Diese Tabelle beschreibt Messwerttypen, die gerätespezifisch sind (z.B. Jasic Variablen).
7
Smart Energy &
Power Quality Solutions
In dieser Tabelle sind von Messgeräten aufgezeichnete Ereignisse gespeichert. Die Halb- bzw. Vollwellenwerte
der Ereignisse sind in der Tabelle „sequence“ gespeichert.
Diese Tabelle enthält nur eine einzige Zeile. Es sollte mindestens bei jedem Programmstart überprüft werden, ob
die Datenbankversion zum eigenen Programm passt.
8
Smart Energy &
Power Quality Solutions
Achtung
Da der Inhalt von Gerät zu Gerät unterschiedlich sein kann sollte diese Tabelle nicht von anderen
Programmen verwendet werden.
In dieser Tabelle können Module oder externe Programme Daten ablegen. Über die dev_id ist es möglich, diese
Daten mit einem Gerät zu verknüpfen. plugin_name ist ein eindeutiger Name für die Konfiguration.
9
Smart Energy &
Power Quality Solutions
In dieser Tabelle sind die Transienten der Geräte gespeichert. Die Wellenformen sind in der Tabelle „sequence“
gespeichert.
Relevante Typen
Wert Nummer
Spannung L1 4097
Spannung L2 4098
Spannung L3 4099
Spannung L4 4100
Spannung L5 4101
Strom L1 57345
Strom L2 57346
Strom L3 57347
Strom L4 57348
Strom L5 57349
10
Smart Energy &
Power Quality Solutions
Für jedes Gerät mit jeder benutzen Registeradresse (s. GridVis) wird ein Eintrag in dieser Tabelle erstellt.
11
Smart Energy &
Power Quality Solutions
Die Tabellen ‚value_data‘ und ‚value_time‘ aus der Datenbankversion 16-20 wurden aus Performancegründen zu
einer Tabelle zusammengefasst. Diese Tabelle enthält die Werte der in der Tabelle 10 definierten Attribute.
Diese Tabelle enthält die Wellenformen sowie die Voll- und Halbwelleneffektivwertverläufe.
Relevante Typen
(siehe 3.8, Tab. transient)
12
Smart Energy &
Power Quality Solutions
13
Smart Energy &
Power Quality Solutions
4. Beispiel-Queries
3. Bestimmen des Zeitpunkts mit der maximalen Spannung in einem bestimmten Zeitbereich die vom Gerät
„Hauptmessung“ gemessen wurde.
14
Smart Energy &
Power Quality Solutions
5. Anhang
5.1 EventTypes
15
Smart Energy &
Power Quality Solutions
5.2 Input
16
Smart Energy &
Power Quality Solutions
17
Smart Energy &
Power Quality Solutions
TransientTypes beschreibt die verschiedenen Typen die eine Transiente haben kann.
18
Smart Energy &
Power Quality Solutions
LostWindow: OverVoltageL5:
Im angegebenen Zeitraum fehlen Meßbereichsüberschreitung.
Werte. D.h. sie wurden nicht in ClockNotSet:
die vorhandenen Werte mit ein- Uhr nicht gestellt.
gerechnet. Schlägt sich nur in den MemoryDeleted:
gemittelten Meßwerten nieder. Speicherinhalt gelöscht.
LostPLL: EEPROMDefect:
Das Gerät hat die Netzsynchroni- EEProm defekt.
sation verloren. Vorwiegend bei ErrorInCyclicBuffer:
Effektivwerten interesant. Fehler in Ringpuffer.
FirmwareUpgrade: CyclicBufferNew:
Firmeware Upgrade Ringpuffer neu.
OverCurrentL1: CyclicBufferManualDeleted:
Meßbereichsüberschreitung. Ringpuffer manuell geloescht.
OverCurrentL2: ErrorInFirmware:
Meßbereichsüberschreitung. Fehler in Firmware.
OverCurrentL3: ClockSetting:
Meßbereichsüberschreitung. Uhr wird gestellt.
OverCurrentL4: ClockWasSet:
Meßbereichsüberschreitung. Uhr wurde gestellt.
OverCurrentL5: Initialization:
Meßbereichsüberschreitung. Initialisierung Puffer.
OverVoltageL1: WatchDog:
Meßbereichsüberschreitung. WatchDog
OverVoltageL2: ResetEMAX:
Meßbereichsüberschreitung. Reset EMAX.
OverVoltageL3: Timemark:
Meßbereichsüberschreitung. Zeitmarke.
OverVoltageL4: DebugClock:
Meßbereichsüberschreitung. Debug Uhr
19
Smart Energy &
Power Quality Solutions
Es gilt:
Phase
0 = Overall,
1 = L1,
2 = L2,
3 = L3,
4 = L4,
5 = L5,
6 = L2L1,
7 = L3L2,
8 = L1L3,
9 = SUM13,
10 = SUM14,
11 = Main,
12 = Aux
Messwerttypen
20
Smart Energy &
Power Quality Solutions
21
Smart Energy &
Power Quality Solutions
22
Smart Energy &
Power Quality Solutions
23
Smart Energy &
Power Quality Solutions
24
Smart Energy &
Power Quality Solutions
25
Smart Energy &
Power Quality Solutions
26
Smart Energy &
Power Quality Solutions
27
Smart Energy &
Power Quality Solutions
28
Smart Energy &
Power Quality Solutions
29
Smart Energy &
Power Quality Solutions
1392=ActiveEnergyConsumed_Tariff4_ 1437=ReactiveEnergyCap_Tariff8("VArh"),
Intvl("Wh"), 1438=ReactiveEnergyInd_Tariff5("VArh"),
1393=GasConsumption_m3_Intvl("m^3"), 1439=ReactiveEnergyInd_Tariff6("VArh"),
1394=WaterConsumption_l_Intvl("l"), 1440=ReactiveEnergyInd_Tariff7("VArh"),
1395=HeatQuantity_Wh_Intvl("Wh"), 1441=ReactiveEnergyInd_Tariff8("VArh"),
1396=CompressedAir_m3("m^3"), 1442=BinInp_S0Energy_Tariff5(""),
1397=CompressedAir_m3_Intvl("m^3"), 1443=BinInp_S0Energy_Tariff6(""),
1398=HeatFlowrate_W("W"), 1444=BinInp_S0Energy_Tariff7(""),
1399=CompressedAirFlow_m3_h("m^3/h"), 1445=BinInp_S0Energy_Tariff8(""),
1400=OperatingCycles(""), 1446=Runtime_Wh_Tariff5("sec"),
1401=OperatingTime("sec"), 1447=Runtime_Wh_Tariff6("sec"),
1402=SwitchStatus(""), 1448=Runtime_Wh_Tariff7("sec"),
1403=EmaxMinValue("W"), 1449=Runtime_Wh_Tariff8("sec"),
1404=FrequencyNorm("Hz"), 1450=Runtime_Qh_Tariff5("sec"),
1405=Remote(""), 1451=Runtime_Qh_Tariff6("sec"),
1406=NTP_Diff("s"), 1452=Runtime_Qh_Tariff7("sec"),
1407=NTP_Turnaround("s"), 1453=Runtime_Qh_Tariff8("sec"),
1408=NTP_Corr("ppm"), 1454=Runtime_WhVAh_Tariff5("sec"),
1409=Tariff_W(""), 1455=Runtime_WhVAh_Tariff6("sec"),
1410=Tariff_Q(""), 1456=Runtime_WhVAh_Tariff7("sec"),
1411=TDD("%"), 1457=Runtime_WhVAh_Tariff8("sec"),
1412=U_Sym_UO("%"), 1458=BinInp_Counter_Tariff5(""),
1413=GlobalValue("?"), 1459=BinInp_Counter_Tariff6(""),
1414=ActiveEnergy_Tariff5("Wh"), 1460=BinInp_Counter_Tariff7(""),
1415=ActiveEnergy_Tariff6("Wh"), 1461=BinInp_Counter_Tariff8(""),
1416=ActiveEnergy_Tariff7("Wh"), 1462=BinInp_Counter_Tariff5_Intvl(""),
1417=ActiveEnergy_Tariff8("Wh"), 1463=BinInp_Counter_Tariff6_Intvl(""),
1418=ActiveEnergyConsumed_ 1464=BinInp_Counter_Tariff7_Intvl(""),
Tariff5("Wh"), 1465=BinInp_Counter_Tariff8_Intvl(""),
1419=ActiveEnergyConsumed_ 1466=ActiveEnergyConsumed_Tariff5_
Tariff6("Wh"), Intvl("Wh"),
1420=ActiveEnergyConsumed_ 1467=ActiveEnergyConsumed_Tariff6_
Tariff7("Wh"), Intvl("Wh"),
1421=ActiveEnergyConsumed_ 1468=ActiveEnergyConsumed_Tariff7_
Tariff8("Wh"), Intvl("Wh"),
1422=ActiveEnergySupplied_Tariff5("Wh"), 1469=ActiveEnergyConsumed_Tariff8_
1423=ActiveEnergySupplied_Tariff6("Wh"), Intvl("Wh"),
1424=ActiveEnergySupplied_Tariff7("Wh"), 1470=I_Violation(""),
1425=ActiveEnergySupplied_Tariff8("Wh"), 1471=I_ViolationTrans(""),
1426=ApparentEnergy_Tariff5("VAh"), 1472=U_Violation(""),
1427=ApparentEnergy_Tariff6("VAh"), 1473=U_ViolationTrans("");
1428=ApparentEnergy_Tariff7("VAh"),
1429=ApparentEnergy_Tariff8("VAh"),
1430=ReactiveEnergy_Tariff5("VArh"),
1431=ReactiveEnergy_Tariff6("VArh"),
1432=ReactiveEnergy_Tariff7("VArh"),
1433=ReactiveEnergy_Tariff8("VArh"),
1434=ReactiveEnergyCap_Tariff5("VArh"),
1435=ReactiveEnergyCap_Tariff6("VArh"),
1436=ReactiveEnergyCap_Tariff7("VArh"),
30
Smart Energy &
Power Quality Solutions
31