# Database e data warehouse

> Collega un database o un data warehouse e fai domande con parole semplici. Dvina accede ai dati solo in lettura e controlla ogni query prima di eseguirla.

Collega il tuo database o data warehouse e fai domande come le faresti a un collega. Dvina trova le tabelle giuste, scrive la query e ti mostra la risposta.

## Cosa può fare Dvina

- **Rispondere con parole semplici.** Chiedi "Quali regioni hanno perso clienti abituali nell'ultimo trimestre?" e Dvina trova le tabelle, scrive la query e mostra la risposta, spesso con un grafico e la tabella sottostante.
- **Mappare le tue tabelle.** Dvina scopre come sono collegate le tue tabelle, così non devi mai specificare un join.
- **Mostrare i dati come preferisci.** Cambia la visualizzazione di una risposta: **Tabella**, **Linee**, **Area**, **Barre**, **Barre orizzontali**, **Torta**, **Anello**, **Radar** o **Area polare**.
- **Conservare una risposta.** Salva qualsiasi risposta come insight e riaprila quando ti serve.

Puoi collegare 20 database e data warehouse, tra cui PostgreSQL, MySQL, SQL Server, Snowflake, BigQuery, Redshift e Databricks.

Per usare un database in un messaggio, digita <kbd>/</kbd> nel campo del messaggio e selezionalo.

## Autorizzazioni

I database e i data warehouse che colleghi sono accessibili solo in lettura per scelta progettuale.

- **Solo operazioni di lettura singole:** Prima dell'esecuzione, ogni query viene controllata per verificare che sia una singola operazione di lettura. I tuoi dati restano invariati.
- **Nessuna modifica:** Se chiedi a Dvina di modificare o eliminare dati, ti informa che può solo leggerli e può proporti di elencare i dati a cui ti riferisci.
- **Accesso del tuo account:** Dvina vede le tabelle che l'account usato per collegarti al database può leggere. Se non compare nessuna tabella, chiedi all'amministratore del database di verificare le autorizzazioni di lettura di quell'account.
- **Righe e colonne per ogni persona:** Quando condividi una tabella, le regole di accesso possono mostrare a ogni persona solo alcune righe e nascondere determinate colonne. Consulta [Controllare quali righe e colonne possono vedere le persone](/docs/connectors/row-and-column-access).

> [!TIP]
> Collegati con un account del database che abbia solo autorizzazioni di lettura. Dvina non scrive mai dati e un account di sola lettura garantisce che sia così anche dal lato del database.

## Come collegare un database

1. Apri **Database** nella tua Libreria e scegli **Collega un database**. Puoi anche scegliere **Aggiungi contesto** nella tua Libreria, poi **Database**.
2. Trova il tuo database o data warehouse. Puoi cercarlo per nome.
3. Scegli **Collega**.
4. Inserisci un **Nome della sorgente** e i dettagli della connessione, come **Host**, **Porta**, **Database**, **Nome utente** e **Password**. Alcuni data warehouse richiedono invece altri dettagli, come un account, un progetto o un file dell'account di servizio.
5. In **Crittografia (SSL)**, scegli **Verificata**, **Obbligatoria** o **Disattivata**.
6. Per consentire a Dvina di cercare i collegamenti tra le tue tabelle, attiva **Trova relazioni tra le tabelle**. Per i database di grandi dimensioni, l'operazione potrebbe richiedere del tempo.
7. Scegli **Collega**.

Dvina verifica la connessione e rileva le tue tabelle. Ogni tabella indica quando è **Pronta per le domande** e puoi seguire l'avanzamento nella pagina del database.

### Se la connessione non riesce

Dvina indica cosa non ha funzionato. Ecco le soluzioni più comuni:

- **Il database ha rifiutato le credenziali:** Controlla il nome utente, la password e il metodo di autenticazione.
- **L'indirizzo rimanda a una rete privata o interna:** Usa il nome host pubblico o l'indirizzo IP pubblico del database.
- **Non è stato possibile stabilire la connessione crittografata:** Se il database usa un certificato autofirmato, scegli **Obbligatoria** anziché **Verificata**. Se non supporta SSL, scegli **Disattivata**.
- **Non è stato possibile raggiungere il database:** Controlla la disponibilità del database, l'accesso alla rete, l'host e la porta.

Per modificare i dettagli in seguito, apri il database e scegli **Modifica connessione**, poi **Verifica di nuovo**.

## Scopri come sono collegate le tue tabelle

Apri **Database** nella tua Libreria, apri il database e seleziona la sua scheda, la prima nella pagina. Il pannello **Schema del database** mostra il database a colpo d'occhio:

- **Connessione:** i dettagli del database, come **Host**, **Porta** e **Utente**, e il suo **Stato**: **Connesso** o **Impossibile connettersi**, con l'indicazione dell'ultima verifica. Scegli **Verifica di nuovo** per verificarlo ora.
- **Relazioni:** indica se Dvina ha cercato i collegamenti tra le tue tabelle. Scegli **Trova relazioni** o **Cerca di nuovo** per avviare una ricerca.
- **Il diagramma:** ogni tabella è rappresentata da una scheda con le sue colonne, le chiavi in alto e una linea per ogni relazione tra tabelle. Passa il puntatore su una linea per evidenziare le due colonne che collega. Seleziona una tabella per aprirla.

Per trovare una tabella o una colonna, usa **Trova una tabella o una colonna**. Per visualizzare il diagramma a schermo intero, scegli **Espandi**.

Nel diagramma, **PK** indica una chiave primaria e **FK** una chiave esterna. Una linea continua indica una relazione dichiarata dal database oppure confermata e usata nelle query. Una linea tratteggiata indica una relazione **Suggerita**: una relazione che Dvina ha trovato nei tuoi dati e che non è ancora in uso.

### Esamina le relazioni trovate da Dvina

1. Nel diagramma, seleziona una linea tratteggiata.
2. Controlla le due colonne che collega.
3. Scegli **Conferma** per usarla nelle query oppure **Scarta** se è errata. Una relazione che scarti non viene suggerita di nuovo.

### Database di grandi dimensioni

- La ricerca delle relazioni conta le righe nelle tue tabelle, quindi può richiedere del tempo. Per un database con più di 100 tabelle, Dvina non avvia la ricerca automaticamente, anche se hai attivato **Trova relazioni tra tabelle**. Scegli **Trova relazioni** quando vuoi avviare la ricerca.
- Quando un database ha più di 40 tabelle, il diagramma mostra una tabella e quelle collegate. Usa la ricerca per concentrarti su un'altra tabella.

## Salva e aggiorna gli insight

Un insight conserva la risposta a una domanda, così puoi riaprirla con dati aggiornati.

1. Nella scheda della risposta, scegli come visualizzarla, ad esempio **Tabella** o **Barre**.
2. Scegli **Salva**. Dvina mostra **Salvato come insight**. Su un telefono, scegli prima **Espandi**, poi **Salva** nel pannello laterale.
3. Per aprirlo, scegli **Salvato**. Puoi trovarlo anche nel tuo Feed.

L'insight si apre nel pannello laterale. Qui puoi:

- **Rinominarlo:** fai clic sul nome in alto e digita un nuovo nome.
- **Cambiarne la visualizzazione:** scegli un'altra presentazione o una vista pivot. La nuova visualizzazione viene salvata con l'insight.
- **Aggiornarlo:** apri il menu del pannello e scegli **Aggiorna** per eseguirlo di nuovo con i dati più recenti.
- **Scaricarlo:** apri il menu del pannello e scegli **Scarica**.
- **Eliminarlo:** apri il menu del pannello e scegli **Elimina**. Viene spostato nel Cestino, da cui puoi ripristinarlo.

### Insight condivisi

Quando condividi un insight, scegli **Può modificare** o **Può visualizzare** per ogni persona.

- **Le persone che possono modificare** possono anche aggiornarlo.
- **Le persone che possono visualizzare** possono solo consultarlo. Possono cambiare la visualizzazione sul proprio schermo, ma la modifica non viene salvata, e vedono **Solo chi può modificare può aggiornare** e **Solo chi può modificare può rinominare**.

Se le regole di accesso di una tabella limitano ciò che una persona può vedere, questa riceve un risultato dell'insight specifico per lei, contrassegnato come **Visualizzazione limitata**. Vedi [Controlla quali righe e colonne possono vedere le persone](/docs/connectors/row-and-column-access).

## Privacy

- Ciò che colleghi non viene mai usato per addestrare modelli di IA.
- Vengono letti solo i dati necessari per la tua richiesta.
- I dati personali, come i numeri di carta e di telefono, vengono mascherati prima che l'IA li veda.
- I tuoi dati vengono crittografati durante il trasferimento.

## Scollega

1. Apri **Database** nella tua Libreria e scegli il database.
2. Apri il suo menu e scegli **Disconnetti**, poi scegli **Disconnetti** per confermare.

Il database viene spostato nel Cestino insieme alle sue tabelle e agli approfondimenti creati a partire da esse. Puoi ripristinarli da lì. Nel database stesso non cambia nulla.

## Vedi anche

- [Panoramica dei connettori](/docs/connectors/overview)
- [Accesso a righe e colonne](/docs/connectors/row-and-column-access)
- [Risposte in tempo reale](/docs/use-dvina/features/live-answers)
- [La tua prima chat](/docs/use-dvina/get-started/first-chat)