---
title: "Connecter une base de données"
description: "Comment connecter Datarelix à chaque dialecte pris en charge : modes d’authentification, portée autorisée et découverte du schéma."
canonical: https://docs.datarelix.ai/fr/guides/connections/
---

# 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](/fr/guides/connections/postgres/) | SQL | schéma `public` | [Username & password](/fr/guides/connections/postgres/#username--password) · [Connection string](/fr/guides/connections/postgres/#connection-string) |
| [MySQL](/fr/guides/connections/mysql/) | SQL | base de données connectée | [Username & password](/fr/guides/connections/mysql/#username--password) · [Connection string](/fr/guides/connections/mysql/#connection-string) |
| [Azure SQL / Synapse](/fr/guides/connections/azure-sql/) | T-SQL | schéma `dbo` | [Username & password](/fr/guides/connections/azure-sql/#username--password) · [Connection string](/fr/guides/connections/azure-sql/#connection-string) · [Entra OBO](/fr/guides/connections/azure-sql/#entra-obo) · [Service principal — secret](/fr/guides/connections/azure-sql/#service-principal--client-secret) · [Service principal — certificate](/fr/guides/connections/azure-sql/#service-principal--certificate) |
| [Databricks](/fr/guides/connections/databricks/) | Spark SQL | schéma `default` | [Personal Access Token](/fr/guides/connections/databricks/#personal-access-token-pat) · [OAuth M2M](/fr/guides/connections/databricks/#oauth-m2m-service-principal) · [Federated JWT](/fr/guides/connections/databricks/#federated-jwt-sso) |
| [Kusto (Azure Data Explorer)](/fr/guides/connections/kusto/) | KQL | base de données configurée | [Entra OBO](/fr/guides/connections/kusto/#entra-obo-default) · [App + Certificate](/fr/guides/connections/kusto/#app--certificate) |
| [BigQuery](/fr/guides/connections/bigquery/) | GoogleSQL | choisir un dataset | [Service account JSON](/fr/guides/connections/bigquery/#service-account-json) · [OAuth](/fr/guides/connections/bigquery/#oauth) |
| [Athena](/fr/guides/connections/athena/) | Trino/Presto SQL | choisir une base Glue | [IAM access keys](/fr/guides/connections/athena/#iam-access-keys) · [Assume Role](/fr/guides/connections/athena/#assume-role) |
| [Elasticsearch](/fr/guides/connections/elasticsearch/) | ES\|QL (8.11+) | choisir les index autorisés | [API key](/fr/guides/connections/elasticsearch/#api-key-recommended) · [Basic auth](/fr/guides/connections/elasticsearch/#basic-auth-dev-only) |
| [Snowflake](/fr/guides/connections/snowflake/) | SQL | schéma configuré | [Username & password](/fr/guides/connections/snowflake/#username--password) |
| [Files & Object Storage (DuckDB)](/fr/guides/connections/duckdb-files/) | DuckDB SQL | datasets configurés | [AWS S3](/fr/guides/connections/duckdb-files/#aws-s3) · [Azure Blob/ADLS](/fr/guides/connections/duckdb-files/#azure-blob--adls) · [Google Cloud Storage](/fr/guides/connections/duckdb-files/#google-cloud-storage) · [Direct HTTPS](/fr/guides/connections/duckdb-files/#direct-https-url) |

## 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 :

1. **Introspection de la base** — tables, colonnes, types et contraintes PK/FK déclarées.
2. **Enrichissement par LLM** — descriptions, relations déduites et indices de clé primaire pour les tables sans PK déclarée.
3. **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](/fr/api/errors/).