Adatbázisok

Csatlakoztass egy adatbázist, és a munkaterületen bárki kérdezhet tőle SQL írása nélkül, például: „kik a rendelési érték alapján az öt legnagyobb ügyfelünk?” Az AI beolvassa a sémát, megírja a lekérdezést, lefuttatja, az eredményből pedig táblázatot és egy rövid tanulságot készít. Minden lefuttatott lekérdezést egy kattintással megnézhetsz, így a válasz mindig ellenőrizhető.

app.stickyprompts.com Képernyőfelvétel

Oktatóvideó 6/14 · 1:31 Kösd be az eszközeidet: CRM, e-mail, adatbázisok Magyar narrációval, az élő alkalmazásban rögzítve

Támogatott adatbázisok

MySQL, MariaDB, PostgreSQL és SQL Server. A Microsoft Power BI a Databases & BI kategóriában Coming soon (hamarosan) jelöléssel szerepel. Annyi adatbázist csatlakoztathatsz, amennyire szükséged van.

Mielőtt elkezded

Előbb a saját oldaladon intézz el két dolgot. Ezektől lesz biztonságos a kapcsolat.

1. Hozz létre külön adatbázis-felhasználót a StickyPrompts számára a lehető legszűkebb, még működő jogosultsággal. A legtöbb csapatnál ez olvasási jogot jelent azokhoz a táblákhoz, amelyekről kérdezni fognak, és semmi mást. Soha ne használj újra adminisztrátori vagy alkalmazásfiókot.
2. Tedd elérhetővé az adatbázist. Vagy engedélyezd a StickyPrompts IP-címét a tűzfaladon, vagy ha az adatbázis privát hálózaton van, használd az SSH bridge-et (lásd lent).

188.245.64.188

Minden StickyPrompts-adatbázis-kapcsolat erről a címről érkezik. Az adatbázis portján ezt engedélyezd, és csak ezt.

Adatbázis csatlakoztatása

1. Nyisd meg az Add connection párbeszédablakot, és válaszd ki az adatbázist

   Lépj az Integrations oldalra, kattints az Add connection gombra, válaszd a Workspace (mindenkivel megosztott) vagy a Personal (csak a tiéd) lehetőséget, szűrj a Databases & BI kategóriára, és válaszd a MySQL, a MariaDB, a PostgreSQL vagy az SQL Server kártyát. Munkaterületi kapcsolatot csak a munkaterület tulajdonosai és adminisztrátorai vehetnek fel.

2. Írd le, mi ez

   Adj neki olyan nevet és leírást, amelyet mindenki felismer, mint a demóban a Northwind Retail DB és az Orders, customers and products for the retail stores (a kiskereskedelmi üzletek rendelései, ügyfelei és termékei).

3. Add meg a kapcsolódási adatokat

   Mező	Mit írj be
   Host	Az adatbázisszerver címe. Ha SSH bridge-et használsz, akkor az ugrógép felől látható cím, általában localhost.
   Port	MySQL és MariaDB esetén általában 3306, PostgreSQL esetén 5432, SQL Server esetén 1433.
   Database	Az adatbázis neve.
   Schema	Nem kötelező. Ha üresen hagyod, a PostgreSQL a public, az SQL Server a dbo sémát használja.
   Username és Password	A StickyPrompts számára létrehozott külön felhasználó adatai.
   SSL mode	Require, Verify CA, Verify full vagy Disable. Ha a szerverednek ellenőrizhető tanúsítványa van, a Verify full beállítást használd; interneten keresztül soha ne válaszd a Disable lehetőséget.

4. Válaszd ki a jogosultsági szintet

   Hacsak nincs rá kifejezett okod, a Read only szintet válaszd. Lásd: Jogosultsági szintek.

5. Tesztelés és mentés

   A StickyPrompts mentés előtt ezekkel az adatokkal kapcsolódik az adatbázisodhoz. Ha nem éri el a szervert, vagy nem tud bejelentkezni, hibaüzenetet látsz, és semmi sem mentődik el. Mentés után az adatbázis megjelenik a Databases & BI szakaszban, a kártyáján a jogosultsági szinttel.

   app.stickyprompts.com/integrations 1 Jogosultsági szint 2 Megosztva a munkaterülettel

Jogosultsági szintek

Szint	Mit futtathat az AI
Read only	Egyszerre egyetlen SELECT (vagy WITH ... SELECT) utasítást. Minden mást elutasít a rendszer.
Read & write	SELECT, valamint INSERT és UPDATE utasításokat.
Full access	Bármit, amit az adatbázis-felhasználód futtathat, a DELETE és a DROP utasítást, valamint a sémamódosításokat is beleértve.

A Read only szint minden utasítást futtatás előtt ellenőriz, és elutasít mindent, ami nem egyetlen olvasási művelet. Mivel az ellenőrzés az SQL-ben bárhol előforduló olyan szavakat keres, mint az update vagy a delete, egy ártalmatlan lekérdezés is fennakadhat, ha szerepel benne ilyen szó, például egy update_note nevű oszlop. Ilyenkor fogalmazd át a kérdést, vagy kérd meg az AI-t, hogy kerülje el azt az oszlopot.

Privát adatbázis elérése SSH bridge-en keresztül

Ha az adatbázisod nem érhető el az internetről, a StickyPrompts egy olyan SSH-ugrógépen (jump host, bastion) keresztül is kapcsolódhat, amely eléri az adatbázist.

1. Kapcsold be az SSH bridge-et

   Az adatbázis-kapcsolat űrlapján kapcsold be az SSH bridge-et, és add meg az ugrógép adatait: SSH host, SSH port (általában 22) és SSH username.

2. Engedélyezd a StickyPrompts kulcsát az ugrógépen

   Az űrlapon megjelenik egy nyilvános kulcs. Vedd fel egyetlen sorként az ugrógépen az adott SSH-felhasználó ~/.ssh/authorized_keys fájljába:

   jump host

   $ echo 'ssh-ed25519 AAAA...copied-from-stickyprompts' >> ~/.ssh/authorized_keys

   $ chmod 600 ~/.ssh/authorized_keys

   Csak a nyilvános kulcs jelenik meg. A privát kulcs soha nem hagyja el a StickyPromptsot.

3. A Host mezőben az ugrógép felől látható címet add meg

   A Host mezőbe az adatbázis azon címét írd, amelyen az ugrógép látja: localhost, ha az adatbázis magán az ugrógépen fut, egyébként az adatbázis privát címét a hálózatodon. Engedélyezd, hogy a 188.245.64.188 cím elérje az ugrógép SSH-portját.

Kérdezz

Úgy kérdezz, ahogy egy elemzőtől kérdeznél. Ha több adatbázisod is van, említsd meg, melyikről van szó.

A kiskereskedelmi adatbázisunkból: kik a teljes rendelési érték alapján az öt
legnagyobb ügyfelünk, és a bevétel mekkora részét adják? Kérek egy táblázatot
és egy tanulságot.

Mely termékekből adtunk el 10 darabnál kevesebbet a múlt hónapban a kiskereskedelmi adatbázis szerint?

Az AI először kilistázza az adatbázis-kapcsolataidat, aztán beolvassa a táblákat és az oszlopaikat, majd lefuttat egy vagy több lekérdezést, a lépések között mérlegelve a következőt. A válasz fölötti actions sort lenyitva minden hívást és a lefuttatott SQL-t is láthatod.

app.stickyprompts.com/conversations 1 Előbb a sémát olvassa be 2 Nyisd le az SQL-ért

Hibaelhárítás

Probléma	Mit ellenőrizz
Nem sikerül kapcsolódni	Engedélyezve van a 188.245.64.188 cím a tűzfaladon, a megfelelő porton? Elérhető a host az internetről, vagy SSH bridge-re van szükséged?
SSL-hibák	Lehet, hogy a szervered nem támogatja az SSL-t, vagy Verify full mellett a tanúsítványa nem egyezik a gazdagépnévvel. Próbáld ki a Require beállítással, hogy megerősítsd, majd javítsd a tanúsítványt.
Nem működik az SSH bridge	Egyetlen sorban szerepel a nyilvános kulcs a megfelelő felhasználó authorized_keys fájljában? Az ugrógép felől látható cím van a Host mezőben?
Egy olvasási lekérdezést elutasít	Lásd a Jogosultsági szintek alatti megjegyzést az olvasási lekérdezésben szereplő szavakról, például az update szóról.
A válasz rossznak tűnik	Nyisd le a műveleteket, és olvasd el az SQL-t. Mondd meg az AI-nak, mit változtasson („csak a teljesített rendeléseket számold”), és kérdezz újra.

Kapcsolódó oldalak