Connecter une base de données

Datarelix prend en charge les dialectes de base de données ci-dessous, ainsi que l’interrogation directe de fichiers et de stockage objet (DuckDB). Chacun a ses propres modes d’authentification, ses conventions de portée et ses étapes de configuration. Cliquez sur un mode d’authentification ci-dessous pour aller directement à son guide de configuration.

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 du schéma — introspection du schéma et, en option, enrichissement des tables avec des descriptions générées par un LLM. Vous pouvez ignorer l’étape LLM et vous en tenir à l’introspection brute.

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 les métadonnées du schéma ; les invites de découverte ne contiennent que la structure — aucune donnée de ligne n’entre dans la découverte.

La découverte applique cet ordre de priorité pour les métadonnées de schéma servant à planifier les requêtes :

Introspection de la base — tables, colonnes, types et contraintes PK/FK déclarées.
Enrichissement par LLM — descriptions, relations déduites et indices de clé primaire pour les tables sans PK déclarée.
Remplacements par l’utilisateur — bascules PK/FK enregistrées depuis l’écran de revue du schéma.

Vos modifications de PK/FK n’agissent que sur le contexte de planification. Elles ne modifient pas votre base de données et ne réécrivent pas l’instantané d’introspection brut.

Relancez la découverte chaque fois que vous ajoutez des colonnes ou des tables, ou que vous modifiez des descriptions. La découverte est idempotente.

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.
La découverte reste bloquée	Délai dépassé sur l’enrichissement par LLM d’un gros schéma	Utilisez l’introspection brute sans l’étape LLM, ou réduisez la portée autorisée.

Pour les codes d’erreur au niveau de l’API, voir Codes d’erreur.