Se connecter à Cloud SQL pour PostgreSQL depuis Cloud Shell
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
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure 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.
-
Make sure that billing is enabled for your Google Cloud project.
-
Activez les API Google Cloud nécessaires.
Console
Dans Google Cloud Console, accédez à la page 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.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
Créer une instance Cloud SQL
Dans ce guide de démarrage rapide, vous utilisez Google Cloud Console. Pour utiliser gcloud CLI, cURL ou PowerShell, consultez la section Créer des instances.
-
Dans la console Google Cloud, accédez à la page Instances Cloud SQL.
- Cliquez sur Créer une instance.
- Cliquez sur Choisir PostgreSQL.
- Dans le champ ID d'instance, saisissez
myinstance
. - Dans le champ Mot de passe, saisissez un mot de passe pour l'utilisateur
postgres
. 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.
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 en bac à sable.
- 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
. Dans la console Google Cloud, cliquez sur l'icône Cloud Shell () dans l'angle supérieur droit.
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)$
- Facultatif: Si vous n'avez pas autorisé gcloud CLI à accéder à Google Cloud Platform avec vos identifiants utilisateur Google, utilisez la commande
gcloud auth login
. 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
- 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 les connexions entrantes sont autorisées sur l'adresse IP publique de votre instance Cloud SQL. Vous êtes ensuite invité à saisir votre mot de passe.
Saisissez votre mot de passe postgres.
L'invite
psql
s'affiche.
Créer une base de données et importer des données
- Créez une base de données SQL sur votre instance Cloud SQL :
CREATE DATABASE guestbook;
- Connectez-vous à la base de données en saisissant la commande suivante et en spécifiant votre mot de passe.
\connect guestbook;
- 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!');
- Récupérez les données :
Le résultat est :SELECT * FROM entries;
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 sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :
-
Dans Google Cloud Console, accédez à la page Instances Cloud SQL.
- Sélectionnez l'instance
myinstance
pour ouvrir la page Détails de l'instance. - Dans la barre d'icônes en haut de la page, cliquez sur Supprimer.
- 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
Dans Google Cloud Console, accédez à la page API.
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 :