Connecter une base de données
Choisissez la source qui contient la réponse recherchée. Si vous avez les accès approuvés, ouvrez son guide puis renseignez Add connection. Sinon, demandez au responsable un compte de reporting, les tables ou vues utiles, la méthode d’authentification et un accès réseau depuis Datarelix.
Un compte Datarelix ne donne pas les droits de lecture sur une base. Chaque conversation et tableau de bord utilise une connexion. Snowflake utilise ici un mot de passe : vérifiez la politique actuelle du compte avant de commencer.
Dialectes pris en charge
| Dialecte | Langage de requête | Portée par défaut | Modes d’authentification |
|---|---|---|---|
| Postgres | SQL | schéma public | Username & password · Connection string |
| MySQL | SQL | base de données connectée | Username & password · Connection string |
| Azure SQL / Synapse | T-SQL | schéma dbo | Username & password · Connection string · Entra OBO · Service principal — secret · Service principal — certificate |
| Databricks | Spark SQL | schéma default | Personal Access Token · OAuth M2M · Federated JWT |
| Kusto (Azure Data Explorer) | KQL | base de données configurée | Entra OBO · App + Certificate |
| BigQuery | GoogleSQL | choisir un dataset | Service account JSON · OAuth |
| Athena | Trino/Presto SQL | choisir une base Glue | IAM access keys · Assume Role |
| Elasticsearch | ES|QL (8.11+) | choisir les index autorisés | API key · Basic auth |
| Snowflake | SQL | schéma configuré | Username & password |
| Files & Object Storage (DuckDB) | DuckDB SQL | datasets configurés | AWS S3 · Azure Blob/ADLS · Google Cloud Storage · Direct HTTPS |
Champs communs
Toute connexion comporte ces champs :
- Name (nom) — votre libellé pour cette connexion.
- Dialect (dialecte) — choisissez l’un des dialectes ci-dessus.
- Allowed scope (portée autorisée) — Datarelix ne lit la structure et n’exécute de requêtes qu’à l’intérieur de cette portée. Le libellé change selon le dialecte (schema / database / dataset / index pattern), mais le sens reste le même : une limite stricte autour de ce que Datarelix et son service de requêtes peuvent voir.
Les champs propres au dialecte apparaissent une fois le dialecte choisi. Le guide de chaque dialecte en donne le détail.
Une fois connecté
Datarelix lance la découverte : elle lit les tables, colonnes, types et clés déclarées dans la portée autorisée. Vous pouvez ensuite lancer l’analyse IA du schéma, qui ajoute des descriptions et propose des relations, ainsi que des clés primaires pour les tables qui n’en déclarent pas. L’analyse IA du schéma est décomptée de l’allocation mensuelle de votre forfait, et vous pouvez l’ignorer.
Avant le démarrage de l’analyse, vous pouvez ajouter du contexte facultatif : ce que contient la base, quelles tables comptent le plus, quelles colonnes servent de clés métier. Ces notes sont transmises avec la structure du schéma ; aucune donnée de ligne n’entre dans la découverte ni dans l’analyse IA du schéma.
Les modifications faites sur la page du schéma — descriptions, clés et relations — priment sur ce que la découverte et l’analyse IA du schéma ont trouvé. Elles changent seulement la façon dont Datarelix interprète les questions ; elles ne modifient jamais votre base de données.
Relancez la découverte chaque fois que vous ajoutez des colonnes ou des tables. Vérifiez les descriptions et les relations avant de vous y fier dans une question.
Dépannage général
| Symptôme | Cause probable | Solution |
|---|---|---|
Connection refused | Accessibilité réseau | Autorisez les IP de sortie de Datarelix dans le pare-feu de votre base de données. |
Authentication failed | Identifiants erronés | Testez d’abord avec la CLI ou la console native du dialecte. |
| Schéma vide | Portée incorrecte | Vérifiez Allowed scope — le guide du dialecte indique ce que signifie un champ laissé vide. |
| L’analyse IA du schéma dure trop longtemps | Un schéma très volumineux | Réduisez la portée autorisée, ou ignorez l’analyse IA du schéma et utilisez la découverte seule. |
Pour les messages d’erreur affichés dans l’application, voir le dépannage.