Docs

Se connecter à une base

Les identifiants d’une base, qui peut la joindre, et comment la brancher sur une application, un VPS ou un serveur de jeu.

Les identifiants

L’onglet Connexion de la base donne tout :

ChampValeur
Hôtel’adresse interne au projet
Port5432, 3306 ou 6379 selon le moteur
Utilisateurarkya ; Redis n’en a pas
Basele nom du service, avec des tirets bas : boutique_db pour boutique-db
Mot de passeaffiché une seule fois, à la création
URLune URL modèle, où tu remplaces MOT_DE_PASSE

Le bouton Régénérer donne un nouveau mot de passe. L’ancien cesse aussitôt de marcher : mets à jour les applications qui s’en servent. Une base Redis redémarre pour garder le nouveau.

Qui peut la joindre

DepuisPossible ?
une application du même projetoui, par l’adresse interne
un serveur de jeuoui pour sa base offerte, par une adresse réservée aux machines de jeu
un VPS du même projetoui si tu actives l’accès des VPS, par l’adresse du cluster : voir Depuis un VPS
une application d’un autre projetnon
ton ordinateur, Internetnon

Pour lire et modifier tes données sans client local, utilise l’onglet Données : voir Explorer les données. Pour charger un export, voir Importer un fichier SQL.

Depuis une application

N’écris pas l’adresse interne en dur : utilise une référence, que l’application résout à chaque démarrage. Dans l’onglet Variables de l’application :

.env
DATABASE_URL=postgres://arkya:MOT_DE_PASSE@${boutique-db.URL}/boutique_db

${boutique-db.URL} vaut hôte:port, sans protocole ni identifiants. Les autres formes sont dans Variables et références.

Depuis un VPS

Un VPS rangé dans le même projet peut joindre la base sans qu’elle soit ouverte sur Internet.

  1. Range le VPS dans le projet de la base.
  2. Dans l’onglet Connexion de la base, active Accès depuis les VPS du projet.
  3. Utilise l’adresse du bloc Depuis tes VPS : hôte, port et URL modèle. L’hôte interne ne marche pas depuis un VPS.

Seules les IP des VPS actifs du projet passent, aucune autre. Un VPS ajouté au projet plus tard est autorisé de lui-même, en quelques minutes.

Terminal
psql "postgres://arkya:MOT_DE_PASSE@HÔTE:PORT/boutique_db"

Un utilisateur par application

Une base PostgreSQL ou MariaDB peut porter plusieurs bases et plusieurs utilisateurs. L’onglet Accès les crée, et règle les droits de chaque utilisateur sur chaque base :

NiveauCe qu’il permet
Lectureconsulter
Lecture et écritureajouter, modifier et supprimer des lignes
Toutcréer et modifier ses propres tables en plus

L’utilisateur arkya garde tous les droits. Le mot de passe d’un nouvel utilisateur s’affiche une seule fois.