Skip to main content

Introduction

Ce tutoriel vous emmène de zéro à une base de données connectée et en ligne en quelques minutes : créez l’instance depuis le tableau de bord, récupérez sa chaîne de connexion, et connectez-vous depuis votre propre code.

Prérequis

  • Compte Square Cloud : Créez votre compte via la page d’inscription.
  • Plan Standard actif ou supérieur : Les bases de données gérées nécessitent un plan Standard actif ou supérieur. Consultez les plans disponibles et choisissez celui qui correspond à votre charge de travail.

Étape 1 : choisir un moteur

Square Cloud propose quatre moteurs de base de données gérés, déjà configurés pour être connectés et utilisés immédiatement : Ce tutoriel utilise PostgreSQL, mais le même flux du tableau de bord s’applique à chaque moteur ci-dessus.

Étape 2 : créer la base de données

1

Créer une nouvelle instance de base de données

Rendez-vous sur la page Bases de données et cliquez sur le bouton « Créer une base de données ».
2

Configurer votre instance de base de données

Sélectionnez PostgreSQL (ou le moteur choisi à l’étape 1) et remplissez les informations requises, telles que le nom de la base de données et la RAM.
3

Finaliser la création de votre instance

Cliquez sur le bouton « Créer » et attendez la création de la base de données.

Étape 3 : récupérer la chaîne de connexion

Une fois votre base de données prête, ouvrez-la depuis la page Bases de données. Les détails de connexion (hôte, port, nom d’utilisateur, mot de passe et URL de connexion) sont affichés dans le tableau de bord de la base de données, aux côtés du certificat TLS dont vous aurez besoin pour vous connecter.
Les bases de données Square Cloud n’acceptent que les connexions SSL/TLS. Consultez comment me connecter à ma base de données pour savoir comment le certificat est utilisé par différents clients.

Étape 4 : se connecter depuis votre code

Une fois la chaîne de connexion en main, connectez-vous en utilisant le client PostgreSQL de votre langage.
Installez le paquet pg et activez les modules ES, qu’utilise l’exemple ci-dessous (import et await au niveau supérieur) :
Connectez-vous et vérifiez avec une requête simple :
index.js
Si la requête renvoie un résultat au lieu de lever une erreur de connexion, votre application communique bien avec la base de données.
Ne codez jamais en dur la chaîne de connexion dans votre code source. Définissez-la comme variable d’environnement (DATABASE_URL) dans les Variables d’environnement de votre application sur le tableau de bord, ou avec la commande CLI squarecloud app env set "DATABASE_URL=<connection-url>" --app <appID> (voir les variables d’environnement dans la CLI), afin que les identifiants ne se retrouvent jamais dans votre dépôt. Redémarrez ensuite l’application : elle lit les variables d’environnement au démarrage. Consultez Variables d’environnement.
Gardez certificate.pem dans le ZIP de votre application, car le code le lit sur le disque, mais hors de tout dépôt public.

Prochaines étapes

Vous avez maintenant une base de données gérée qui tourne et est accessible depuis votre code. À partir d’ici :

Déployer une application pour l'utiliser

Hébergez l’application qui se connecte à cette base de données sur Square Cloud.

Erreurs de connexion à la base de données

Corrigez les erreurs SSL/TLS, de délai d’attente et d’accès.

Snapshots

Créez et restaurez des snapshots de base de données depuis la CLI.

Contactez-nous

Si vous rencontrez toujours des difficultés techniques, notre équipe de support spécialisée est disponible pour vous aider. Contactez-nous et nous serons ravis de vous aider à résoudre tout problème. La qualité du support compte pour beaucoup dans la note que les développeurs donnent à Square Cloud, 4,9/5 sur 402 avis sur Google et Trustpilot.