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

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

Dans AlloyDB pour PostgreSQL, vos bases de données sont stockées dans des clusters qui contiennent des instances. Dans ce guide de démarrage rapide, vous allez configurer un cluster, vous connecter à son instance, puis insérer et interroger des exemples de données. 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 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 Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking 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 Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking 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

L'API Service Networking est requise si vous prévoyez de configurer la connectivité réseau à AlloyDB à l'aide d'un réseau VPC qui réside dans le même Google Cloud projet 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éseau qui réside dans un autre Google Cloud projet.

1. Choisissez comment vous connecter à AlloyDB.

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 vous 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 vous 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 rapidement un cluster, une instance et un réseau pour votre environnement de développement à l'aide d'une interface Web, suivez les étapes de cet atelier de programmation.

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

   accéder aux clusters

2. Cliquez sur Créer un cluster.

3. Dans Configurer le 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 déroulant Région de 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, cliquez sur Zone unique.

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

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

   4. Dans le menu déroulant Réseau de Connectivité, sélectionnez le réseau default.

      Si vous disposez d'une connexion d'accès privé, passez à l'étape de création d'un cluster. Sinon, cliquez sur Configurer la connexion et procédez comme suit :

      1. Dans Allouer une plage d'adresses IP, cliquez sur Utiliser une plage d'adresses IP attribuée automatiquement.

      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 les étapes décrites dans Connecter un client psql à une instance.

1. Dans la Google Cloud console, 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 la 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 (Instruction exécutée) s'affiche dans le volet Résultats.

Se connecter à la base de données guestbook

1. Dans la Google Cloud console, 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 principale.

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

Vérifier votre connexion à la 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 les éléments suivants 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 (Instruction exécutée) 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 à ce qui suit 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 Google Cloud compte pour les ressources utilisées sur cette page, procédez comme suit :

1. Dans la Google Cloud console, 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. Si vous avez créé une connexion privée lorsque vous avez créé un cluster, accédez à la Google Cloud console page Réseau et cliquez sur Supprimer le réseau VPC.

Étape suivante

• Découvrez d'autres façons de vous connecter à AlloyDB.

• Activez l'accès au projet pour AlloyDB.

• Accordez l'accès à d'autres utilisateurs.

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

• Choisissez un type de machine AlloyDB.

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

• Découvrez les recommandations de dimensionnement.

• Connectez un client psql à une instance.