Guide de démarrage rapide pour utiliser Cloud SQL pour PostgreSQL

Cette page vous explique comment créer une instance PostgreSQL et vous y connecter. Elle décrit également comment effectuer des opérations SQL de base à l'aide de Google Cloud Console et d'un client. Les ressources créées dans ce guide de démarrage rapide coûtent généralement moins d'un dollar, en supposant que vous effectuiez les étapes, y compris le nettoyage, en temps opportun.

Configurer votre projet

Avant de suivre les étapes de ce guide de démarrage rapide, réalisez les tâches suivantes :

  1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Assurez-vous de disposer du rôle Client Cloud SQL sur votre compte utilisateur.

    Accéder à la page IAM

  5. Activez l'API Cloud SQL Admin.

    Activer l'API

Créer une instance Cloud SQL

Dans cette procédure, vous utilisez Google Cloud Console. Pour utiliser l'outil de ligne de commande gcloud, cURL ou PowerShell, consultez la page Créer des instances.

  1. Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Cliquez sur Create Instance (Créer une instance).
  3. Cliquez sur PostgreSQL.
  4. Si vous êtes invité à activer l'API Compute, cliquez sur le bouton Activer l'API.
  5. Dans le champ ID d'instance, saisissez myinstance.
  6. Indiquez le mot de passe de l'utilisateur postgres.
  7. Utilisez les valeurs par défaut dans les autres champs.
  8. Cliquez sur Créer.

    Vous êtes redirigé vers la liste des instances. Vous pouvez cliquer directement sur la nouvelle instance pour en afficher les détails, mais elle ne sera disponible qu'une fois initialisée et démarrée.

    Remarque : Dans cet exemple, l'instance est créée à l'aide des paramètres par défaut, y compris une adresse IP publique.

Se connecter à l'instance à l'aide du client psql dans Cloud Shell

  1. Dans Google Cloud Console, cliquez sur l'icône Cloud Shell (Icône Cloud Shell) dans l'angle supérieur droit.

    Une fois l'initialisation de Cloud Shell terminée, le message suivant s'affiche :

    Welcome to Cloud Shell! Type "help" to get started.
    username@example-id:~$
    
  2. Lorsque l'invite Cloud Shell s'affiche, connectez-vous à votre instance Cloud SQL :

    gcloud sql connect myinstance --user=postgres
    
  3. Saisissez votre mot de passe postgres.

    L'invite psql s'affiche.

Créer une base de données et importer des données

  1. Créez une base de données SQL sur votre instance Cloud SQL :
    CREATE DATABASE guestbook;
    
  2. Connectez-vous à la base de données :
    \connect guestbook;
    
  3. Insérez des échantillons de données dans la base de données :
    CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255),
                            entryID SERIAL PRIMARY KEY);
    INSERT INTO entries (guestName, content) values ('first guest', 'I got here!');
    INSERT INTO entries (guestName, content) values ('second guest', 'Me too!');
    
  4. Récupérez les données :
    SELECT * FROM entries;
    
    Vous obtenez le résultat suivant :
      guestname   |   content   | entryid
    --------------+-------------+---------
     first guest  | I got here! |       1
     second guest | Me too!     |       2
    (2 rows)
    postgres=>
    

Nettoyage

  1. Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Sélectionnez le nom de l'instance pour ouvrir la page Présentation.
  3. Dans la barre d'icônes en haut de la page, cliquez sur Supprimer.
  4. Dans la fenêtre Supprimer l'instance, saisissez le nom de l'instance, puis cliquez sur Supprimer pour supprimer l'instance.

    Vous ne pouvez pas réutiliser le nom d'une instance pendant environ sept jours après la suppression de cette instance.

Étape suivante

En fonction de vos besoins, vous pouvez en apprendre plus sur la création d'instances Cloud SQL.

Vous pouvez également découvrir comment créer des utilisateurs et des bases de données PostgreSQL pour votre instance Cloud SQL.

Consultez également les informations tarifaires de Cloud SQL.

Dans ce guide de démarrage rapide, vous vous êtes connecté à l'instance à l'aide de Cloud Shell. Dans la plupart des cas d'utilisation, la manière dont vous vous connectez dépend de votre configuration réseau, par exemple :

  • Si votre instance Cloud SQL possède une adresse IP publique ou privée.
  • Si vous vous connectez à partir de Google Cloud (depuis le même projet ou un autre projet).
  • Si vous vous connectez en dehors de Google Cloud.

En savoir plus :

Vous pouvez également en savoir plus sur la connexion à une instance Cloud SQL à partir d'autres applications Google Cloud :