Créer une base de données et s'y connecter

Créer une base de données et s'y connecter

Cette page vous explique comment créer votre première base de données sur AlloyDB pour PostgreSQL et vous connecter à celle-ci.

Les instructions fournies à la fin de ce guide de démarrage rapide vous expliquent comment nettoyer cette nouvelle base de données. La page se termine par les prochaines étapes à suivre pour en savoir plus sur l'utilisation d'AlloyDB avec vos propres applications.

Avant de commencer

Console

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

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

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

   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

5. Make sure that billing is enabled for your Google Cloud project.

6. Activez les APIs Cloud nécessaires pour créer et vous connecter à AlloyDB pour PostgreSQL.

   Activer les API

   1. À l'étape Confirmer le projet, cliquez sur Suivant pour confirmer le nom du projet que vous allez modifier.

   2. À l'étape Activer les API, cliquez sur Activer pour activer les éléments suivants:

      • API AlloyDB
      • API Compute Engine
      • API Cloud Resource Manager
      • API Service Networking

      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 se trouve dans le même projet Google Cloud qu'AlloyDB.

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

gcloud

1. Créez un projet Google Cloud ou utilisez un projet existant:

   gcloud projects create PROJECT_ID --set-as-default
   # For an existing project
   gcloud config set project PROJECT_ID
   

   Remplacez les éléments suivants :

   • PROJECT_ID: identifiant permanent du projet.

2. Assurez-vous que la facturation est activée pour votre projet Google Cloud . Découvrez comment vérifier que la facturation est activée pour votre projet.

3. Activez les API AlloyDB, Compute Engine et Resource Manager:

   gcloud services enable alloydb.googleapis.com
   gcloud services enable compute.googleapis.com
   gcloud services enable cloudresourcemanager.googleapis.com
   

4. Si vous prévoyez de configurer la connectivité réseau à AlloyDB à l'aide d'un réseau VPC situé dans le même projet Google Cloud qu'AlloyDB, activez l'API Service Networking dans le projet.

   gcloud services enable servicenetworking.googleapis.com
   

5. Si vous prévoyez de configurer la connectivité réseau à AlloyDB à l'aide d'un réseau VPC situé dans un autre projet Google Cloud , vérifiez que les API Compute Engine et Service Networking de ce projet sont activées afin de pouvoir configurer l'accès au VPC partagé et aux services privés dans ce projet.

   gcloud services list
   

Créer un cluster et son instance principale

REMARQUE : Si vous envisagez d'utiliser la mise en réseau privée, vous pouvez déployer à la fois la configuration de mise en réseau privée de votre choix et l'instance AlloyDB, ainsi que des clients tels que des VM Compute Engine à l'aide de Terraform. Pour en savoir plus, consultez la section Solutions de configuration de mise en réseau cloud simplifiées.

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

   accéder aux clusters

2. Cliquez sur Créer un cluster.

3. Dans ID de cluster, saisissez my-cluster.

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

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

6. Sélectionnez la région us-central1 (Iowa).

7. Sélectionnez le réseau par défaut.

   Si vous disposez d'une connexion d'accès privé, passez à l'étape suivante. 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 automatiquement allouée.

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

8. Conservez l'ID d'instance par défaut, my-cluster-primary.

9. Dans Disponibilité zonale, conservez l'option Zone unique. Bien que nous ne recommandions pas d'utiliser une seule zone pour la production, vous en utilisez une dans ce guide de démarrage rapide afin de réduire les coûts. Pour en savoir plus, consultez la section Réduire les coûts à l'aide d'instances de base.

10. Sélectionnez le type de machine 2 vCPU, 16 GB.

11. Conservez les paramètres par défaut sous Connectivité et Sécurité du réseau.

12. Ne modifiez pas les paramètres de la section Afficher les options avancées.

13. Cliquez sur Créer un cluster. La création du cluster et son affichage sur la page Vue d'ensemble du cluster principal peut prendre plusieurs minutes.

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

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

   accéder aux clusters

2. Cliquez sur le nom de votre cluster, my-cluster, dans la colonne Nom de la ressource.

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

   2. Sélectionnez l'utilisateur postgres.

   3. Saisissez le mot de passe que vous avez créé à l'étape Créer un cluster et son instance principale.

   4. Cliquez sur Authentifier. Le volet Explorer 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 saurez 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 aux clusters

2. Cliquez sur le nom de votre cluster, my-cluster, dans la colonne Nom de la ressource.

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éé à l'étape Créer un cluster et son instance principale.

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

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

1. Suivez la procédure décrite 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 des 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 sur cette page ne soient facturées sur votre compte Google Cloud , suivez les étapes ci-dessous.

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

   accéder aux clusters

2. Cliquez sur le nom de votre cluster, my-cluster, dans la colonne Nom de la ressource.

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 page Networking (Réseaux) de la console Google Cloud , puis cliquez sur Delete VPC network (Supprimer le réseau VPC).

Étape suivante

• Activer l'accès au projet pour AlloyDB

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

• Activer l'accès aux services privés

• Créer un cluster et son instance principale

• En savoir plus sur les recommandations de dimensionnement