🛠️ Comment se connecter
- Allez dans vos Paramètres du chat > Intégrations > Base de données SQL.
- Cliquez sur Connect et remplissez les détails de votre base de données :
- Nom et description : Un nom et une description conviviaux pour aider l’IA à comprendre les données qu’elle contient.
- Devise (facultatif) : La devise principale utilisée pour les valeurs monétaires dans vos tables, aidant l’IA à formater et interpréter les données financières.
- Hôte et port : L’adresse et le port de votre serveur de base de données (par défaut
5432pour PostgreSQL). - Base de données : Le nom de votre base de données.
- Utilisateur et mot de passe : Vos identifiants de base de données (idéalement en lecture seule).
- Mode SSL : Sélectionnez
requireoudisable.
- Cliquez sur Test pour vérifier les identifiants et voir combien de tables sont trouvées.
- Cliquez sur Save pour terminer.
Connecter une base de données Supabase
Supabase affiche deux types de détails de connexion. Utilisez celui du pooler.- Dans votre projet Supabase, cliquez sur Connect en haut du tableau de bord.
- Ouvrez l’onglet Session pooler.
- Copiez les valeurs dans le formulaire :
Remplir les détails de connexion
Cliquez sur le bouton Connect pour ouvrir le formulaire et remplissez les champs suivants :⚙️ Gérer votre intégration
Cliquez sur Settings sur la carte de votre base de données SQL active pour gérer les éléments suivants :- Sélectionner les tables à partager : Choisissez les tables ou vues qu’Attlas peut lire. Attlas vérifie cette liste à chaque requête et bloque toute table que vous n’avez pas partagée, quelles que soient les permissions de votre utilisateur de base de données.
- Instructions : Écrivez les règles qu’Attlas doit suivre avec vos données (voir ci-dessous).
- Actualiser le schéma : Après avoir ajouté ou modifié des tables ou des colonnes, cliquez sur Refresh pour les synchroniser.
- Désactiver temporairement : Activez ou désactivez l’intégration avec l’interrupteur.
- Déconnecter : Supprimez la connexion à la base de données.
Instructions
La description indique ce que contient votre base de données. Les instructions indiquent comment l’utiliser. Écrivez une règle par ligne, jusqu’à 1 000 caractères :Schémas
Attlas lit tous les schémas de votre base de données, pas seulementpublic. Les tables en dehors de public apparaissent sous la forme schema.table, par exemple cms.projects. Les schémas internes de Supabase (auth, storage, realtime, vault et similaires) ne sont jamais lus.
Les connexions existantes ne voient les nouveaux schémas qu’après avoir cliqué sur Refresh Schema. Votre sélection actuelle de tables reste inchangée.
💡 Bonnes pratiques pour le schéma de base de données
Pour aider Attlas à écrire des requêtes précises et à effectuer des calculs exacts, tenez compte de ces conseils de conception de schéma :- Utilisez des types de colonnes précis : Si vous voulez que le chat effectue des calculs, comme des sommes, des moyennes ou des ratios, sur des données numériques, assurez-vous que ces colonnes utilisent un type numérique, tel que
numeric,decimal,integeroufloat. Évitez de stocker les nombres sous forme de texte, commevarcharoutext, car cela rend les calculs plus difficiles et moins précis. - Ajoutez des commentaires aux colonnes : Utilisez les commentaires de base de données sur vos tables et colonnes. L’ajout d’une brève description directement sur une colonne, par exemple
COMMENT ON COLUMN users.status IS 'Active statuses: active, suspended, pending', fournit un contexte crucial qui guide Attlas dans l’écriture des requêtes SQL correctes.
🔒 Bonnes pratiques de sécurité
Pour garantir la sécurité de vos données, nous vous recommandons vivement :- Partagez uniquement ce dont vous avez besoin : Attlas rejette toute requête qui touche une table que vous n’avez pas partagée. Gardez les tables contenant des données personnelles ou des identifiants décochées.
- Les vues nécessitent leurs tables sources : Une vue que vous partagez lit depuis d’autres tables. Ces tables doivent également être partagées.
- Utilisez un utilisateur en lecture seule : Créez un utilisateur de base de données avec uniquement les permissions
SELECT. Attlas n’envoie que des requêtes en lecture, et un utilisateur en lecture seule ajoute une couche de protection supplémentaire. - Gardez SSL activé : Définissez
sslmodesurrequirepour chiffrer les données en transit.

