Integrace RichPear Home

SQL

SQL vytváří senzory z dotazů nad databází. Používejte ji pro čtení přesně definovaných hodnot, ne jako obecný nástroj pro zápis nebo správu databáze.

Doména
sql
Kategorie
senzory, utility
Komunikace
lokální komunikace
Nastavení
průvodce v nastavení
Kvalita
neuvedeno
01

Co integrace přidá

SQL vytváří senzory z dotazů nad databází. Používejte ji pro čtení přesně definovaných hodnot, ne jako obecný nástroj pro zápis nebo správu databáze.

V systému počítejte hlavně s oblastmi: senzory. Skutečný seznam entit se vždy řídí tím, jaká zařízení, služby nebo účty jsou v instalaci připojené.

Kontrolní témata

  1. Nastavení
  2. Konfigurace v YAML
  3. Aktualizace dat
  4. Akce
  5. Information
  6. Příklady
  7. Related topics
02

Příprava před přidáním

Připravte čtecí účet s minimálními oprávněními, adresu databáze a dotaz, který vrací jednu jasnou hodnotu. Dotaz nejdřív otestujte mimo produkční automatizace a hlídejte dobu běhu.

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123 a pokračujte přes stejné položky nastavení.

U názvů zařízení používejte místnost a typ zařízení. Později se tím zjednoduší dashboardy, hlasové ovládání i servisní zásahy.
03

Nastavení v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte SQL a pokračujte podle zobrazeného průvodce. Pokud se zařízení objevilo automaticky mezi objevenými integracemi, otevřete ho odtud a jen doplňte požadované údaje.

Po uložení počkejte na první načtení dat. Některé služby vytvoří entity okamžitě, jiné je doplní až po prvním úspěšném dotazu, objevení zařízení v síti nebo dokončení párování.

Co zadávat pečlivě

YAML, port. Chyba v jednom z těchto údajů se obvykle projeví prázdným seznamem entit nebo opakovanou chybou v logu.

04

Kontrola entit a funkcí

Senzor pojmenujte podle skutečné metriky, nastavte jednotku a stavovou třídu jen tam, kde data splňují požadavky dlouhodobých statistik. Nikdy nepoužívejte dotaz, který mění data.

Otevřete detail integrace, projděte zařízení a přiřaďte jim oblasti. U senzorů sledujte jednotku a historii, u ovládacích entit ručně vyzkoušejte bezpečný stav zapnuto, vypnuto, otevřeno nebo zavřeno podle typu zařízení.

05

Použití v automatizacích

Automatizace stavte z malých kroků. Nejdřív použijte jednu entitu jako spouštěč, doplňte podmínky a až po ověření přidejte další akce nebo notifikace.

Začněte jednoduchou automatizací, která jen pošle oznámení nebo zapíše stav do logu. Až když se spouštění chová stabilně, přidejte akce, které něco fyzicky ovládají nebo posílají požadavky na externí službu.

06

Provoz a údržba

Po každé změně firmware, síťového nastavení nebo konfigurace integraci znovu projděte. Zkontrolujte názvy entit, oblasti, historii stavů a automatizace, které na integraci navazují. U lokálních zařízení je užitečné držet pevnou IP adresu nebo rezervaci v DHCP.

Jednou za čas otevřete detail integrace a porovnejte poslední aktualizaci entit s tím, co vidíte na zařízení nebo ve službě. Když měníte účet, token, port, síť nebo název zařízení, projděte také dashboardy a automatizace, protože mohou používat původní entity.

07

Řešení problémů

Když se integrace nepřidá nebo entity neukazují aktuální stav, ověřte dostupnost IP adresy, portu a případné blokování mezi VLAN; po změně konfigurace zkontrolujte syntaxi a restartujte službu. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle názvu integrace sql.

Při opakovaných chybách integraci neodstraňujte hned. Nejdřív ověřte přístupové údaje, dostupnost služby a čas poslední aktualizace. Odebrání a nové přidání má smysl až tehdy, když je jasné, že je původní konfigurace chybná.