Benvenuti alla guida di navigazione database! HarborDB fornisce strumenti potenti per esplorare e comprendere i tuoi database PostgreSQL. Questa guida ti mostrerà come navigare efficacemente la struttura del database, esaminare tabelle e relazioni, e sfruttare al massimo l'interfaccia visiva di HarborDB.

L'Interfaccia di Navigazione

Panoramica della Barra Laterale

La barra laterale sinistra è il tuo strumento di navigazione principale. Mostra una vista gerarchica della struttura del tuo database:

Nome Connessione
├── Database
│   ├── Database 1
│   │   ├── Schemi
│   │   │   ├── public
│   │   │   │   ├── Tabelle
│   │   │   │   ├── Viste
│   │   │   │   ├── Funzioni
│   │   │   │   └── Sequenze
│   │   │   └── altri_schemi
│   │   └── Impostazioni
│   └── Database 2
└── Oggetti di Sistema

Modalità di Navigazione

HarborDB offre due modalità di navigazione principali:

Vista ad Albero (Predefinita): Espansione gerarchica degli oggetti
Vista Ricerca: Ricerca rapida su tutti gli oggetti

Esplorare i Database

Visualizzare Database Disponibili

Quando ti connetti per la prima volta, vedrai un elenco di database a cui hai accesso:

Espandi la tua connessione nella barra laterale
Clicca "Database" per vedere l'elenco
Doppio-clicca qualsiasi database per esplorarne i contenuti

Informazioni sul Database

Clicca con il tasto destro su qualsiasi database per accesso rapido a:

Proprietà: Visualizza dimensione, codifica, collazione del database
Nuova Scheda Query: Apri l'editor query pre-connesso a questo database
Aggiorna: Aggiorna l'elenco dei database
Crea Database: Se hai i permessi

Lavorare con gli Schemi

Comprendere gli Schemi

Gli schemi sono contenitori logici all'interno dei database. PostgreSQL usa di default lo schema public, ma potresti incontrarne altri.

Esplorare i Contenuti degli Schemi

Espandi un database per vedere i suoi schemi
Espandi uno schema per vedere i tipi di oggetti:
- Tabelle: Archiviazione dati
- Viste: Tabelle virtuali da query
- Funzioni: Procedure e funzioni memorizzate
- Sequenze: Generatori di numeri auto-incrementanti

Operazioni sugli Schemi

Clicca con il tasto destro su uno schema per:

Crea Nuova Tabella/Vista/Funzione
Aggiorna contenuti schema
Imposta come Predefinito: Rendi questo il tuo schema preferito

Esaminare le Tabelle

Vista della Struttura della Tabella

Quando espandi la cartella "Tabelle", vedrai tutte le tabelle nello schema. Clicca qualsiasi tabella per vedere:

Scheda Colonne

Nomi colonne e tipi di dati
Vincoli (Chiave Primaria, Chiave Esterna, ecc.)
Valori predefiniti e stato nullable
Informazioni di archiviazione

Scheda Anteprima Dati

Prime 100 righe di dati della tabella
Colonne ordinabili (clicca intestazioni)
Dati filtrabili (clic destro intestazioni colonne)
Opzioni esportazione rapida

Scheda Indici

Nomi indici e tipi
Colonne indicizzate
Dimensione indice e statistiche

Scheda Chiavi Esterne

Relazioni con altre tabelle
Tabelle e colonne referenziate
Regole di cascade

Azioni Rapide Tabella

Clicca con il tasto destro su qualsiasi tabella per accesso istantaneo a:

| Azione | Descrizione | Scorciatoia da Tastiera | | ------------------- | ----------------------------------------------- | ----------------- | | Seleziona Prime 100 | Apri query con SELECT * FROM tabella LIMIT 100 | ⌘ + Click | | Visualizza Struttura | Apri struttura tabella in vista dettagliata | ⌥ + Click | | Genera SELECT | Crea query SELECT base per questa tabella | | | Genera INSERT | Crea template INSERT | | | Esporta Dati | Esporta tabella in CSV/JSON | ⌘ + E | | Aggiorna | Aggiorna informazioni tabella | ⌘ + R |

Comprendere le Viste

Vista vs Tabella

Le viste appaiono simili alle tabelle ma sono oggetti virtuali basati su query SQL:

Viste Regolari: Definizioni di query memorizzate
Viste Materializzate: Risultati pre-calcolati (cache)

Informazioni Vista

Clicca qualsiasi vista per vedere:

Definizione: La query SQL che definisce la vista
Colonne: Struttura del set di risultati
Dipendenze: Tabelle e viste da cui dipende questa vista

Lavorare con Database Grandi

Filtrare e Cercare

Quando gestisci molti oggetti, usa queste funzionalità:

Filtro Rapido

Clicca nella casella di ricerca in cima alla barra laterale
Digita il nome dell'oggetto per filtrare in tempo reale
Usa wildcard: *utenti* trova tutti gli oggetti con "utenti" nel nome

Ricerca Avanzata

Ricerca per ambito: Limita a tabelle, viste, o tutti gli oggetti
Attiva/disattiva sensibilità maiuscole/minuscole: Trova corrispondenze esatte
Supporto regex: Usa espressioni regolari per pattern complessi

Oggetti Preferiti

Segna oggetti a cui accedi frequentemente per recupero rapido:

Clicca con il tasto destro su qualsiasi oggetto
Seleziona "Aggiungi ai Preferiti"
Accedi ai preferiti dalla sezione Preferiti della barra laterale

Esaminare le Relazioni

Visualizzare le Relazioni tra Tabelle

HarborDB ti aiuta a capire come si connettono le tabelle:

Visualizzazione Chiavi Esterne

Clicca con il tasto destro su qualsiasi tabella con chiavi esterne
Seleziona "Mostra Relazioni"
Visualizza rappresentazione grafica delle connessioni

Analisi Dipendenze

Vedi cosa dipende da questa tabella
Identifica riferimenti circolari
Comprendi l'impatto dei cambiamenti dello schema

Browser Relazioni

Per database complessi, usa il Browser Relazioni:

Apri menu Strumenti → Browser Relazioni
Seleziona tabella di partenza
Esplora connessioni visivamente
Esporta diagramma relazioni per documentazione

Esempi Pratici di Navigazione

Esempio 1: Esplorare un Nuovo Database

Quando ti connetti a un database non familiare:

Controlla dimensione database (clic destro database → Proprietà)
Elenca tutti gli schemi e identifica i principali
Rivedi numero di tabelle in ciascuno schema
Esamina le tabelle più grandi (ordina per numero di righe o dimensione)
Cerca tabelle di documentazione (spesso nominate: docs, documentation, readme)

Esempio 2: Trovare Dati Specifici

Quando devi localizzare informazioni sui clienti:

Cerca tabelle contenenti "customer", "user", o "client"
Esamina tabelle probabili per colonne rilevanti
Controlla chiavi esterne per trovare dati correlati
Usa Anteprima Dati per campionare dati effettivi

Esempio 3: Comprendere la Struttura dell'Applicazione

Per capire come un'applicazione organizza i dati:

Raggruppa tabelle per prefisso (es., app_, auth_, report_)
Esamina convenzioni di denominazione
Cerca pattern di chiavi esterne
Identifica tabelle di riferimento/lookup

Scorciatoie da Tastiera per la Navigazione

Padroneggia queste scorciatoie per una navigazione efficiente:

| Scorciatoia | Azione | | ----------- | ------------------------------- | | ⌘ + B | Attiva/disattiva visibilità barra laterale | | ⌘ + F | Concentra ricerca nella barra laterale | | ⌘ + G | Trova successivo nei risultati di ricerca | | ⌥ + Click | Apri oggetto in nuova scheda | | ⌘ + Click | Apri query SELECT per tabella | | ⌘ + R | Aggiorna vista corrente | | ⌘ + . | Cancella ricerca/filtro | | ⌘ + 1-9 | Cambia tra sezioni della barra laterale |

Best Practice di Navigazione

Consigli di Organizzazione

Usa nomi di connessione significativi: Includi ambiente (Dev, Prod) e scopo
Raggruppa connessioni correlate: Sviluppo locale, staging, produzione
Codifica colore per ambiente: Verde per dev, giallo per staging, rosso per prod
Crea template di connessione: Per configurazioni di database simili

Considerazioni sulle Prestazioni

Limita auto-espansione: Non espandere tutto in una volta
Usa ricerca invece di navigazione per database grandi
Chiudi connessioni non utilizzate per liberare risorse
Pulisci cache periodicamente per schemi molto grandi

Pratiche di Sicurezza

Usa credenziali specifiche per connessione quando possibile
Limita visibilità dello schema con permessi appropriati
Evita di salvare password di produzione in ambienti meno sicuri
Verifica regolarmente l'uso delle connessioni

Risoluzione Problemi di Navigazione

Errori "Oggetto Non Trovato"

Se non vedi oggetti previsti:

Aggiorna la connessione (clic destro → Aggiorna)
Controlla i tuoi permessi sul database
Verifica che sei nello schema corretto
Conferma che l'oggetto non sia stato rinominato o eliminato

Navigazione Lenta

Per risposta lenta:

Riduci profondità auto-espansione nelle Preferenze
Disabilita anteprime miniature per tabelle grandi
Aumenta timeout query per connessioni remote
Usa ricerca invece di espansione ad albero

Relazioni Mancanti

Se le chiavi esterne non vengono mostrate:

Controlla se le chiavi esterne sono definite correttamente in PostgreSQL
Verifica di avere i permessi per vedere informazioni sui vincoli
Aggiorna metadati tabella
Controlla per verifica vincoli differita

Funzionalità Avanzate di Navigazione

Query Personalizzate per Esplorazione

Crea query salvate per esplorazione complessa:

-- Trova tutte le tabelle con una colonna specifica
SELECT
    table_schema,
    table_name,
    column_name,
    data_type
FROM information_schema.columns
WHERE column_name ILIKE '%email%'
ORDER BY table_schema, table_name;

-- Elenca le tabelle più grandi
SELECT
    schemaname,
    tablename,
    pg_size_pretty(pg_total_relation_size(schemaname || '.' || tablename)) as size
FROM pg_tables
WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
ORDER BY pg_total_relation_size(schemaname || '.' || tablename) DESC
LIMIT 20;

Segnalibri per Percorsi Comuni

Salva percorsi di navigazione a cui accedi frequentemente:

Naviga verso il tuo oggetto target
Clicca il pulsante Segnalibro nella barra degli strumenti
Nomina il segnalibro (es., "Tabelle Analisi Clienti")
Accedi ai segnalibri dal menu Segnalibri

Esportare la Struttura del Database

Documenta la struttura del tuo database:

Seleziona oggetti nella barra laterale
Clicca con il tasto destro → Esporta Struttura
Scegli formato: SQL, Markdown, o HTML
Includi opzioni: Con dati, vincoli, indici

Prossimi Passi

Ora che puoi navigare efficacemente nei database:

Basi delle Query - Impara a scrivere ed eseguire query SQL
Esportazione Dati - Salva risultati in CSV o JSON
Ottimizzazione Prestazioni - Ottimizza il tuo flusso di lavoro database

Ottenere Aiuto

Se incontri problemi di navigazione:

Controlla la nostra Guida al Supporto per risoluzione problemi
Visita le FAQ per domande comuni
Contatta il Supporto per assistenza personalizzata

Navigazione Database in HarborDB