SQL-Protokollierung

Dieser Adapter speichert den Statusverlauf in einer SQL-Datenbank.

Unterstützt PostgreSQL, MySQL, Microsoft SQL Server und SQLite. Sie können Port 0 beibehalten, wenn der Standardport verwendet werden soll.

Einstellungen

Verbindungseinstellungen

• DB-Typ : Typ der SQL-Datenbank: MySQL, PostgreSQL, MS-SQL oder SQLite3
• Host : IP-Adresse oder Hostname mit SQL Server
• Unix-Socket (nur MySQL): Pfad eines lokalen Unix-Sockets, z. B. /var/run/mysqld/mysqld.sock Ist diese Option aktiviert, verbindet sich der Adapter über diesen Socket und ignoriert Host und Port, da diese ausgeblendet sind. Dies ist nützlich, wenn der Server auf demselben Rechner läuft – es ist schneller als TCP – und die einzige Möglichkeit, von einem Container in einem Macvlan-Netzwerk auf eine Datenbank auf dem Docker-Host zuzugreifen.
• Port : Port des SQL-Servers (bei Unsicherheit leer lassen)
• Datenbankname : Datenbankname. Standardmäßig iobroker
• Benutzer : Benutzername für SQL. Muss in der Datenbank vorhanden sein.
• Passwort : Passwort für SQL.
• Passwortbestätigung : Bitte wiederholen Sie hier Ihr Passwort.
• Verschlüsseln : Einige Datenbanken unterstützen Verschlüsselung.
• Runde die Zahl auf : Anzahl der Ziffern nach dem Komma.
• Parallele Anfragen zulassen : Gleichzeitige SQL-Anfragen an die Datenbank zulassen.
• Der Reiter „Statistiken “ listet alle IDs in der Datenbank mit Speichertyp, Status (angemeldet/abgemeldet/gelöscht), Anzahl der Werte, geschätzter Größe und dem abgedeckten Zeitraum auf. Die Schaltfläche „Bereinigen“ zeigt zunächst die zu löschenden Einträge an und entfernt sie erst nach Bestätigung. Status, bei denen die Protokollierung deaktiviert ist, werden standardmäßig ausgeschlossen, sofern Sie das entsprechende Kontrollkästchen nicht aktivieren, da deren Verlauf weiterhin abrufbar und möglicherweise relevant ist.
• Datenbank nicht erstellen : Aktivieren Sie diese Option, wenn bereits eine Datenbank erstellt wurde (z. B. vom Administrator) und der ioBroker-Benutzer nicht über ausreichende Rechte zum Erstellen einer Datenbank verfügt.

Standardeinstellungen

• Entprellzeit – Schutz vor instabilen Werten, um sicherzustellen, dass nur stabile Werte protokolliert werden, wenn sich der Wert innerhalb der definierten Millisekunden nicht geändert hat. ACHTUNG: Ändern sich die Werte häufiger als in dieser Einstellung festgelegt, wird kein Wert protokolliert (da jeder Wert instabil ist).
• Blockzeit – Definiert, wie lange nach dem Speichern des letzten Werts kein weiterer Wert gespeichert wird. Nach Ablauf der angegebenen Zeit in Millisekunden wird der nächste Wert protokolliert, der alle anderen Bedingungen erfüllt.
• Nur Änderungen protokollieren – Diese Funktion stellt sicher, dass nur geänderte Werte protokolliert werden, sofern sie weitere Prüfungen bestehen (siehe unten). Gleiche Werte werden nicht protokolliert.
• Die gleichen Werte (Sekunden) werden weiterhin protokolliert – Bei Verwendung von „Nur Änderungen protokollieren“ können Sie hier ein Zeitintervall in Sekunden festlegen, nach dem auch unveränderte Werte erneut in der Datenbank protokolliert werden. Die vom Adapter erneut protokollierten Werte können Sie im Feld „von“ erkennen.
• Minimale Abweichung vom letzten Wert – Bei der Option „Nur Änderungen aufzeichnen“ können Sie die erforderliche minimale Abweichung zwischen dem neuen Wert und dem letzten Wert festlegen. Wird diese Abweichung nicht erreicht, wird der Wert nicht aufgezeichnet.
• Nullwerte ignorieren (==0) - Sie können festlegen, ob Nullwerte ignoriert werden sollen.
• Werte unter Null ignorieren (<0) - Sie können festlegen, ob Werte unter Null ignoriert werden sollen.
• Deaktivierung der optimierten Protokollierung übersprungener Werte für die Diagrammerstellung – Standardmäßig versucht der Adapter, die Werte für die optimierte Diagrammerstellung zu erfassen. Dies kann bedeuten, dass zusätzliche Werte (die z. B. nicht alle oben genannten Prüfungen erfüllt haben) automatisch protokolliert werden. Wenn dies nicht gewünscht ist, können Sie diese Funktion deaktivieren.
• Alias-ID – Sie können einen Alias für die ID definieren. Dies ist hilfreich, wenn Sie ein Gerät gewechselt haben und eine kontinuierliche Datenprotokollierung wünschen. Bitte erwägen Sie zukünftig die Verwendung echter Alias-Status!
• Speicherdauer – Wie viele Werte aus der Vergangenheit auf der Festplatte gespeichert werden. Daten werden gelöscht, sobald die festgelegte Zeit erreicht ist und neue Daten für einen Datenpunkt gespeichert werden sollen.
• Maximale Anzahl im RAM speichern – Legen Sie fest, wie viele Werte im RAM gespeichert werden, bevor sie auf der Festplatte abgelegt werden. Sie können so den Umfang der E/A-Operationen steuern.
• Erweiterte Debug-Protokolle für den Datenpunkt aktivieren – Wenn Sie detailliertere Protokolle für diesen Datenpunkt anzeigen möchten, können Sie diese Option aktivieren. Sie müssen weiterhin den Protokollierungsgrad „Debug“ aktivieren, damit diese zusätzlichen Werte sichtbar sind! Dies hilft bei der Fehlersuche oder beim Verständnis, warum der Adapter einen Wert protokolliert (oder nicht).

Die meisten dieser Werte können in den Instanzeinstellungen vordefiniert werden und werden dann vorausgefüllt oder für den Datenpunkt verwendet.

Tipps zur Datenbankinstallation

MS-SQL:

Verwenden localhost\instance Prüfen Sie auf dem Host, ob TCP/IP-Verbindungen aktiviert sind. https://msdn.microsoft.com/en-us/library/bb909712(v=vs.90).aspx

SQLite:

Es handelt sich um eine dateibasierte Datenbank, die nicht mit einer großen Anzahl von Ereignissen umgehen kann. Bei großen Datenmengen sollten Sie eine herkömmliche Datenbank wie PostgreSQL oder ähnliche verwenden.

Die SQLite-Datenbank muss nicht separat installiert werden. Sie ist lediglich eine Datei auf der Festplatte, für deren Installation Sie jedoch die entsprechenden Build-Tools auf Ihrem System benötigen. Unter Linux geben Sie einfach Folgendes ein:

sudo apt-get install build-essential

Installieren Sie unter Windows Node.js mit der Option „Automatisch die notwendigen Tools installieren…“ und installieren Sie anschließend den Adapter neu, z. B.:

cd /opt/iobroker
iobroker stop sql
npm install iobroker.sql --production
iobroker start sql

MySQL:

Sie können MySQL auf Linux-Systemen wie folgt installieren:

apt-get install mysql-server mysql-client

mysql -u root -p

CREATE USER 'iobroker'@'%' IDENTIFIED BY 'iobroker';
GRANT ALL PRIVILEGES ON * . * TO 'iobroker'@'%';
FLUSH PRIVILEGES;

Bearbeiten Sie gegebenenfalls die Datei /etc/mysql/my.cnf , um die Bindung an die IP-Adresse für die Remote-Verbindung festzulegen.

Warnung : Der Benutzer iobroker hat die Rechte „admin“. Falls erforderlich, sollten dem Benutzer iobroker eingeschränkte Rechte gewährt werden.

Unter Windows kann es einfach über den Installer installiert werden: https://dev.mysql.com/downloads/installer/ .

Beachten Sie die Authentifizierungsmethode. Der neue Verschlüsselungsalgorithmus in MySQL 8.0 wird noch nicht unterstützt. node.js und Sie müssen die Legacy-Authentifizierungsmethode auswählen.

Struktur der Datenbanken

Der Standarddatenbankname lautet: iobroker Das kann aber in der Konfiguration geändert werden.

Quellen

Diese Tabelle ist eine Liste der Adapterinstanzen, die die Einträge geschrieben haben. (state.from)

Struktur:

Hinweis: MS-SQL verwendet varchar(255), andere Datenbanken verwenden TEXT.

Datenpunkte

Diese Tabelle ist eine Liste von Datenpunkten (IDs).

Struktur:

Hinweis: MS-SQL verwendet varchar(255), andere Datenbanken verwenden TEXT.

Zahlen

Werte für Zustände vom Typ „Zahl“. ts bedeutet „Zeitreihe“.

Struktur:

Hinweis: MS-SQL verwendet BIT, andere SQL-Server verwenden BOOLEAN. SQLite verwendet für ts INTEGER und für alle anderen Datentypen BIGINT.

Der Benutzer kann zusätzliche Angaben zum Typ definieren. number die Funktionalität von counters Zu diesem Zweck wird die folgende Tabelle erstellt:

Struktur:

Diese Tabelle speichert die Werte, wenn der Zähler ausgetauscht wurde und der Wert sich nicht erhöht, sondern nicht auf Null oder einen niedrigeren Wert gesunken ist.

Saiten

Werte für Zustände vom Typ string Die

Struktur:

Hinweis: MS-SQL verwendet BIT, andere SQL-Server verwenden BOOLEAN. SQLite verwendet für ts INTEGER und für alle anderen Datentypen BIGINT.

Boolesche Werte

Werte für Zustände vom Typ boolean Die

Struktur:

Hinweis: MS-SQL verwendet BIT, andere SQL-Server verwenden BOOLEAN. SQLite verwendet für ts INTEGER und für alle anderen Datentypen BIGINT.

Werte über den JavaScript-Adapter abrufen

Auf die sortierten Werte kann über den JavaScript-Adapter zugegriffen werden.

• Rufe die 50 zuletzt gespeicherten Ereignisse für alle IDs ab.

sendTo('sql.0', 'getHistory', {
    id: '*',
    options: {
        end:       Date.now(),
        count:     50,
        aggregate: 'onchange',
        addId: true
    }
}, function (result) {
    for (var i = 0; i < result.result.length; i++) {
        console.log(result.result[i].id + ' ' + new Date(result.result[i].ts).toISOString());
    }
});

• Gespeicherte Werte für "system.adapter.admin.0.memRss" der letzten Stunde abrufen

var end = Date.now();
sendTo('sql.0', 'getHistory', {
    id: 'system.adapter.admin.0.memRss',
    options: {
        start:      end - 3600000,
        end:        end,
        aggregate: 'onchange',
        addId: true
    }
}, function (result) {
    for (var i = 0; i < result.result.length; i++) {
        console.log(result.result[i].id + ' ' + new Date(result.result[i].ts).toISOString());
    }
});

Mögliche Optionen:

• Start - (optional) Zeit in ms - Date.now()
• Ende - (optional) Zeit in ms - Date.now() , standardmäßig ist (now + 5000 seconds)
• Schritt - (optional) wird in aggregierten Werten (Maximum, Minimum, Durchschnitt, Gesamt, ...) verwendet. Schrittweite in Millisekunden der Intervalle.
• Anzahl – Anzahl der Werte, wenn die Aggregation auf „onchange“ eingestellt ist, oder Anzahl der Intervalle bei anderen Aggregationsmethoden. Die Anzahl wird ignoriert, wenn eine Schrittweite festgelegt ist; andernfalls ist der Standardwert 500.
• Von - falls das Feld " Von " in die Antwort aufgenommen werden soll
• ack - falls das ack- Feld in die Antwort aufgenommen werden soll
• q - falls das Feld q in die Antwort aufgenommen werden soll
• addId – falls das ID- Feld in die Antwort aufgenommen werden soll
• Limit – Es werden nicht mehr Einträge zurückgegeben als das Limit.
• runden - Ergebnis auf die gewünschte Anzahl von Nachkommastellen runden
• ignoreNull - Gibt an, ob Nullwerte eingeschlossen (false), durch den letzten nicht-nullen Wert ersetzt (true) oder durch 0 (0) ersetzt werden sollen.
• removeBorderValues – Standardmäßig werden zusätzliche Rahmenwerte zurückgegeben, um die Diagrammdarstellung zu optimieren. Setzen Sie diese Option auf „true“, wenn dies nicht gewünscht ist (z. B. bei der Skriptdatenverarbeitung).
• returnNewestEntries – Die zurückgegebenen Daten sind immer aufsteigend nach Zeitstempel sortiert. Bei Verwendung von „none“ für die Aggregation und gleichzeitiger Angabe von „count“ oder „limit“ werden normalerweise die ältesten Einträge zurückgegeben (sofern keine Startdaten angegeben sind). Setzen Sie diese Option auf „true“, um stattdessen die neuesten Einträge zu erhalten.
• Aggregation - Aggregationsmethode (Standard: average):
  • minmax – verwendet einen speziellen Algorithmus. Der gesamte Zeitbereich wird in kleine Intervalle unterteilt, und für jedes Intervall werden Maximal-, Minimal-, Start- und Endwerte ermittelt.
  • max - Teile den gesamten Zeitbereich in kleine Intervalle auf und ermittle für jedes Intervall den Maximalwert, der dann für dieses Intervall verwendet wird (Nullwerte werden ignoriert).
  • min - Gleiches gilt wie max, jedoch mit dem Minimalwert.
  • Durchschnitt - Dasselbe wie Maximum, nur dass der Durchschnittswert verwendet wird.
  • total - Gleiches gilt für max, aber Berechnung des Gesamtwerts.
  • count - Gleiches wie max, aber Anzahl der Werte wird berechnet (Nullwerte werden mitgezählt).
  • Perzentil - Berechne das n-te Perzentil (n ist gegeben in options.percentile (oder standardmäßig 50, falls nicht angegeben).
  • Quantil - Berechne das n-Quantil (n ist gegeben in options.quantile (oder standardmäßig 0,5, falls nicht angegeben).
  • Integral - Integral berechnen (weitere Parameter siehe unten).
  • keine – Es erfolgt keinerlei Aggregation. Nur Rohwerte in einem bestimmten Zeitraum.
• Perzentil - (optional) Bei Verwendung der Aggregationsmethode definiert "Perzentil" die Perzentilebene (0..100) (Standardwert: 50)
• Quantil - (optional) Bei Verwendung der Aggregationsmethode definiert "Quantil" das Quantilniveau (0..1) (Standardwert: 0,5).
• integralUnit – (optional) Bei Verwendung der Aggregationsmethode „integral“ definiert dieser Parameter die Einheit in Sekunden (Standardwert: 60 Sekunden). Um beispielsweise das Integral in Stunden für Wh oder Ähnliches zu erhalten, setzen Sie den Wert auf 3600.
• integralInterpolation - (optional) Bei Verwendung der Aggregationsmethode definiert "integral" die Interpolationsmethode (Standardwert ist "none").
  • lineare - lineare Interpolation
  • keine - keine/schrittweise Interpolation

Bei Aggregationen werden der erste und der letzte Punkt berechnet, außer bei der Aggregation none Wenn Sie manuell eine Aggregation anfordern, sollten Sie den ersten und letzten Wert ignorieren, da diese aus Werten außerhalb eines Zeitraums berechnet werden.

Zähler abrufen

Der Benutzer kann den Wert eines Zählers (Typ=Zahl, Zähler=wahr) für einen bestimmten Zeitraum abfragen.

var now = Date.now();
// get consumption value for last 30 days
sendTo('sql.0', 'getCounter', {
    id: 'system.adapter.admin.0.memRss',
    options: {
        start:      now - 3600000 * 24 * 30,
        end:        now,
    }
}, result => {
    console.log(`In last 30 days the consumption was ${result.result} kWh`);    
});

Wird das Zählgerät ausgetauscht, wird dies ebenfalls berechnet.

Benutzerdefinierte Abfragen

Der Benutzer kann über den JavaScript-Adapter benutzerdefinierte Abfragen auf Tabellen ausführen:

sendTo('sql.0', 'query', 'SELECT * FROM datapoints', function (result) {
    if (result.error) {
        console.error(result.error);
    } else {
        // show result
         console.log('Rows: ' + JSON.stringify(result.result));
    }
});

Oder rufen Sie die Einträge der letzten Stunde für die ID=system.adapter.admin.0.memRss ab.

sendTo('sql.0', 'query', 'SELECT id FROM datapoints WHERE name="system.adapter.admin.0.memRss"', function (result) {
    if (result.error) {
        console.error(result.error);
    } else {
        // show result
        console.log('Rows: ' + JSON.stringify(result.result));
        var now = new Date();
        now.setHours(-1);
        sendTo('sql.0', 'query', 'SELECT * FROM ts_number WHERE ts >= ' + now.getTime() + ' AND id=' + result.result[0].id, function (result) {
            console.log('Rows: ' + JSON.stringify(result.result));
        });
    }
});

Notiz:

Je nach Datenbank muss entweder der Datenbankname oder der Datenbankname + das Schema vor dem Tabellennamen eingefügt werden – siehe die Kästchen oben unter „Struktur der Datenbanken“.

Beispiel, wenn Ihre Datenbank den Namen „iobroker“ trägt:

Datenbrowser

Die Instanzeinstellungen enthalten den Tab „Datenbrowser“ : Links werden alle Datenpunkte angezeigt, die Daten in der Datenbank enthalten, rechts die gespeicherten Werte des ausgewählten Datenpunkts. Die Werte können durchgeblättert, bearbeitet, gelöscht und durch neue ergänzt werden. Für diesen Tab ist eine laufende Instanz erforderlich.

Die Komponente ist eine JSON-Konfiguration custom Komponente. Ihre Quellen befinden sich in src-admin, das integrierte Paket in admin/custom ist verpflichtet:

npm run npm:admin      # install the dependencies of the component (only once)
npm run build:admin    # clean, build and copy into admin/custom
cd src-admin && npm start   # development server on http://localhost:4173

Die Datenpunktliste stammt aus der Nachricht getDatapoints , die auch in Skripten verwendet werden kann:

sendTo('sql.0', 'getDatapoints', {}, result => {
    // [{id: 'system.adapter.admin.0.memRss', index: 1, type: 'Number'}, ...]
    console.log(JSON.stringify(result.result));
});

Es gibt jeden Datenpunkt zurück datapoints Tabelle – einschließlich derer, deren Protokollierung deaktiviert ist – sortiert nach ID. Im Gegensatz zu getDpOverview Es ermittelt nicht den ersten Zeitstempel jedes Datenpunkts und antwortet sofort.

Rohwerte lesen

getHistory Diese Funktion ist für Diagramme konzipiert: Sie aggregiert, interpoliert, rundet und addiert die Werte direkt vor und nach dem angeforderten Bereich. Um die gespeicherten Zeilen genau so anzuzeigen und durchzublättern, wie sie in der Datenbank vorliegen, verwenden Sie getRawEntries .

sendTo(
    'sql.0',
    'getRawEntries',
    {
        id: 'system.adapter.admin.0.memRss',
        start: Date.now() - 3600000, // optional, inclusive
        end: Date.now(),             // optional, inclusive
        limit: 100,                  // optional, default 100, maximum 2000
        offset: 0,                   // optional, default 0
        sort: 'desc',                // optional, 'desc' (newest first, default) or 'asc'
    },
    result => {
        if (result.error) {
            console.error(result.error);
        } else {
            // total = number of all entries matching start/end, so a table can page through them
            console.log(`${result.result.length} of ${result.total} entries`);
            // [{ts: 1589458809352, val: 51.5, ack: 1, q: 0, from: 'system.adapter.admin.0'}, ...]
            console.log(JSON.stringify(result.result));
        }
    },
);

Die Antwort enthält außerdem id, index (die ID in der datapoints Tisch), type (Number, String oder Boolean), table (ts_number, ts_string oder ts_bool und die verwendeten limit, offset Und sort Die

Die Werte werden unverändert aus der Datenbank zurückgegeben: ack und boolesche Werte sind 0 /1 in den meisten Datenbanken, und val Ein String-Datenpunkt ist die gespeicherte Zeichenkette. from Ist null falls keine Quelle gespeichert wurde.

Wie update, delete Und storeState Dies funktioniert auch für Datenpunkte, deren Protokollierung deaktiviert ist, solange noch Einträge in der Datenbank vorhanden sind. Wenn der Datenpunkt unbekannt ist, enthält die Antwort einen error Die

storeState

Wenn Sie andere Daten in die SQL-Datenbank schreiben möchten, können Sie die integrierte Systemfunktion ` **storeState` ** verwenden. Diese Funktion kann auch verwendet werden, um Daten aus anderen History-Adaptern wie InfluxDB oder SQL zu konvertieren.

Eine erfolgreiche Antwort bedeutet nicht, dass die Daten tatsächlich auf die Festplatte geschrieben wurden. Es bedeutet lediglich, dass sie verarbeitet wurden!

Die angegebenen IDs werden nicht mit der ioBroker-Datenbank abgeglichen und müssen dort nicht eingerichtet oder aktiviert werden. Werden eigene IDs ohne Einstellungen verwendet, wird der Parameter „rules“ nicht unterstützt und führt zu einem Fehler. Für solche IDs wird der Standardwert „Maximale Anzahl im RAM gespeicherter Werte“ verwendet.

Die Nachricht kann eines der folgenden drei Formate haben:

1. ein ID- und ein Statusobjekt
2. eine ID und ein Array von Zustandsobjekten
3. Array mit mehreren IDs, wobei jede ID ein Zustandsobjekt enthält.

// 1.
sendTo('sql.0', 'storeState', {
    id: 'mbus.0.counter.xxx',
    state: {
        ts: 1589458809352,
        val: 123,
        ack: false,
        from: 'system.adapter.whatever.0'
    }
}, result => console.log('added'));

// 2.
sendTo('sql.0', 'storeState', {
    id: 'mbus.0.counter.xxx',
    state: [
        {
            ts: 1589458809352,
            val: 123,
            ack: false,
            from: 'system.adapter.whatever.0'
        },
        {
            ts: 1589458809353,
            val: 123,
            ack: false,
            from: 'system.adapter.whatever.0'
        }
    ]
}, result => console.log('added'));

// 3.
sendTo('sql.0', 'storeState', [
    {
        id: 'mbus.0.counter.xxx',
        state: {
            ts: 1589458809352,
            val: 123,
            ack: false,
            from: 'system.adapter.whatever.0'
        }
    },
    {
        id: 'mbus.0.counter.yyy',
        state: {
            ts: 1589458809353,
            val: 123,
            ack: false,
            from: 'system.adapter.whatever.0'
        }
    }
], result => console.log('added'));

Zusätzlich können Sie Attribute hinzufügen. rules: true in einer Nachricht zur Aktivierung aller Regeln, wie counter, changesOnly, de-bounce und so weiter.

Im Fehlerfall wird ein Array mit allen einzelnen Fehlermeldungen sowie eine Erfolgsanzahl zurückgegeben, um zu sehen, wie viele Einträge erfolgreich gespeichert wurden.

Löschstatus

Wenn Sie einen Eintrag aus der Datenbank löschen möchten, können Sie die integrierte Systemfunktion delete verwenden:

sendTo('sql.0', 'delete', [
    {id: 'mbus.0.counter.xxx', state: {ts: 1589458809352}}, 
    {id: 'mbus.0.counter.yyy', state: {ts: 1589458809353}},
], result => console.log('deleted'));

Um ALLE Verlaufsdaten für einen bestimmten Datenpunkt zu löschen, führen Sie Folgendes aus:

sendTo('sql.0', 'deleteAll', [
    {id: 'mbus.0.counter.xxx'}, 
    {id: 'mbus.0.counter.yyy'}
], result => console.log('deleted'));

Um Verlaufsdaten für einen bestimmten Datenpunkt und einen bestimmten Bereich zu löschen, führen Sie folgenden Befehl aus:

sendTo('sql.0', 'deleteRange', [
    {id: 'mbus.0.counter.xxx', start: '2019-01-01T00:00:00.000Z', end: '2019-12-31T23:59:59.999'}, 
    {id: 'mbus.0.counter.yyy', start: 1589458809352, end: 1589458809353}
], result => console.log('deleted'));

Die Zeitangabe kann in Millisekunden seit der Unix-Epoche oder als Zeichenkette vorliegen, die mithilfe eines JavaScript-Date-Objekts konvertiert werden kann.

Werte einschließlich definierter Grenzwerte werden gelöscht. ts >= start AND ts <= end

Alle drei Befehle akzeptieren auch einen einzelnen Datenpunkt als Objekt, z. B. sendTo('sql.0', 'deleteAll', {id: 'mbus.0.counter.xxx'}, result => ...) In diesem Fall wird die Antwort nach der Ausführung des Löschvorgangs gesendet und lautet entweder {success: true} oder {error: "..."} Bei einem Array wird die Antwort sofort gesendet und gibt keine Auskunft über die einzelnen Löschvorgänge.

Zustand ändern

Wenn Sie den Wert, die Qualität oder das Bestätigungsflag eines Eintrags in der Datenbank ändern möchten, können Sie die integrierte Systemfunktion update verwenden:

sendTo('sql.0', 'update', [
    {id: 'mbus.0.counter.xxx', state: {ts: 1589458809352, val: 15, ack: true, q: 0}}, 
    {id: 'mbus.0.counter.yyy', state: {ts: 1589458809353, val: 16, ack: true, q: 0}},
], result => console.log('deleted'));

ts ist obligatorisch. Mindestens ein weiteres Flag muss in einem Zustandsobjekt enthalten sein.

Sei vorsichtig mit counters. Der counters Die Datenbank wird nicht zurückgesetzt, Sie müssen dies selbst handhaben.

Verlaufsprotokollierung über Javascript

Der Adapter unterstützt das Aktivieren und Deaktivieren der Verlaufsprotokollierung über JavaScript sowie das Abrufen der Liste der aktivierten Datenpunkte mit ihren Einstellungen.

aktivieren

Die Nachricht erfordert die „ID“ des Datenpunkts. Zusätzlich sind optionale „Optionen“ zur Definition der datenpunktspezifischen Einstellungen verfügbar.

sendTo('sql.0', 'enableHistory', {
    id: 'system.adapter.sql.0.memRss',
    options: {
        changesOnly:  true,
        debounce:     0,
        retention:    31536000,
        maxLength:    3,
        changesMinDelta: 0.5,
        aliasId: ''
    }
}, function (result) {
    if (result.error) {
        console.log(result.error);
    }
    if (result.success) {
        //successful enabled
    }
});

deaktivieren

Für die Meldung wird die "ID" des Datenpunkts benötigt.

sendTo('sql.0', 'disableHistory', {
    id: 'system.adapter.sql.0.memRss',
}, function (result) {
    if (result.error) {
        console.log(result.error);
    }
    if (result.success) {
        // successful enabled
    }
});

Liste abrufen

Die Nachricht enthält keine Parameter.

sendTo('sql.0', 'getEnabledDPs', {}, function (result) {
    //result is object like:
    console.log({
        "system.adapter.sql.0.memRss": {
            "changesOnly":true,
            "debounce":0,
            "retention":31536000,
            "maxLength":3,
            "changesMinDelta":0.5,
            "enabled":true,
            "changesRelogInterval":0,
            "aliasId": ""
        },
        // ...
    });
});

Changelog

4.2.0 (2026-10-03)

• (@GermanBluefox) npm run build:ts no longer needs the optional mysql2 and sqlite3 drivers to be installed
• (@GermanBluefox) Fixed buffered values being lost when the adapter stops, and unload no longer hangs when there is nothing else to write (#577)
• (@GermanBluefox) getCounter no longer reads the NULL boundary marker that writeNulls stores on start and stop as a zero counter value (#577)
• (@GermanBluefox) Fixed "Test connection" reporting a failure for a working configuration: the request was built as a text template that could produce invalid JSON, and it left out dbname, doNotCreateDatabase and the docker settings (#355)
• (@GermanBluefox) "Record changes only" now compares the value instead of the controller's last-change timestamp, so an alias with a read converter no longer stores a row per source change (#295)
• (@GermanBluefox) Added a statistics tab listing every logged ID with its number of values and estimated size (#247)
• (@GermanBluefox) Added a cleanup for datapoints that are no longer logged, with a confirmation dialog showing what would be deleted (#247)
• (@GermanBluefox) The Counter must have type "number" error now names the datapoint and is logged once instead of for every value (#320)
• (@DutchmanNL) PostgreSQL: "do not create database" now connects straight to the configured database instead of opening the maintenance database postgres first, so roles without CONNECT on it can be used
• (@GermanBluefox) MySQL can now connect through a unix socket instead of host and port (#104)
• (@DutchmanNL) Fixed info.connection staying true while the database was unreachable
• (@GermanBluefox) Fixed crash (UNCAUGHT_EXCEPTION) when the database server closes the connection: the driver's error event had no listener (#527)
• (@GermanBluefox) A connection that the server dropped is now replaced instead of being handed out again

4.1.6 (2026-10-01)

• (@DutchmanNL) Fixed getCounter on PostgreSQL: the queries used MySQL-style backtick quoting
• (@DutchmanNL) Fixed getCounter on SQLite: ORDER BY/LIMIT is not allowed on a compound-select member
• (@DutchmanNL) Fixed getCounter on MS SQL: the counter subquery filtered on ts_number instead of ts_counter
• (@GermanBluefox) getCounter now sorts in the outer query on all dialects, so the row order no longer depends on the query plan
• (@DutchmanNL) Added getCounter test coverage for all four dialects

4.1.5 (2026-08-28)

• (@GermanBluefox) Updated packages

4.1.4 (2026-08-27)

• (@GermanBluefox) Connection errors no longer start with the useless class name AggregateError: the log now shows only the real reason, e.g. connect ECONNREFUSED 127.0.0.1:3306; connect ECONNREFUSED ::1:3306

4.1.3 (2026-08-27)

• (@GermanBluefox) Connection errors are logged with the real reason again: Node reports a failed TCP connect as an AggregateError whose own message is empty, so the log only showed the word AggregateError instead of e.g. connect ECONNREFUSED 127.0.0.1:3306
• (@GermanBluefox) The reconnection loop no longer repeats the same connection error every 30 seconds: the first occurrence is logged as error, repetitions go to debug and once an hour a reminder is logged

License

The MIT License (MIT)

Copyright (c) 2015-2026 bluefox dogafox@gmail.com, Apollon77

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.