# Référence des bases de données

> Écrans, champs, valeurs acceptées, statuts et entrées de configuration d'une base de données Wakastart.

Les bases de données se pilotent depuis la console Wakastart. Il n'existe pas d'API publique d'hébergement pour les clients.

## Écrans

| Écran | Chemin dans la console | Droit requis à l'écran |
|---|---|---|
| Déclarations | *app* › **Architecture** › **Dépendances**, onglet **Bases de données (N)** | « Infra Client » |
| Nouvelle déclaration | **Dépendances** › **Nouvelle base** | « Infra Client » |
| Instances d'un environnement | *app* › **Environnements** › *environnement* › onglet **Databases** | « Infra Client » |
| Nouvelle instance | onglet **Databases** › **Nouvelle instance** | « Provisionner une base de données » |
| Détail d'une instance | clic sur une ligne de l'onglet **Databases** ; onglets **Vue générale** et **Backups** | « Infra Client » |
| Modifier les ressources | détail › carte **Ressources** › **Modifier** (bases dans le cluster) | « Provisionner une base de données » |
| Supprimer une instance | corbeille de l'onglet **Databases** | « Supprimer une base de données » |

Dans un environnement de production, chaque action demande en plus le droit « Accès infrastructure en production ».

## Déclaration d'une base

| Champ à l'écran | Obligatoire | Valeurs acceptées | Par défaut | Modifiable ensuite |
|---|---|---|---|---|
| **Nom \*** | oui | 100 caractères au plus | — | non, depuis la console |
| **Shortname \*** | oui | 12 caractères au plus, `^[a-z][a-z0-9-]*$`, unique dans l'application | dérivé du nom | non |
| **Type de base de données \*** | oui | **PostgreSQL**, **MySQL**, **MongoDB**, **Valkey (Redis)** | **PostgreSQL** | non |
| **Mode par défaut** | non | `IN_CLUSTER`, `MANAGED` | `IN_CLUSTER` | non, depuis la console |
| **Version par défaut** | non | voir [versions](#versions-et-offres) ; sans effet dans le cluster | selon le moteur | non, depuis la console |
| **Plan par défaut** (`MANAGED`) | non | voir [offres](#versions-et-offres) | `essential` | non, depuis la console |
| **Région par défaut** (`MANAGED`) | non | `gra`, `sbg`, `bhs`, `waw`, `de`, `uk` | `gra` | non, depuis la console |
| **Taille disque par défaut (GB)** (`MANAGED`) | non | nombre entier de Go | 50 | non, depuis la console |
| **Taille stockage par défaut** (`IN_CLUSTER`) | non | quantité Kubernetes, par exemple `10Gi` | `10Gi` | non, depuis la console |

## Instance dans un environnement

| Champ à l'écran | Valeurs acceptées | Vide |
|---|---|---|
| **Définition \*** | une déclaration sans instance dans l'environnement | — |
| **Mode** | **In-Cluster**, **Managed** | mode de la déclaration |
| **Version** (managée) | voir [versions](#versions-et-offres) | version de la déclaration, sinon défaut du moteur |
| **Plan** (managée) | voir [offres](#versions-et-offres) | offre de la déclaration, sinon `essential` |
| **Région** (managée) | code OVHcloud en minuscules | région de la déclaration, sinon `gra` |
| **Taille disque (Go)** (managée) | nombre entier de Go | taille de la déclaration, sinon 50 |

Une seule instance active par déclaration et par environnement.

### Ressources (bases dans le cluster)

| Champ | Format | Maximum | Vide |
|---|---|---|---|
| **CPU demandé**, **CPU maximum** | entier + `m` | `2000m` | valeur par défaut du chart |
| **Mémoire demandée**, **Mémoire maximum** | nombre + `Mi` ou `Gi` | `8Gi` | valeur par défaut du chart |

## Versions et offres

| Moteur | Dans le cluster | Versions managées | Offres managées |
|---|---|---|---|
| PostgreSQL | 16 | `14`, `15`, `16` (défaut `16`) | `essential`, `business`, `enterprise` |
| MySQL | 8.0 | `8` | `essential`, `business`, `enterprise` |
| MongoDB | 7 | `6.0`, `7.0` (défaut `7.0`) | `discovery`, `production`, `advanced` |
| Valkey | 8.0 | `8.0`, `8.1` (défaut `8.1`) | `essential`, `business`, `enterprise` |

## Statuts

| Code | Libellé | Terminal |
|---|---|---|
| `PENDING` | **En attente** | non |
| `PROVISIONING` | **Provisionnement** | non |
| `READY` | **Prêt** | non |
| `FAILED` | **Échec** | non, nouvel essai automatique |
| `DESTROYING` | **Suppression** | non |
| `DESTROYED` | **Supprimé** | oui |

Santé : **Sain**, **Non sain**, **Inconnu**, **N/A**. Voir [Cycle de vie d'une base de données](/v1.0/bases-de-donnees/cycle-de-vie).

## Propriétés affichées sur la page d'une instance

**Moteur**, **Version**, **Mode**, **Région**, **Host**, **Port**, **Plan**, **Taille disque**, **Slot actif**, **Instance ID**, **Créé le**.

## Entrées de configuration générées

Pour une base de shortname `maindb`, l'onglet **Configuration** de l'environnement, filtre **Base**, contient :

| Clé | Champ | Valeur visible |
|---|---|---|
| `MAINDB_URL` | `url` | non (sensible) |
| `MAINDB_HOST` | `host` | oui |
| `MAINDB_PORT` | `port` | oui |
| `MAINDB_DATABASE` | `database` | oui |
| `MAINDB_USERNAME` | `username` | oui |
| `MAINDB_PASSWORD` | `password` | non (sensible) |
| `MAINDB_SSL_MODE` | `ssl_mode` | oui |

Ports par défaut dans le cluster : 5432 (PostgreSQL), 3306 (MySQL), 27017 (MongoDB), 6379 (Valkey).

## Limites

| Élément | Valeur |
|---|---|
| Instances par déclaration et par environnement | 1 |
| Comptes applicatifs par instance | 2 (`primary`, `secondary`) |
| Réplicas d'une base dans le cluster | 1 |
| Nœuds d'une base MongoDB managée | 3 au minimum |
| Durée maximale de création avant échec | 60 minutes |
| Délai entre deux essais après échec | de 30 secondes à 15 minutes |
| Rafraîchissement des identifiants dans les conteneurs | 5 minutes |
