database

Database plugin, mit Unterstützung für SQLite 3 und MySQL.

Verwenden Sie dieses Plugin, um das Log der Elementwerte in einer Datenbank zu speichern. Es unterstützt verschiedene Datenbanken, die eine Python DB API 2 <http://www.python.org/dev/peps/pep-0249/>`_ Implementierung bereitstellen (z. B. SQLite welches bereits mit Python oder MySQL gebundeled ist, und über das Implementierungsmodul verwendet wird).

Use this plugin to store the log of item values into a database. It supports different databases which provides a [Python DB API 2](http://www.python.org/dev/peps/pep-0249/) implementation (e.g. [SQLite](http://docs.python.org/3.2/library/sqlite3.html) which is already bundled with Python or MySQL by using a [implementation module](https://wiki.python.org/moin/MySQL)).

Konfiguration

Die Informationen zur Konfiguration des Plugins sind unter Plugin ‚database‘ Konfiguration beschrieben.

Wichtig

Falls mehrere Instanzen des Plugins konfiguriert werden sollen, ist darauf zu achten, dass für eine der Instanzen KEIN instance Attribut konfiguriert werden darf, da sonst die Systemdaten nicht gespeichert werden und Abfragen aus dem Admin Interface und der smartVISU ins Leere laufen und Fehlermeldungen produzieren.

Web Interface

Das database Plugin verfügt über ein Webinterface, mit dessen Hilfe die Items die das Plugin nutzen übersichtlich dargestellt werden.

Wichtig

Das Webinterface des Plugins kann mit SmartHomeNG v1.4.2 und davor nicht genutzt werden. Es wird dann nicht geladen. Diese Einschränkung gilt nur für das Webinterface. Ansonsten gilt für das Plugin die in den Metadaten angegebene minimale SmartHomeNG Version.

Aufruf des Webinterfaces

Das Plugin kann aus dem Admin Interface aufgerufen werden. Dazu auf der Seite Plugins in der entsprechenden Zeile das Icon in der Spalte Web Interface anklicken.

Außerdem kann das Webinterface direkt über http://smarthome.local:8383/database bzw. http://smarthome.local:8383/database_<Instanz> aufgerufen werden.

Beispiele

Folgende Informationen können im Webinterface angezeigt werden:

Oben rechts werden allgemeine Parameter zum Plugin angezeigt.

Im ersten Tab werden die Items angezeigt, die das database Plugin nutzen:

../../_images/webif13.jpg

Auf der Detailseite zu den Item Einträgen werden die geloggten Werte angezeigt:

../../_images/webif1_1.jpg

Aufbau der Datenbank

Das Plugin erzeugt folgende Datenbank Struktur:

  • Table item - the item table contains all items and thier last known value

  • Table log - the history log of the item values

Die item Tabelle enthält die folgenden Columns:

  • Column id - a unique ID which is incremented by one for each new item

  • Column name - the item’s ID / name

  • Column time - the unix timestamp in microseconds of last change

  • Column val_str - the string value if type is str

  • Column val_num - the number value if type is num

  • Column val_bool - the boolean value if type is bool or num

  • Column changed - the unix timestamp in microseconds of record change

Die log Tabelle enthält die folgenden Columns:

  • Column time - the unix timestamp in microseconds of value

  • Column item_id - the reference to the unique ID in item table

  • Column duration - the duration in microseconds

  • Column val_str - the string value if type is str

  • Column val_num - the number value if type is num

  • Column val_bool - the boolean value if type is bool or num

  • Column changed - the unix timestamp in microseconds of record change