Database

Collega un database e chiunque nel workspace potrà interrogarlo senza scrivere SQL: «chi sono i nostri cinque migliori clienti per valore degli ordini?» L’IA legge lo schema, scrive la query, la esegue e trasforma il risultato in una tabella con una conclusione. Ogni query eseguita è a un clic di distanza, quindi la risposta è sempre verificabile.

app.stickyprompts.com Registrazione dello schermo

Tutorial 6 di 14 · 1:28 Connect your tools Video in inglese, registrato nell'app reale

Database supportati

MySQL, MariaDB, PostgreSQL e SQL Server. Microsoft Power BI compare nella categoria Databases & BI con l’indicazione Coming soon. Puoi collegare tutti i database che ti servono.

Prima di iniziare

Fai prima queste due cose dalla tua parte. Sono quelle che rendono sicura la connessione.

1. Crea un utente del database dedicato a StickyPrompts con i privilegi minimi indispensabili: per la maggior parte dei team, accesso in lettura alle tabelle su cui le persone faranno domande e nient’altro. Non riutilizzare mai un account amministrativo o applicativo.
2. Rendi raggiungibile il database. Autorizza l’indirizzo IP di StickyPrompts nel firewall oppure, se il database si trova in una rete privata, usa l’SSH bridge (vedi sotto).

188.245.64.188

È l’indirizzo da cui parte ogni connessione di StickyPrompts ai database. Autorizzalo sulla porta del database, e solo quello.

Collegare un database

1. Apri Add connection e scegli il database

   Vai su Integrations, seleziona Add connection, scegli Workspace (condivisa con tutti) o Personal (solo per te), filtra per Databases & BI e seleziona MySQL, MariaDB, PostgreSQL o SQL Server. Solo i proprietari e gli amministratori del workspace possono aggiungere connessioni del workspace.

2. Descrivilo

   Assegna un nome e una descrizione che le persone riconoscano, ad esempio Northwind Retail DB e Orders, customers and products for the retail stores.

3. Inserisci i dati di connessione

   Campo	Cosa inserire
   Host	L’indirizzo del server del database. Se usi l’SSH bridge, l’indirizzo visto dal jump host, di solito localhost.
   Port	Di solito 3306 per MySQL e MariaDB, 5432 per PostgreSQL, 1433 per SQL Server.
   Database	Il nome del database.
   Schema	Facoltativo. Se lo lasci vuoto, PostgreSQL usa public e SQL Server usa dbo.
   Username e password	L’utente dedicato a StickyPrompts.
   SSL mode	Require, Verify CA, Verify full o Disable. Usa Verify full quando il server ha un certificato verificabile; non usare mai Disable su Internet.

4. Scegli il livello di autorizzazione

   Scegli Read only, a meno che tu non abbia un motivo preciso per fare diversamente. Vedi Livelli di autorizzazione.

5. Verifica e salva

   Prima di salvare, StickyPrompts si collega al database con questi dati. Se non riesce a raggiungere il server o ad accedere, vedi l’errore e non viene salvato nulla. Una volta salvato, il database compare sotto Databases & BI con il livello di autorizzazione indicato sulla scheda.

   app.stickyprompts.com/integrations 1 Livello di autorizzazione 2 Condivisa con il workspace

Livelli di autorizzazione

Livello	Cosa può eseguire l’IA
Read only	Una sola istruzione SELECT (o WITH ... SELECT) alla volta. Tutto il resto viene rifiutato.
Read & write	SELECT, più INSERT e UPDATE.
Full access	Tutto ciò che l’utente del database è autorizzato a eseguire, compresi DELETE, DROP e le modifiche allo schema.

Con Read only, ogni istruzione viene controllata prima dell’esecuzione e tutto ciò che non è una singola lettura viene respinto. Poiché il controllo cerca parole come update o delete in qualsiasi punto dell’SQL, anche una lettura innocua che contiene una di queste parole (ad esempio una colonna chiamata update_note) può essere rifiutata. Riformula la domanda oppure chiedi all’IA di evitare quella colonna.

Raggiungere un database privato con l’SSH bridge

Se il database non è raggiungibile da Internet, StickyPrompts può collegarsi tramite un jump host SSH (bastion) in grado di raggiungerlo.

1. Attiva l'SSH bridge

   Nel modulo della connessione al database, attiva l’SSH bridge e inserisci SSH host, SSH port (di solito 22) e SSH username del jump host.

2. Autorizza la chiave di StickyPrompts sul jump host

   Il modulo mostra una chiave pubblica. Aggiungila come singola riga in ~/.ssh/authorized_keys per quell’utente SSH sul jump host:

   jump host

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

   $ chmod 600 ~/.ssh/authorized_keys

   Viene mostrata solo la chiave pubblica. La chiave privata non lascia mai StickyPrompts.

3. Imposta l'host come lo vede il jump host

   Imposta Host sull’indirizzo del database così come lo vede il jump host: localhost se il database gira sul jump host stesso, altrimenti il suo indirizzo privato nella tua rete. Consenti a 188.245.64.188 di raggiungere la porta SSH del jump host.

Fare domande

Chiedi come faresti con un analista. Se hai più di un database, indica quale.

Dal nostro database retail: chi sono i nostri 5 migliori clienti per valore totale
degli ordini e che quota del fatturato rappresentano? Una tabella e una conclusione.

Quali prodotti hanno venduto meno di 10 unità il mese scorso nel database retail?

L’IA elenca prima le tue connessioni ai database, poi legge le tabelle e le relative colonne, quindi esegue una o più query, ragionando tra un passaggio e l’altro. Espandi la riga actions sopra la risposta per vedere ogni chiamata e l’SQL eseguito.

app.stickyprompts.com/conversations 1 Legge prima lo schema 2 Apri per vedere l'SQL

Risoluzione dei problemi

Problema	Cosa controllare
Impossibile connettersi	188.245.64.188 è autorizzato nel firewall, sulla porta giusta? L’host è raggiungibile da Internet, o ti serve l’SSH bridge?
Errori SSL	Il server potrebbe non supportare SSL, oppure con Verify full il certificato potrebbe non corrispondere al nome host. Prova con Require per conferma, poi correggi il certificato.
L’SSH bridge non funziona	La chiave pubblica è su una sola riga in authorized_keys, per l’utente giusto? Host è l’indirizzo così come lo vede il jump host?
Una query di lettura viene rifiutata	Vedi la nota in Livelli di autorizzazione sulle parole come update all’interno di una lettura.
La risposta sembra sbagliata	Espandi le azioni e leggi l’SQL. Di’ all’IA cosa cambiare («conta solo gli ordini completati») e chiedi di nuovo.

Pagine correlate