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

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

Pour commencer à utiliser AlloyDB pour PostgreSQL dans la console Google Cloud , vous pouvez créer un cluster et une instance principale, vous connecter à l'instance à l'aide d'AlloyDB Studio, puis insérer et interroger des exemples de données. Dans AlloyDB, vos bases de données sont stockées dans des clusters qui contiennent des instances. Pour en savoir plus sur l'architecture, les clusters et les instances AlloyDB, consultez la présentation d'AlloyDB.

Avant de commencer

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

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 Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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 Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

1. L'API Service Networking est requise si vous prévoyez de configurer la connectivité réseau à AlloyDB à l'aide d'un réseau cloud privé virtuel (VPC) qui réside dans le même projet Google Cloud qu'AlloyDB.

   Les API Compute Engine et Cloud Resource Manager sont requises si vous prévoyez de configurer la connectivité réseau à AlloyDB à l'aide d'un réseau VPC résidant dans un autre projet Google Cloud .

2. Choisissez une option de connectivité.

Rôles requis

Pour obtenir les autorisations nécessaires pour créer une base de données AlloyDB et vous y connecter, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

• Administrateur de réseaux Compute (roles/compute.networkAdmin)
• Administrateur AlloyDB (roles/alloydb.admin)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour créer une base de données AlloyDB et s'y connecter. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour créer une base de données AlloyDB et s'y connecter :

• compute.networks.list
• compute.networks.addPeering
• compute.addresses.create
• servicenetworking.services.addPeering
• alloydb.clusters.create
• alloydb.instances.create
• alloydb.instances.login

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

Créer un cluster et son instance AlloyDB principale

Remarque : Pour configurer un cluster, une instance et un réseau pour votre environnement de développement à l'aide d'un guide interactif, suivez les étapes de l'atelier de programmation sur la configuration d'AlloyDB.

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

   accéder aux clusters

2. Cliquez sur Créer un cluster.

3. Dans Configurer votre cluster, procédez comme suit :

   1. Dans le champ ID du cluster, saisissez my-cluster.

   2. Saisissez un mot de passe. Notez ce mot de passe, car vous l'utiliserez dans ce guide de démarrage rapide.

   3. Conservez la version de base de données par défaut.

   4. Dans le menu Région sous Emplacement, sélectionnez la région us-central1 (Iowa).

4. Dans Configurer votre instance principale, procédez comme suit :

   1. Dans le champ ID d'instance, saisissez my-cluster-primary.

   2. Dans Disponibilité zonale, sélectionnez Zone unique.

      Remarque : Bien que nous ne recommandions pas d'instance à zone unique pour la production, vous pouvez utiliser une seule zone dans ce guide de démarrage rapide pour réduire les coûts. Pour en savoir plus, consultez Réduire les coûts en utilisant des instances de base.

   3. Dans le menu Type de machine, sélectionnez le type de machine 2 vCPU, 16 GB.

   4. Dans le menu Réseau sous Connectivité, sélectionnez le réseau default.

      Si vous avez configuré une connexion d'accès aux services privés, passez à l'étape suivante. Sinon, cliquez sur Configurer la connexion et suivez ces étapes :

      1. Dans Allouer une plage d'adresses IP, sélectionnez Utiliser une plage d'adresses IP automatiquement allouée.

      2. Cliquez sur Continuer, puis sur Créer une connexion.

   5. Conservez les paramètres par défaut sous Sécurité réseau.

5. Cliquez sur Créer un cluster. La création du cluster par AlloyDB et son affichage sur la page Présentation du cluster principal peuvent prendre plusieurs minutes.

Se connecter à votre instance et créer une base de données dans AlloyDB Studio

Remarque : Pour connecter un client psql à une instance, suivez la procédure décrite dans Se connecter depuis Compute Engine.

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

   Accéder à la page Clusters

2. Dans la colonne Nom de la ressource, cliquez sur le nom de votre cluster, my-cluster.

3. Dans le volet de navigation, cliquez sur AlloyDB Studio.

4. Sur la page Se connecter à AlloyDB Studio, procédez comme suit :

   1. Choisissez une méthode d'authentification de base de données.

   2. Sélectionnez la base de données postgres.

   3. Cliquez sur Authentifier. Le volet Explorateur affiche la liste des objets de la base de données postgres.

5. Pour créer une base de données, saisissez l'instruction suivante dans l'onglet Éditeur 1, puis cliquez sur Exécuter :

   CREATE DATABASE guestbook;
   

   Vous savez que votre base de données est créée lorsque le message Statement executed successfully s'affiche dans le volet Résultats.

Se connecter à la base de données guestbook

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

   Accéder à la page Clusters

2. Dans la colonne Nom de la ressource, cliquez sur le nom de votre cluster, my-cluster.

3. Dans le volet de navigation, cliquez sur AlloyDB Studio.

4. Sur la page Se connecter à AlloyDB Studio, procédez comme suit :

   1. Sélectionnez la base de données guestbook.

   2. Sélectionnez l'utilisateur postgres.

   3. Saisissez le mot de passe que vous avez créé dans Créer un cluster et son instance AlloyDB principale.

   4. Cliquez sur Authentifier. Le volet Explorateur affiche la liste des objets de la base de données guestbook.

Vérifier la connexion à votre base de données

1. Suivez les étapes décrites dans Se connecter à la base de données guestbook.

2. Pour insérer des exemples de données dans la base de données guestbook, saisissez ce qui suit dans l'onglet Éditeur 1 :

   CREATE TABLE entries (guestName VARCHAR(255),
                         content VARCHAR(255),
                         entryID SERIAL PRIMARY KEY);
   INSERT INTO entries (guestName, content) values ('Alex', 'I got here!');
   INSERT INTO entries (guestName, content) values ('Kai', 'Me too!');
   

3. Cliquez sur Exécuter. Le message Statement executed successfully dans le volet Résultats indique que les données sont insérées dans votre base de données.

4. Pour supprimer du texte de l'onglet Éditeur 1 afin de pouvoir exécuter une autre commande, cliquez sur Effacer.

5. Pour sélectionner toutes les entrées de la base de données, saisissez la requête suivante dans l'onglet Éditeur 1 :

   SELECT * FROM entries;
   

6. Cliquez sur Exécuter. Un résultat semblable à celui-ci s'affiche dans le volet Résultats :

       guestname     | content     | entryid
       --------------+-------------+---------
       Alex          | I got here! | 1
       Kai           | Me too!     | 2
   

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 Clusters.

   Accéder à la page Clusters

2. Dans la colonne Nom de la ressource, cliquez sur le nom de votre cluster, my-cluster.

3. Cliquez sur Supprimer le cluster.

4. Dans Supprimer le cluster my-cluster, saisissez my-cluster pour confirmer que vous souhaitez supprimer votre cluster.

5. Cliquez sur Supprimer.

6. Facultatif : Si vous avez créé une connexion d'accès aux services privés lorsque vous avez créé le cluster et que vous n'avez plus besoin de la plage d'adresses IP allouée, suivez les étapes de la section Supprimer une plage d'adresses IP allouée pour l'accès aux services privés.

Étapes suivantes

• Découvrez d'autres moyens de vous connecter à AlloyDB.

• Accorder l'accès à d'autres utilisateurs

• Activez l'accès aux services privés.

• Choisissez un type de machine AlloyDB.

• Créez un cluster AlloyDB et son instance principale.

• En savoir plus sur les recommandations de dimensionnement

• Se connecter depuis Compute Engine