Créer une base de données Cloud SQL pour PostgreSQL et l'interroger à l'aide de la Google Cloud console

Créer une base de données Cloud SQL pour PostgreSQL et l'interroger à l'aide de la Google Cloud console

MySQL   |  PostgreSQL   |  SQL Server

Découvrez comment créer une base de données Cloud SQL pour PostgreSQL et l'interroger à l'aide de la Google Cloud console. Ce guide de démarrage rapide est destiné aux professionnels des bases de données qui souhaitent une présentation rapide de Cloud SQL pour PostgreSQL. Il vous explique les étapes à suivre pour effectuer les tâches suivantes :

• Créer une instance Cloud SQL pour PostgreSQL
• Créer une base de données
• Créer un schéma
• Créer une table
• Insérer des données
• Interroger les données que vous avez insérées
• Nettoyer vos ressources

Lorsque vous suivez les étapes, conservez les valeurs par défaut des paramètres, sauf indication contraire.

Avant de commencer

Connectez-vous à votre Google Cloud compte. 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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud SQL, Cloud SQL Admin, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud SQL, Cloud SQL Admin, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Rôles requis

Pour obtenir les autorisations nécessaires pour effectuer ce guide de démarrage rapide, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Cloud SQL (roles/cloudsql.admin) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer une instance Cloud SQL pour PostgreSQL

Créez une instance dans la Google Cloud console en utilisant les paramètres suivants. Pour tous les autres paramètres, conservez la valeur par défaut.

1. Accédez à la page "Instances Cloud SQL" dans la Google Cloud console.
   Accéder à la page "Instances Cloud SQL"
2. Cliquez sur Créer une instance.
3. Cliquez sur Choisir Cloud SQL pour PostgreSQL.
4. Dans Choisir une édition Cloud SQL, sélectionnez Enterprise.
5. Dans Préréglage de l'édition, sélectionnez Bac à sable.
6. Dans le champ ID d'instance, saisissez quickstart-instance.
7. Saisissez un mot de passe pour le compte utilisateur par défaut et enregistrez-le pour une utilisation ultérieure.
8. Choisissez une région proche de chez vous.
9. Pour Disponibilité zonale, sélectionnez Zone unique.
10. Cliquez sur Créer une instance, puis attendez que l'instance s'initialise et démarre. Le processus d'initialisation peut prendre plus de cinq minutes.

Conseil : Consultez le tiroir des opérations de longue durée en bas de la Google Cloud console pour surveiller l'état de l'opération de création de votre instance.

Créer une base de données

Une fois l'instance quickstart-instance créée, vous pouvez créer une base de données dans votre instance Cloud SQL pour PostgreSQL.

1. Dans le menu de navigation de l'instance, cliquez sur Bases de données.
2. Cliquez sur Créer une base de données.
3. Dans le champ de texte Nom de la base de données, saisissez quickstartdb.
4. Cliquez sur Créer.

Ajouter un utilisateur

Avant de pouvoir lire ou écrire dans la base de données, vous devez créer un utilisateur de base de données différent de l'utilisateur racine.

1. Dans le menu de navigation de l'instance, cliquez sur Utilisateurs.
2. Cliquez sur Ajouter un compte utilisateur.
3. Dans le volet qui s'ouvre, sélectionnez Authentification intégrée.
4. Dans le champ Nom d'utilisateur, saisissez quickstart-user.
5. Saisissez un mot de passe pour le nouvel utilisateur. Enregistrez ce mot de passe pour une utilisation ultérieure.
6. Cliquez sur Ajouter.

Créer un schéma

Une fois votre instance et votre base de données créées, vous pouvez accéder à Cloud SQL Studio et utiliser l'éditeur de requête pour créer un schéma.

1. Dans le menu de navigation de l'instance, cliquez sur Cloud SQL Studio. Une boîte de dialogue s'affiche.
2. Dans la liste déroulante Base de données, sélectionnez quickstartdb.
3. Sélectionnez Authentification intégrée à la base de données.
4. Dans la liste déroulante Utilisateur, sélectionnez quickstart-user.
5. Dans le champ Mot de passe, saisissez le mot de passe que vous avez choisi pour l'utilisateur dans la section Ajouter un utilisateur.
6. Cliquez sur Authentifier. Cloud SQL Studio s'ouvre.
7. Cliquez sur Requête sans titre pour ouvrir l'éditeur de requête.

8. Collez le code suivant dans l'éditeur de requête :

   CREATE SCHEMA IF NOT EXISTS "myschema";
   

9. Facultatif : Pour mettre en forme correctement l'instruction SQL, cliquez sur Format.

10. Cliquez sur Exécuter. Le volet des résultats affiche un message de réussite.

Créer une table

Créez maintenant une table à l'aide du schéma que vous avez créé.

1. Cliquez sur Nouvel onglet pour ouvrir un nouvel onglet de l'éditeur de requête.

2. Collez l'instruction suivante dans l'éditeur de requête :

   CREATE TABLE IF NOT EXISTS
     "myschema"."quickstart_table" ( "UserId" SERIAL
     PRIMARY KEY
       ,
       "FirstName" VARCHAR(255),
       "LastInitial" VARCHAR(1),
       "BirthDate" DATE );
   

3. Facultatif : Pour mettre en forme correctement l'instruction SQL, cliquez sur Format.

4. Cliquez sur Exécuter. Le volet des résultats affiche un message de réussite.

La base de données quickstartdb comporte désormais une table avec les colonnes permettant de stocker les données suivantes :

• Une colonne d'ID utilisateur à incrémentation automatique configurée comme clé primaire de la table
• Prénom
• Dernière initiale
• Date de naissance

Insérer des données

Pour ajouter des données à la table quickstart_table, procédez comme suit :

1. Cliquez sur Nouvel onglet pour ouvrir un nouvel onglet de l'éditeur de requête.

2. Collez l'instruction suivante dans l'éditeur de requête :

   INSERT INTO
     "myschema"."quickstart_table" ("FirstName",
       "LastInitial",
       "BirthDate")
   VALUES
     ('Yuri', 'Z', '1999-05-24'),
     ('Cruz', 'S', '1978-11-01'),
     ('Kai', 'D', '1965-12-09'),
     ('Luka', 'L', '2003-04-19'),
     ('Taylor', 'S', '2001-01-31');
   

3. Facultatif : Pour mettre en forme correctement l'instruction SQL, cliquez sur Format.

4. Cliquez sur Exécuter. Le volet des résultats affiche un message de réussite.

Interroger la base de données

Vous pouvez maintenant exécuter des requêtes sur les données de la table que vous avez créée.

Sélectionner tous les enregistrements

Pour récupérer tous les enregistrements de la table, procédez comme suit :

1. Cliquez sur Nouvel onglet pour ouvrir un nouvel onglet de l'éditeur de requête.

2. Collez l'instruction suivante dans l'éditeur de requête :

   SELECT
     *
   FROM
     "myschema"."quickstart_table"
   

3. Cliquez sur Exécuter.

   Les résultats de la requête sont semblables à ceux-ci :

   UserID	FirstName	LastInitial	BirthDate
   1	Yuri	Z	1999-05-24 00:00:00
   2	Cruz	S	1978-11-01 00:00:00
   3	Kai	D	1965-12-09 00:00:00
   4	Luka	L	2003-04-19 00:00:00
   5	Taylor	S	2001-01-31 00:00:00

Exécuter une instruction de sélection filtrée

Pour récupérer l'ID utilisateur et le prénom des utilisateurs nés le 1er janvier 2000 ou après, spécifiez les colonnes et utilisez une clause WHERE :

1. Cliquez sur Nouvel onglet pour ouvrir un nouvel onglet de l'éditeur de requête.

2. Collez l'instruction suivante dans l'éditeur de requête :

   SELECT
     "UserId",
     "FirstName"
   FROM
     "myschema"."quickstart_table"
   WHERE
     "BirthDate" > '1999-12-31';
   

3. Cliquez sur Exécuter.

   Les résultats de la requête sont semblables à ceux-ci :

   UserID	FirstName
   4	Luka
   5	Taylor

Effectuer un nettoyage

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

Désactivez la protection contre la suppression, puis supprimez l'instance du guide de démarrage rapide :

1. Dans le menu de navigation de l'instance, cliquez sur Aperçu.
2. Cliquez sur Modifier.
3. Développez la section Protection des données.
4. Dans Protection contre la suppression d'instance, désélectionnez toutes les options.
5. Cliquez sur Enregistrer. Supprimer est désormais sélectionnable.
6. Cliquez sur Supprimer. Une boîte de dialogue s'affiche.
7. Dans le champ ID d'instance, saisissez quickstart-instance.
8. Cliquez sur Supprimer.

Étape suivante

• Configurer une adresse IP publique
• Fonctionnalités de Cloud SQL pour PostgreSQL