Se connecter à Cloud SQL pour PostgreSQL depuis Cloud Shell

Se connecter à Cloud SQL pour PostgreSQL depuis Cloud Shell

MySQL | PostgreSQL | SQL Server

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 la console Google Cloud 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.

Avant de commencer

Remarque : Le nom que vous utilisez pour votre projet doit comporter entre 4 et 30 caractères. Lorsque vous saisissez ce nom, le formulaire suggère un ID de projet que vous pouvez modifier. L'ID du projet doit contenir entre 6 et 30 caractères et commencer par une lettre minuscule. Vous pouvez utiliser un tiret, une lettre minuscule ou un chiffre pour chacun des autres caractères, mais le dernier caractère ne peut pas être un tiret.

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 sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Activez les API Google Cloud nécessaires.

   Console

   Dans la console Google Cloud , accédez à la page API.

   Accéder aux API

   Activez l'API Cloud SQL Admin.

   gcloud

   Cliquez sur le bouton suivant pour ouvrir Cloud Shell, qui fournit un accès en ligne de commande à vos ressources Google Cloud directement depuis le navigateur. Cloud Shell peut être utilisé pour exécuter les commandes gcloud présentées dans ce guide de démarrage rapide.

   Ouvrir Cloud Shell

   Exécutez la commande gcloud services enable comme suit à l'aide de Cloud Shell pour activer les API requises pour ce guide de démarrage rapide :

   gcloud services enable sqladmin.googleapis.com

   Cette commande active les API suivantes :

   • API Cloud SQL Admin

2. Assurez-vous de disposer du ou des rôles suivants sur le projet : Administrateur Cloud SQL (roles/cloudsql.admin)

   Vérifier les rôles

   1. Dans la console Google Cloud , accédez à la page IAM.

      Accéder à IAM
   2. Sélectionnez le projet.

   3. Dans la colonne Compte principal, recherchez toutes les lignes qui vous identifient ou identifient un groupe dont vous faites partie. Pour savoir à quels groupes vous appartenez, contactez votre administrateur.

   4. Pour toutes les lignes qui vous spécifient ou vous incluent, consultez la colonne Rôle pour vous assurer que la liste inclut les rôles requis.

   Attribuer les rôles

   1. Dans la console Google Cloud , accédez à la page IAM.

      Accéder à IAM
   2. Sélectionnez le projet.
   3. Cliquez sur  Accorder l'accès.

   4. Dans le champ Nouveaux comptes principaux, saisissez votre identifiant utilisateur. Il s'agit généralement de l'adresse e-mail d'un compte Google.

   5. Cliquez sur Sélectionner un rôle, puis recherchez le rôle.
   6. Pour attribuer des rôles supplémentaires, cliquez sur  Ajouter un autre rôle et ajoutez tous les rôles supplémentaires.
   7. Cliquez sur Enregistrer.

Créer une instance Cloud SQL

Dans ce guide de démarrage rapide, vous utilisez la console Google Cloud . Pour utiliser la gcloud CLI, cURL ou PowerShell, consultez la section Créer des instances.

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

   Accéder à la page Instances Cloud SQL

2. Cliquez sur Créer une instance.
3. Cliquez sur Choisir PostgreSQL.
4. Dans le champ ID d'instance, saisissez myinstance.
5. Dans le champ Mot de passe, entrez le mot de passe de l'utilisateur postgres.

6. Cliquez sur Créer une instance.

   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 pour les autres opérations 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 à votre instance

Dans ce guide de démarrage rapide, nous utiliserons le client psql dans Cloud Shell pour vous connecter à votre instance. Cloud Shell est un environnement distant et sandboxé.

Remarque : Cloud Shell ne fonctionne pas avec une adresse IP privée. Ces instructions ne concernent qu'une instance dotée d'une adresse IP publique.

1. Facultatif : Si vous exécutez une instance locale de PostgreSQL, arrêtez-la avant de vous connecter à votre instance Cloud SQL. Sinon, vous pourriez rencontrer des erreurs du type address already in use.

2. Dans la consoleGoogle Cloud , cliquez sur l'icône Cloud Shell () en haut à droite.

   Une fois l'initialisation de Cloud Shell terminée, un message, tel que celui présenté ci-dessous, s'affiche :

   Welcome to Cloud Shell! Type "help" to get started.
   Your Cloud Platform project in this session is set to sample-project.
   Use "gcloud config set project [PROJECT_ID]" to change to a different project.
   username@sample-project:~ (sample-project)$
   

3. Facultatif : Si vous n'avez pas autorisé la gcloud CLI à accéder à la plate-forme Google Cloud avec vos identifiants Google, utilisez la commande gcloud auth login.

4. Lorsque l'invite Cloud Shell s'affiche, connectez-vous à votre instance Cloud SQL. Utilisez la commande gcloud sql connect comme suit. Remplacez le nom de l'instance si le nom de votre instance est différent.

   gcloud sql connect myinstance --user=postgres

5. Dans la boîte de dialogue, cliquez sur Autoriser pour autoriser Cloud Shell à effectuer des appels d'API.

   Le message suivant s'affiche :

   Allowlisting your IP for incoming connection for 5 minutes...done.
   

   Ce message indique que l'adresse IP publique de votre instance Cloud SQL est autorisée à recevoir des connexions entrantes. Après ce message, vous êtes invité à saisir votre mot de passe.

6. 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 en saisissant la commande suivante et en spécifiant votre mot de passe.

   \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;

   Le résultat est :

     guestname   |   content   | entryid
   --------------+-------------+---------
    first guest  | I got here! |       1
    second guest | Me too!     |       2
   (2 rows)
   postgres=>
   

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , procédez comme suit :

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

   Accéder à la page Instances Cloud SQL

2. Sélectionnez l'instance myinstance pour ouvrir la page Détails de l'instance.
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.

Étapes de nettoyage facultatives

Si vous n'utilisez pas les API activées dans le cadre de ce démarrage rapide, vous pouvez les désactiver.

• API activées dans ce guide de démarrage rapide :
  • API Cloud SQL Admin

1. Dans la console Google Cloud , accédez à la page API.

   Accéder aux API

2. Sélectionnez l'API Cloud SQL Admin, puis cliquez sur le bouton Désactiver l'API.

Étape suivante

• Découvrez comment créer des instances Cloud SQL.

• Découvrez comment créer des utilisateurs PostgreSQL et des bases de données pour votre instance Cloud SQL.

• Consultez les informations tarifaires de Cloud SQL.

• Dans ce guide de démarrage rapide, vous vous êtes connecté à l'instance à l'aide de Cloud Shell. Découvrez toutes les options de connectivité dans Cloud SQL. La manière dont vous vous connectez dépend de votre configuration réseau, par exemple si votre instance Cloud SQL dispose d'une adresse IP publique ou privée. Découvrez comment configurer votre instance Cloud SQL avec une adresse IP publique et une adresse IP privée.

• Découvrez comment vous connecter à une instance Cloud SQL à partir d'autres applications Google Cloud :

  • Depuis une application s'exécutant dans l'environnement standard App Engine
  • Depuis une application s'exécutant sur Compute Engine
  • depuis une application s'exécutant sur GKE ;
  • Depuis Cloud Run