MariaDB

Home Assistant verwendet eine Datenbank, um Ereignisse und Parameter für den Verlauf und die Verfolgung der Entitäten zu speichern. Die bei einer Neuinstallation verwendete Standarddatenbank ist SQLite. Die Datenbank findest du im Konfigurationsverzeichnis (z. B. config/home-assistant_v2.db) deines Home Assistant Programms. Um die Standard-Datenbankbibliothek zu ändern, musst du die Recorder-Komponente in Home Assistant einstellen. In diesem Tutorial werde ich zeigen, wie du MariaDB als Haupt-SQL-Recorder-Datenbank  einrichtest. In diesem Tutorial werde ich zeigen, wie du MariaDB als Haupt-SQL-Recorder-Datenbank einrichtest. 

Warum die Standarddatenbank ändern und optimieren?

Du fragst dich vielleicht, warum die Standarddatenbank geändert werden sollte? Warum bestimmte Entitäten in die Datenbank aufnehmen oder ausschließen, wenn ich sie alle erfassen kann? Die Antwort hängt von deiner Home Assistant-Installationsmethode, der Anzahl der Geräte, die du in HA integriert hast, und der Datenmenge ab, die du für einen bestimmten Zeitraum speichern möchten.

Obwohl die Standard-SQLite für den durchschnittlichen Benutzer in Ordnung ist und fein abgestimmt werden kann, um Entitäten für die Aufbewahrung von Aufzeichnungen einzuschließen oder auszuschließen, empfehle ich, zu einer besseren, optimierteren Datenbankbibliothek wie MariaDB zu wechseln. Sowohl SQLite als auch MariaDB sind beide relationale DBMS und dienen demselben Zweck, aber MariaDB ist besser in der Handhabung großer Datensätze , einfacherer Extraktion von Daten/Integrationen und schneller bei der Anzeige des Verlaufs.

Standardmäßig speichert Home Assistant Daten für etwa 10 Tage zur Verwendung in der Verlaufs- und Logbuch-Integration mit SQLite. Wenn du viele Geräte hast, die wiederum viele Entitäten erstellen, schreibt Home Assistant viele Ereignisse und Parameter in die .db-Datei. Dies belastet dein Speichermedium (insbesondere SD-Karten) sehr stark, da es viele E/A-Zyklen erzeugt. 

Wenn du beispielsweise dein Home Assistant auf einem Raspberry Pi mit einer SD-Karte ausführst, ist der Kartenausfall keine Frage von  WIRD ES  AUSFALLEN, sondern eine Frage von  WANN WIRD ES  AUSFALLEN? Der Recorder ist der Hauptschuldige für den Absturz einer Home Assistant-Instanz, die von einer SD-Karte ausgeführt wird. 

In erster Linie empfehle ich Home Assistant durch häufige Backups zu speichern.

Zweitens empfehle ich den Wechsel zu einem  SSD-Laufwerk  anstelle einer SD-Karte. Da der Raspberry Pi kein integriertes SSD-Dock im Inneren hat, musst du ihn extern mit einem USB-zu-SATA-Adapter installieren. Oder du verwendest, so wie ich, eine virtuelle Maschine, auf der du Home Assistant betreibst.

Rekorder vs. Historie vs. Logbuch

Bevor ich mit diesem Tutorial fortfahre, halte ich es für wichtig, den Unterschied zwischen der Recorder, der Historie und der Logbuch – Integration von Home Assistant zu verdeutlichen.

• Die Recorder -Integration ist für das Speichern von Ereignissen, Zuständen und Daten in der Haupt-SQL-Datenbank verantwortlich.
• Die Historie -Integration ist für die Anzeige von Daten aus dem Rekorder in der Benutzeroberfläche mithilfe von Google Graphs verantwortlich
• Die Logbuch- Integration ist dafür zuständig, Änderungen und Ereignisse in einer rückwärts chronologisch sortierten Liste anzuzeigen 

Die wichtigsten Dinge, die du daraus mitnehmen kannst, sind:

• Wenn der Rekorder für eine bestimmte Entität deaktiviert wird, sind der Verlauf und das Logbuch ebenfalls nicht verfügbar.
• Wenn der Rekorder für eine bestimmte Entität aktiviert ist, kannst du den Verlauf oder das Logbuch selektiv aus der Anzeige von Daten in der Benutzeroberfläche deaktivieren.

Jede dieser Komponenten verwendet dieselbe Filterlogik, um Entitäten in die Integration selbst einzuschließen/auszuschließen. 

Installation und Einrichtung

MariaDB

Um MariaDB zu installieren, klickst du auf Einstellungen -> Add-ons -> Add-on Store -> MariaDB. Hier klickst du auf „Installieren“ und aktivierst die Schalter „Beim Booten starten“ und „ Watchdog “. 

Öffne die Registerkarte Konfiguration, um deinen Datenbanknamen und dein Passwort einzurichten. Danach startest du Home Assistant über die die Entwicklertools neu.

Terminal und SSH

Nun startest du das Add-on Terminal und SSH (Terminal und HACS). Im Terminal installierst du Python und SQLite to Mysql mit folgendem Code:

apk add python3
apk add py3-pip
pip3 install sqlite3-to-mysql

Anschließend wird die SQLite Datenbank mit folgendem Code in die MariaDB migriert:

sqlite3mysql \
--sqlite-file /config/home-assistant_v2.db \
--mysql-database homeassistant \
--mysql-host core-mariadb \
--mysql-user homeassistant \
--mysql-password '[Passwort deiner MariaDB]' \
--ignore-duplicate-keys

Das Passwort deiner MariaDB ist einzutragen.

Nachdem der Vorgang abgeschlossen ist, kopierst du den Recorder Code und fügst diesen in der Configuration.yaml bzw. Recorder.yaml Datei ein.

db_url: mysql://homeassistant:Passwort@core-mariadb/homeassistant?charset=utf8mb4

Das Passwort deiner MariaDB ist einzutragen.

Danach startest du Home Assistant neu.

Nun kannst du überprüfen, ob deine Migration deiner Daten erfolgreich war.