# Connecter un service à une base

> Reliez les variables d'un service aux identifiants générés pour une base, puis lisez-les dans votre code.

Votre code ne connaît ni l'hôte ni le mot de passe de sa base. Il lit une variable d'environnement, par exemple `DATABASE_URL`, que Wakastart remplit à partir des identifiants de la base dans chaque environnement. Ce guide relie cette variable à la base, puis montre comment la lire.

## Avant de commencer

- La base est **Prête** dans l'environnement : voir [Provisionner une base](/v1.0/bases-de-donnees/provisionner-une-base).
- La définition du service déclare la variable attendue, par exemple `DATABASE_URL`. La déclaration des variables est décrite dans [Variables et secrets](/v1.0/variables-et-secrets).
- Le service est déployé dans l'environnement : voir [Services](/v1.0/services).

## Relier la variable

::::steps
### Ouvrir le service

1. Dans le menu latéral, sous le nom de votre application, cliquez sur **Environnements**, puis ouvrez l'environnement.
2. Dans l'onglet **Services**, cliquez sur le service.

### Ouvrir sa configuration

Cliquez sur l'onglet **Configuration du service (N)**.

Chaque variable consommée par le service s'affiche avec une liste de choix.

### Choisir l'identifiant de la base

Pour la variable `DATABASE_URL`, ouvrez la liste **Choisir une valeur...** et sélectionnez l'entrée `<BASE>_URL` de votre base, par exemple `MAINDB_URL`.

Pour des champs séparés, reliez de la même façon `…_HOST`, `…_PORT`, `…_DATABASE`, `…_USERNAME`, `…_PASSWORD` et `…_SSL_MODE`.

### Enregistrer

Cliquez sur **Enregistrer la configuration**.

Le message **Configuration enregistrée** s'affiche. Wakastart redéploie le service avec ses nouvelles variables.
::::

Répétez la liaison dans chaque environnement : la valeur `MAINDB_URL` de `dev` pointe vers la base de `dev`, celle de `prod` vers la base de `prod`.

## Lire les identifiants dans votre code

La variable contient une URL complète. L'exemple suivant, en TypeScript avec le client `pg`, active TLS quand la base l'exige, ce qui est le cas en mode managé. Il suppose que la variable `DATABASE_SSL_MODE` est reliée à `MAINDB_SSL_MODE`.

```typescript
import { Pool } from "pg";

const sslRequired = ["require", "REQUIRED"].includes(process.env.DATABASE_SSL_MODE ?? "");

const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl: sslRequired ? { rejectUnauthorized: false } : undefined,
});

const { rows } = await pool.query("select current_database() as base, current_user as compte");
console.log(rows[0]);
```

:::warning
`rejectUnauthorized: false` chiffre la connexion mais ne vérifie pas le certificat de la base. En production, fournissez le certificat de l'autorité de la base au client (`ssl: { ca: <certificat>, rejectUnauthorized: true }`) pour que la connexion refuse un serveur qui n'est pas le vôtre.
:::

Résultat attendu dans les logs du service :

```text
{ base: 'monapp_maindb', compte: 'monapp_maindb_primary' }
```

En mode managé, la base et le compte portent le préfixe `ws` : `wsmonapp_maindb`, `wsmonapp_maindb_primary`.

:::tip
Avec Prisma 7, l'URL de connexion ne s'écrit plus dans `schema.prisma` : la CLI la lit dans `prisma.config.ts`, et le client la reçoit par un adaptateur.

```typescript
// prisma.config.ts : utilisé par les commandes prisma (migrate, generate…)
import { defineConfig, env } from "prisma/config";

export default defineConfig({
  schema: "prisma/schema.prisma",
  datasource: { url: env("DATABASE_URL") },
});
```

```typescript
// À l'exécution : le client passe par l'adaptateur PostgreSQL (@prisma/adapter-pg)
import { PrismaClient } from "@prisma/client";
import { PrismaPg } from "@prisma/adapter-pg";

const prisma = new PrismaClient({
  adapter: new PrismaPg({ connectionString: process.env.DATABASE_URL }),
});
```

Le bloc `datasource` de `schema.prisma` ne garde que `provider`. Avec Prisma 6, l'URL s'écrit encore dans ce bloc : `url = env("DATABASE_URL")`. Pour MongoDB dans le cluster, l'URL contient déjà `replicaSet=rs0`, que Prisma exige pour les transactions.
:::

## Vérifier le résultat

1. Dans l'onglet **Configuration du service (N)**, la variable affiche son lien vers l'entrée de la base.
2. Dans l'onglet **Logs** du service, aucune erreur de connexion n'apparaît après le redémarrage.

## Dépannage

- **La variable est absente du conteneur** : la base n'était pas encore **Prête** au déploiement. Une entrée qui ne peut pas être résolue est ignorée. Attendez le statut **Prêt**, puis redéployez le service.
- **Connexion refusée par une base managée** : la base exige TLS. Activez-le dans votre client quand `…_SSL_MODE` vaut `require` ou `REQUIRED`, comme dans l'exemple.
## Voir aussi

- [Identifiants de connexion](/v1.0/bases-de-donnees/identifiants-de-connexion)
- [Variables et secrets](/v1.0/variables-et-secrets)
- [Consulter les logs d'un service](/v1.0/supervision/consulter-les-logs)
