diff --git a/contrib/DS_Starter/93_DbRep.pm b/contrib/DS_Starter/93_DbRep.pm
index 80058c58c..47ed01166 100644
--- a/contrib/DS_Starter/93_DbRep.pm
+++ b/contrib/DS_Starter/93_DbRep.pm
@@ -1107,8 +1107,7 @@ sub DbRep_Get {
$ret .= "";
}
- # Notes
- if(!$prop || $prop =~ /rel/) {
+ if(!$prop || $prop =~ /rel/) { # Notes
$ret .= sprintf("
$header
");
$ret .= "
";
$ret .= "";
@@ -1119,8 +1118,7 @@ sub DbRep_Get {
$ret .= sprintf("$key | $val0 | $val1 | " );
$ret .= "";
$i++;
- if ($i & 1) {
- # $i ist ungerade
+ if ($i & 1) { # $i ist ungerade
$ret .= "";
} else {
$ret .= "
";
@@ -13436,7 +13434,7 @@ return;
- dbstatus - lists global informations about MySQL server status (e.g. informations related to cache, threads, bufferpools, etc. ).
+ dbstatus - lists global information about MySQL server status (e.g. informations related to cache, threads, bufferpools, etc. ).
Initially all available informations are reported. Using the attribute "showStatus" the quantity of
results can be limited to show only the desired values. Further detailed informations of items meaning are
explained there.
@@ -13452,8 +13450,20 @@ return;
sqlCmdBlocking <SQL-statement> -
- Executes the specified SQL-statement in blocking manner. Because of its mode of operation
- this function is particular convenient for user own perl scripts.
+ Executes the specified SQL-statement in blocking manner.
+
+
+
+
+ Examples:
+ { fhem("get <name> sqlCmdBlocking select device,count(*) from history where timestamp > '2018-04-01' group by device") }
+ { CommandGet(undef,"Rep.LogDB1 sqlCmdBlocking select device,count(*) from history where timestamp > '2018-04-01' group by device") }
+ get <name> sqlCmdBlocking select device,count(*) from history where timestamp > '2018-04-01' group by device
+
+
+
+
+ Because of its mode of operation this function is particular convenient for user own perl scripts.
The input accepts multi line commands and delivers multi line results as well.
This command also accept the setting of SQL session variables like "SET @open:=NULL,
@closed:=NULL;".
@@ -13461,15 +13471,6 @@ return;
by attribute "sqlResultFieldSep" (default "|"). Several result lines
are separated by newline ("\n").
This function only set/update status readings, the userExitFn function isn't called.
-
-
-
- Examples:
- { fhem("get <name> sqlCmdBlocking select device,count(*) from history where timestamp > '2018-04-01' group by device") }
- { CommandGet(undef,"Rep.LogDB1 sqlCmdBlocking select device,count(*) from history where timestamp > '2018-04-01' group by device") }
- get <name> sqlCmdBlocking select device,count(*) from history where timestamp > '2018-04-01' group by device
-
-
If you create a little routine in 99_myUtils, for example:
@@ -13568,23 +13569,28 @@ sub dbval {
versionNotes [hints | rel | <key>] -
- Shows realease informations and/or hints about the module. It contains only main release
- informations for module users.
- If no options are specified, both release informations and hints will be shown. "rel" shows
- only release informations and "hints" shows only hints. By the <key>-specification only
- the hint with the specified number is shown.
+ Shows realease informations and/or hints about the module.
+
-
-
- rel | : zeigt nur Release Informationen |
- hints | : zeigt nur Hinweise an |
- <key> | : es wird der Hinweis mit der angegebenen Nummer angezeigt |
-
+
+
+ rel | : shows only release information |
+ hints | : shows only hints |
+ <key> | : the note with the specified number is displayed |
+
-
+
+
+
+
+ It contains only main release informations for module users.
+ If no options are specified, both release informations and hints will be shown. "rel" shows
+ only release informations and "hints" shows only hints. By the <key>-specification only
+ the hint with the specified number is shown.
+
@@ -14634,23 +14640,24 @@ sub bdump {
+
- adminCredentials <User> <Passwort>
- Speichert einen User / Passwort für den privilegierten bzw. administrativen
Datenbankzugriff. Er wird bei Datenbankoperationen benötigt, die mit einem privilegierten User
ausgeführt werden müssen. Siehe auch Attribut 'useAdminCredentials'.
(nur gültig bei Datenbanktyp MYSQL und DbRep-Typ "Client")
-
-
+
+
- averageValue [display | writeToDB | writeToDBSingle | writeToDBInTime]
- berechnet einen Durchschnittswert des Datenbankfelds "VALUE" in den Zeitgrenzen
der möglichen time.*-Attribute.
-
+
+
Es muss das auszuwertende Reading im Attribut reading
angegeben sein.
Mit dem Attribut averageCalcForm wird die Berechnungsvariante zur
- Mittelwertermittlung definiert.
-
+ Mittelwertermittlung definiert.
Ist keine oder die Option display angegeben, werden die Ergebnisse nur angezeigt. Mit
den Optionen writeToDB, writeToDBSingle bzw. writeToDBInTime werden die Berechnungsergebnisse
mit einem neuen Readingnamen in der Datenbank gespeichert.
@@ -14664,7 +14671,7 @@ sub bdump {
-
+
Der neue Readingname wird aus einem Präfix und dem originalen Readingnamen gebildet,
wobei der originale Readingname durch das Attribut "readingNameMap" ersetzt werden kann.
Der Präfix setzt sich aus der Bildungsfunktion und der Aggregation zusammen.
@@ -14698,38 +14705,42 @@ sub bdump {
-
+
+
cancelDump - bricht einen laufenden Datenbankdump ab.
+
changeValue - ändert den gespeicherten Wert eines Readings.
- Ist die Selektion auf bestimmte Device/Reading-Kombinationen durch die
- Attribute "device" bzw. "reading" beschränkt, werden sie genauso
+ Ist die Selektion auf bestimmte Device/Reading-Kombinationen durch die Attribute
+ device bzw. reading beschränkt, werden sie genauso
berücksichtigt wie gesetzte Zeitgrenzen (Attribute time.*).
Fehlen diese Beschränkungen, wird die gesamte Datenbank durchsucht und der angegebene Wert
geändert.
+
- Syntax:
- set <name> changeValue "<alter String>","<neuer String>"
+ Syntax:
+ set <name> changeValue "<alter String>","<neuer String>"
- Die Strings werden in Doppelstrich eingeschlossen und durch Komma getrennt.
- Dabei kann "String" sein:
+ "String" kann sein:
-
-
- <alter String> : | - ein einfacher String mit/ohne Leerzeichen, z.B. "OL 12"
+
+
+ <alter String> : | - ein einfacher String mit/ohne Leerzeichen, z.B. "OL 12"
- ein String mit Verwendung von SQL-Wildcard, z.B. "%OL%"
|
- | |
- | |
- <neuer String> : | - ein einfacher String mit/ohne Leerzeichen, z.B. "12 kWh"
- - Perl Code eingeschlossen in "{}" inkl. Quotes, z.B. "{($VALUE,$UNIT) = split(" ",$VALUE)}".
+
| |
+ | |
+ <neuer String> : | - ein einfacher String mit/ohne Leerzeichen, z.B. "12 kWh"
+ - Perl Code eingeschlossen in "{}" inkl. Quotes, z.B. "{($VALUE,$UNIT) = split(" ",$VALUE)}".
Dem Perl-Ausdruck werden die Variablen $VALUE und $UNIT übergeben. Sie können innerhalb
des Perl-Code geändert werden. Der zurückgebene Wert von $VALUE und $UNIT wird in dem Feld
VALUE bzw. UNIT des Datensatzes gespeichert.
|
- |
+ |
+
-
+
+
Beispiele:
set <name> changeValue "OL","12 OL"
# der alte Feldwert "OL" wird in "12 OL" geändert.
@@ -14764,18 +14775,21 @@ sub bdump {
Hinweis:
Obwohl die Funktion selbst non-blocking ausgelegt ist, sollte das zugeordnete DbLog-Device
im asynchronen Modus betrieben werden um ein Blockieren von FHEMWEB zu vermeiden (Tabellen-Lock).
-
+
-
+
+
countEntries [history | current]
- liefert die Anzahl der Tabelleneinträge (default: history) in den gegebenen
Zeitgrenzen (siehe Attribute).
Sind die Timestamps nicht gesetzt, werden alle Einträge der Tabelle gezählt.
- Beschränkungen durch die Attribute Device bzw. Reading
+ Beschränkungen durch die Attribute device bzw. reading
gehen in die Selektion mit ein.
+
+
Standardmäßig wird die Summe aller Datensätze, gekennzeichnet mit "ALLREADINGS", erstellt.
Ist das Attribut "countEntriesDetail" gesetzt, wird die Anzahl jedes einzelnen Readings
- zusätzlich ausgegeben.
+ zusätzlich ausgegeben.
Die für diese Funktion relevanten Attribute sind:
@@ -14793,14 +14807,16 @@ sub bdump {
-
-
+
+
+
delDoublets [adviceDelete | delete] - zeigt bzw. löscht doppelte / mehrfach vorkommende Datensätze.
Dazu wird Timestamp, Device,Reading und Value ausgewertet.
Die Attribute zur Aggregation,Zeit-,Device- und Reading-Abgrenzung werden dabei
berücksichtigt. Ist das Attribut "aggregation" nicht oder auf "no" gesetzt, wird im Standard die Aggregation
"day" verwendet.
+
@@ -14811,16 +14827,16 @@ sub bdump {
- Aus Sicherheitsgründen muss das Attribut "allowDeletion" für die "delete" Option
+ Aus Sicherheitsgründen muss das Attribut allowDeletion für die "delete" Option
gesetzt sein.
Die Anzahl der anzuzeigenden Datensätze des Kommandos "delDoublets adviceDelete" ist zunächst
- begrenzt (default 1000) und kann durch das Attribut "limit" angepasst
+ begrenzt (default 1000) und kann durch das Attribut limit angepasst
werden.
Die Einstellung von "limit" hat keinen Einfluss auf die "delDoublets delete" Funktion, sondern
beeinflusst NUR die Anzeige der Daten.
Vor und nach der Ausführung von "delDoublets" kann ein FHEM-Kommando bzw. Perl-Routine ausgeführt
- werden. (siehe Attribute "executeBeforeProc", "executeAfterProc")
-
+ werden. (siehe Attribute executeBeforeProc, executeAfterProc)
+
Beispiel:
@@ -14853,9 +14869,7 @@ sub bdump {
-
-
-
+
delEntries [<no>[:<nn>]] - löscht alle oder die durch die Attribute device und/oder
reading definierten Datenbankeinträge. Die Eingrenzung über Timestamps erfolgt
@@ -16067,8 +16081,8 @@ sub bdump {
Beispiel
- get <name> dbstatus
- attr <name> showStatus %uptime%,%qcache%
+ attr <name> showStatus %uptime%,%qcache%
+ get <name> dbstatus
# Es werden nur Readings erzeugt die im Namen "uptime" und "qcache" enthaltenen
@@ -16077,19 +16091,6 @@ sub bdump {
sqlCmdBlocking <SQL-Statement> -
Führt das angegebene SQL-Statement blockierend mit einem Standardtimeout von 10 Sekunden aus.
- Der Timeout kann mit dem Attribut timeout verändert werden.
-
-
- Diese Funktion ist durch ihre Arbeitsweise
- speziell für den Einsatz in benutzerspezifischen Scripten geeignet.
- Die Eingabe akzeptiert Mehrzeiler und gibt ebenso mehrzeilige Ergebisse zurück.
- Dieses Kommando akzeptiert ebenfalls das Setzen von SQL Session Variablen wie z.B.
- "SET @open:=NULL, @closed:=NULL;".
- Werden mehrere Felder selektiert und zurückgegeben, erfolgt die Feldtrennung mit dem Trenner
- des Attributes "sqlResultFieldSep" (default "|"). Mehrere Ergebniszeilen
- werden mit Newline ("\n") separiert.
- Diese Funktion setzt/aktualisiert nur Statusreadings, die Funktion im Attribut "userExitFn"
- wird nicht aufgerufen.
@@ -16099,6 +16100,20 @@ sub bdump {
get <name> sqlCmdBlocking select device,count(*) from history where timestamp > '2018-04-01' group by device
+
+
+ Der Timeout kann mit dem Attribut
timeout verändert werden.
+
+
+ Diese Funktion ist durch ihre Arbeitsweise speziell für den Einsatz in benutzerspezifischen Scripten geeignet.
+ Die Eingabe akzeptiert Mehrzeiler und gibt ebenso mehrzeilige Ergebisse zurück.
+ Dieses Kommando akzeptiert ebenfalls das Setzen von SQL Session Variablen wie z.B.
+ "SET @open:=NULL, @closed:=NULL;".
+ Werden mehrere Felder selektiert und zurückgegeben, erfolgt die Feldtrennung mit dem Trenner
+ des
Attributes "sqlResultFieldSep" (default "|"). Mehrere Ergebniszeilen
+ werden mit Newline ("\n") separiert.
+ Diese Funktion setzt/aktualisiert nur Statusreadings, die Funktion im Attribut "userExitFn"
+ wird nicht aufgerufen.
Erstellt man eine kleine Routine in 99_myUtils, wie z.B.:
@@ -16132,8 +16147,8 @@ sub dbval {
Beispiel
- get <name> dbvars
- attr <name> showVariables %version%,%query_cache%
+ attr <name> showVariables %version%,%query_cache%
+ get <name> dbvars
# Es werden nur Readings erzeugt die im Namen "version" und "query_cache" enthalten
@@ -16173,8 +16188,8 @@ sub dbval {
Beispiel
- get <name> svrinfo
- attr <name> showSvrInfo %SQL_CATALOG_TERM%,%NAME%
+ attr <name> showSvrInfo %SQL_CATALOG_TERM%,%NAME%
+ get <name> svrinfo
# Es werden nur Readings erzeugt die im Namen "SQL_CATALOG_TERM" und "NAME" enthalten
@@ -16188,8 +16203,8 @@ sub dbval {
Beispiel
- get <name> tableinfo
- attr <name> showTableInfo current,history
+ attr <name> showTableInfo current,history
+ get <name> tableinfo
# Es werden nur Information der Tabellen "current" und "history" angezeigt
@@ -16197,9 +16212,7 @@ sub dbval {
versionNotes [hints | rel | <key>] -
- Zeigt Release Informationen und/oder Hinweise zum Modul an. Es sind nur Release Informationen mit
- Bedeutung für den Modulnutzer enthalten.
- Sind keine Optionen angegben, werden sowohl Release Informationen als auch Hinweise angezeigt.
+ Zeigt Release Informationen und/oder Hinweise zum Modul an.
@@ -16211,7 +16224,12 @@ sub dbval {
-
+
+
+
+ Sind keine Optionen angegeben, werden sowohl Release Informationen als auch Hinweise angezeigt.
+ Es sind nur Release Informationen mit Bedeutung für den Modulnutzer enthalten.
+