Bienvenue dans le guide de navigation dans la base de données ! HarborDB fournit des outils puissants pour explorer et comprendre vos bases de données PostgreSQL. Ce guide vous montrera comment naviguer efficacement dans la structure de votre base de données, examiner les tables et les relations, et tirer le meilleur parti de l'interface visuelle de HarborDB.

L'interface de navigation

Aperçu de la barre latérale

La barre latérale gauche est votre outil de navigation principal. Elle affiche une vue hiérarchique de la structure de votre base de données :

Nom de la connexion
├── Bases de données
│   ├── Base de données 1
│   │   ├── Schémas
│   │   │   ├── public
│   │   │   │   ├── Tables
│   │   │   │   ├── Vues
│   │   │   │   ├── Fonctions
│   │   │   │   └── Séquences
│   │   │   └── autres_schémas
│   │   └── Paramètres
│   └── Base de données 2
└── Objets système

Modes de navigation

HarborDB offre deux modes de navigation principaux :

Vue arborescente (Par défaut) : Expansion hiérarchique des objets
Vue recherche : Recherche rapide parmi tous les objets

Exploration des bases de données

Visualisation des bases de données disponibles

Lorsque vous vous connectez pour la première fois, vous verrez une liste des bases de données auxquelles vous avez accès :

Développez votre connexion dans la barre latérale
Cliquez sur "Bases de données" pour voir la liste
Double-cliquez sur n'importe quelle base de données pour explorer son contenu

Informations sur la base de données

Clic droit sur n'importe quelle base de données pour un accès rapide à :

Propriétés : Voir la taille de la base de données, l'encodage, le collationnement
Nouvel onglet de requête : Ouvrir l'éditeur de requêtes pré-connecté à cette base de données
Actualiser : Mettre à jour la liste des bases de données
Créer une base de données : Si vous avez les permissions

Travail avec les schémas

Comprendre les schémas

Les schémas sont des conteneurs logiques au sein des bases de données. PostgreSQL utilise par défaut le schéma public, mais vous pouvez rencontrer d'autres schémas.

Exploration du contenu des schémas

Développez une base de données pour voir ses schémas
Développez un schéma pour voir les types d'objets :
- Tables : Stockage de données
- Vues : Tables virtuelles à partir de requêtes
- Fonctions : Procédures stockées et fonctions
- Séquences : Générateurs de nombres auto-incrémentés

Opérations sur les schémas

Clic droit sur un schéma pour :

Créer une nouvelle table/vue/fonction
Actualiser le contenu du schéma
Définir comme par défaut : Faire de ce schéma votre schéma préféré

Examen des tables

Vue de la structure de la table

Lorsque vous développez le dossier "Tables", vous verrez toutes les tables du schéma. Cliquez sur n'importe quelle table pour voir :

Onglet Colonnes

Noms des colonnes et types de données
Contraintes (Clé primaire, Clé étrangère, etc.)
Valeurs par défaut et état nullable
Informations de stockage

Onglet Aperçu des données

100 premières lignes des données de la table
Colonnes triables (cliquez sur les en-têtes)
Données filtrables (clic droit sur les en-têtes de colonnes)
Options d'exportation rapide

Onglet Index

Noms d'index et types
Colonnes indexées
Taille de l'index et statistiques

Onglet Clés étrangères

Relations avec d'autres tables
Tables référencées et colonnes
Règles de cascade

Actions rapides sur les tables

Clic droit sur n'importe quelle table pour un accès instantané à :

| Action | Description | Raccourci clavier | | ------------------- | ----------------------------------------------- | ----------------- | | Sélectionner Top 100 | Ouvrir une requête avec SELECT * FROM table LIMIT 100 | ⌘ + Clic | | Voir la structure | Ouvrir la structure de la table en vue détaillée | ⌥ + Clic | | Générer SELECT | Créer une requête SELECT de base pour cette table | | | Générer INSERT | Créer un modèle INSERT | | | Exporter des données | Exporter la table vers CSV/JSON | ⌘ + E | | Actualiser | Mettre à jour les informations de la table | ⌘ + R |

Comprendre les vues

Vue vs Table

Les vues apparaissent similaires aux tables mais sont des objets virtuels basés sur des requêtes SQL :

Vues régulières : Définitions de requêtes stockées
Vues matérialisées : Résultats pré-calculés (mis en cache)

Informations sur les vues

Cliquez sur n'importe quelle vue pour voir :

Définition : La requête SQL qui définit la vue
Colonnes : Structure de l'ensemble de résultats
Dépendances : Tables et vues dont dépend cette vue

Travail avec les grandes bases de données

Filtrage et recherche

Lorsque vous traitez de nombreux objets, utilisez ces fonctionnalités :

Filtre rapide

Cliquez dans la zone de recherche en haut de la barre latérale
Tapez le nom de l'objet pour filtrer en temps réel
Utilisez des caractères génériques : *utilisateurs* trouve tous les objets contenant "utilisateurs" dans le nom

Recherche avancée

Portée de la recherche : Limiter aux tables, vues ou tous les objets
Basculement sensible à la casse : Correspondance exacte de la casse
Support des expressions régulières : Utiliser des expressions régulières pour des motifs complexes

Objets favoris

Marquez les objets fréquemment consultés pour une récupération rapide :

Clic droit sur n'importe quel objet
Sélectionnez "Ajouter aux favoris"
Accédez aux favoris depuis la section Favoris de la barre latérale

Examen des relations

Visualisation des relations entre tables

HarborDB vous aide à comprendre comment les tables se connectent :

Visualisation des clés étrangères

Clic droit sur n'importe quelle table avec des clés étrangères
Sélectionnez "Afficher les relations"
Visualisez la représentation graphique des connexions

Analyse des dépendances

Voir ce qui dépend de cette table
Identifier les références circulaires
Comprendre l'impact des modifications de schéma

Navigateur de relations

Pour les bases de données complexes, utilisez le Navigateur de relations :

Ouvrez le menu Outils → Navigateur de relations
Sélectionnez la table de départ
Explorez les connexions visuellement
Exportez le diagramme de relations pour la documentation

Exemples pratiques de navigation

Exemple 1 : Exploration d'une nouvelle base de données

Lorsque vous vous connectez à une base de données inconnue :

Vérifiez la taille de la base de données (clic droit sur la base de données → Propriétés)
Listez tous les schémas et identifiez les principaux
Examinez le nombre de tables dans chaque schéma
Examinez les plus grandes tables (tri par nombre de lignes ou taille)
Recherchez les tables de documentation (souvent nommées : docs, documentation, readme)

Exemple 2 : Recherche de données spécifiques

Lorsque vous devez localiser des informations client :

Recherchez les tables contenant "customer", "user" ou "client"
Examinez les tables probables pour les colonnes pertinentes
Vérifiez les clés étrangères pour trouver les données associées
Utilisez l'Aperçu des données pour échantillonner les données réelles

Exemple 3 : Compréhension de la structure d'une application

Pour comprendre comment une application organise les données :

Regroupez les tables par préfixe (par exemple, app_, auth_, report_)
Examinez les conventions de nommage
Recherchez les modèles de clés étrangères
Identifiez les tables de référence/lookup

Raccourcis clavier pour la navigation

Maîtrisez ces raccourcis pour une navigation efficace :

| Raccourci | Action | | ----------- | ------------------------------- | | ⌘ + B | Basculer la visibilité de la barre latérale | | ⌘ + F | Concentrer la recherche dans la barre latérale | | ⌘ + G | Trouver le suivant dans les résultats de recherche | | ⌥ + Clic | Ouvrir l'objet dans un nouvel onglet | | ⌘ + Clic | Ouvrir une requête SELECT pour la table | | ⌘ + R | Actualiser la vue courante | | ⌘ + . | Effacer la recherche/le filtre | | ⌘ + 1-9 | Basculer entre les sections de la barre latérale |

Meilleures pratiques de navigation

Conseils d'organisation

Utilisez des noms de connexion significatifs : Inclure l'environnement (Dev, Prod) et l'objectif
Regroupez les connexions associées : Dev local, préproduction, production
Code couleur par environnement : Vert pour dev, jaune pour préproduction, rouge pour prod
Créez des modèles de connexion : Pour des configurations de base de données similaires

Considérations de performance

Limitez l'auto-expansion : Ne développez pas tout en même temps
Utilisez la recherche au lieu de la navigation pour les grandes bases de données
Fermez les connexions inutilisées pour libérer des ressources
Effacez le cache périodiquement pour les schémas très volumineux

Pratiques de sécurité

Utilisez des identifiants spécifiques à la connexion lorsque c'est possible
Limitez la visibilité des schémas avec les permissions appropriées
Évitez d'enregistrer les mots de passe de production dans des environnements moins sécurisés
Auditez régulièrement l'utilisation des connexions

Dépannage des problèmes de navigation

Erreurs "Objet non trouvé"

Si vous ne voyez pas les objets attendus :

Actualisez la connexion (clic droit → Actualiser)
Vérifiez vos permissions sur la base de données
Vérifiez que vous êtes dans le bon schéma
Confirmez que l'objet n'a pas été renommé ou supprimé

Performance de navigation lente

Pour une réponse lente :

Réduisez la profondeur d'auto-expansion dans les Préférences
Désactivez les aperçus miniatures pour les grandes tables
Augmentez le délai d'attente des requêtes pour les connexions distantes
Utilisez la recherche au lieu de l'expansion arborescente

Relations manquantes

Si les clés étrangères ne s'affichent pas :

Vérifiez si les clés étrangères sont correctement définies dans PostgreSQL
Vérifiez que vous avez les permissions pour voir les informations de contrainte
Actualisez les métadonnées de la table
Vérifiez la vérification différée des contraintes

Fonctionnalités de navigation avancées

Requêtes personnalisées pour l'exploration

Créez des requêtes sauvegardées pour une exploration complexe :

-- Trouver toutes les tables avec une colonne spécifique
SELECT
    table_schema,
    table_name,
    column_name,
    data_type
FROM information_schema.columns
WHERE column_name ILIKE '%email%'
ORDER BY table_schema, table_name;

-- Lister les plus grandes tables
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;

Marque-pages pour les chemins courants

Sauvegardez les chemins de navigation fréquemment consultés :

Naviguez vers votre objet cible
Cliquez sur le bouton Marque-page dans la barre d'outils
Nommez le marque-page (par exemple, "Tables d'analyse client")
Accédez aux marque-pages depuis le menu Marque-pages

Exportation de la structure de la base de données

Documentez la structure de votre base de données :

Sélectionnez les objets dans la barre latérale
Clic droit → Exporter la structure
Choisissez le format : SQL, Markdown ou HTML
Incluez les options : Avec données, contraintes, index

Prochaines étapes

Maintenant que vous pouvez naviguer efficacement dans les bases de données :

Bases des requêtes - Apprenez à écrire et exécuter des requêtes SQL
Exportation de données - Sauvegardez les résultats en CSV ou JSON
Optimisation des performances - Optimisez votre flux de travail de base de données

Obtenir de l'aide

Si vous rencontrez des problèmes de navigation :

Consultez notre Guide de support pour le dépannage
Visitez la FAQ pour les questions courantes
Contactez le support pour une assistance personnalisée

Navigation dans la base de données avec HarborDB