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 y connecter.

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

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.

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 (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

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

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 (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

Verify that billing is enabled for your Google Cloud project.

1. Activez les API Cloud nécessaires pour créer une instance AlloyDB pour PostgreSQL et vous y connecter.

   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 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 qui réside dans un autre projet Google Cloud .

2. Choisissez comment vous connecter à AlloyDB.

gcloud

1. Créez un projet Google Cloud ou utilisez-en un 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 qui réside 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 qui réside dans un autre projet Google Cloud , vérifiez que les API Compute Engine et Service Networking sont activées dans ce projet. Vous pourrez ainsi configurer le VPC partagé et l'accès privé aux services 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 les VM Compute Engine, à l'aide de Terraform. Pour en savoir plus, consultez Solutions de configuration simplifiée de la mise en réseau cloud.

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 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 d'utiliser une instance à zone unique pour la production, vous pouvez utiliser une zone unique dans ce guide de démarrage rapide pour minimiser les coûts. Pour en savoir plus, consultez 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é du réseau.

5. Cliquez sur Créer un cluster. AlloyDB peut mettre plusieurs minutes à créer le cluster et à l'afficher sur la page Présentation du cluster principal.

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 à 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 saurez que votre base de données a été créée lorsque le message Statement executed successfully s'affichera 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 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 les informations suivantes 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. Si vous avez créé une connexion privée lorsque vous avez créé un cluster, accédez à la page Mise en réseau de la console Google Cloud , puis cliquez sur Supprimer le réseau VPC.

Étapes suivantes

• Activer l'accès au projet pour AlloyDB

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

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

• Choisissez un type de machine AlloyDB.

• Créer un cluster et son instance principale

• En savoir plus sur les recommandations de taille