GSP1083
Présentation
AlloyDB pour PostgreSQL est un service de base de données entièrement géré compatible avec PostgreSQL pour les charges de travail d'entreprise les plus exigeantes. AlloyDB associe le meilleur de Google à l'un des moteurs de base de données Open Source les plus utilisés, PostgreSQL, pour des performances, une évolutivité et une disponibilité optimales.
Dans cet atelier, vous allez effectuer plusieurs tâches essentielles pour créer et gérer des instances et des bases de données AlloyDB pour PostgreSQL.
Objectifs de l'atelier
Dans cet atelier, vous allez apprendre à effectuer les tâches suivantes :
- Créer un cluster et une instance
- Créer des tables et insérer des données dans votre base de données
- Utiliser Google Cloud CLI avec AlloyDB
- Supprimer une instance
Préparation
Avant de cliquer sur le bouton "Démarrer l'atelier"
Lisez ces instructions. Les ateliers sont minutés, et vous ne pouvez pas les mettre en pause. Le minuteur, qui démarre lorsque vous cliquez sur Démarrer l'atelier, indique combien de temps les ressources Google Cloud resteront accessibles.
Cet atelier pratique vous permet de suivre les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Des identifiants temporaires vous sont fournis pour vous permettre de vous connecter à Google Cloud le temps de l'atelier.
Pour réaliser cet atelier :
- Vous devez avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome).
Remarque : Ouvrez une fenêtre de navigateur en mode incognito (recommandé) ou de navigation privée pour effectuer cet atelier. Vous éviterez ainsi les conflits entre votre compte personnel et le compte temporaire de participant, qui pourraient entraîner des frais supplémentaires facturés sur votre compte personnel.
- Vous disposez d'un temps limité. N'oubliez pas qu'une fois l'atelier commencé, vous ne pouvez pas le mettre en pause.
Remarque : Utilisez uniquement le compte de participant pour cet atelier. Si vous utilisez un autre compte Google Cloud, des frais peuvent être facturés à ce compte.
Démarrer l'atelier et se connecter à la console Google Cloud
-
Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, une boîte de dialogue s'affiche pour vous permettre de sélectionner un mode de paiement.
Sur la gauche, vous trouverez le panneau "Détails concernant l'atelier", qui contient les éléments suivants :
- Le bouton "Ouvrir la console Google Cloud"
- Le temps restant
- Les identifiants temporaires que vous devez utiliser pour cet atelier
- Des informations complémentaires vous permettant d'effectuer l'atelier
-
Cliquez sur Ouvrir la console Google Cloud (ou effectuez un clic droit et sélectionnez Ouvrir le lien dans la fenêtre de navigation privée si vous utilisez le navigateur Chrome).
L'atelier lance les ressources, puis ouvre la page "Se connecter" dans un nouvel onglet.
Conseil : Réorganisez les onglets dans des fenêtres distinctes, placées côte à côte.
Remarque : Si la boîte de dialogue Sélectionner un compte s'affiche, cliquez sur Utiliser un autre compte.
-
Si nécessaire, copiez le nom d'utilisateur ci-dessous et collez-le dans la boîte de dialogue Se connecter.
{{{user_0.username | "Username"}}}
Vous trouverez également le nom d'utilisateur dans le panneau "Détails concernant l'atelier".
-
Cliquez sur Suivant.
-
Copiez le mot de passe ci-dessous et collez-le dans la boîte de dialogue Bienvenue.
{{{user_0.password | "Password"}}}
Vous trouverez également le mot de passe dans le panneau "Détails concernant l'atelier".
-
Cliquez sur Suivant.
Important : Vous devez utiliser les identifiants fournis pour l'atelier. Ne saisissez pas ceux de votre compte Google Cloud.
Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.
-
Accédez aux pages suivantes :
- Acceptez les conditions d'utilisation.
- N'ajoutez pas d'options de récupération ni d'authentification à deux facteurs (ce compte est temporaire).
- Ne vous inscrivez pas à des essais sans frais.
Après quelques instants, la console Cloud s'ouvre dans cet onglet.
Remarque : Pour accéder aux produits et services Google Cloud, cliquez sur le menu de navigation ou saisissez le nom du service ou du produit dans le champ Recherche.
Activer Cloud Shell
Cloud Shell est une machine virtuelle qui contient de nombreux outils pour les développeurs. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud. Cloud Shell vous permet d'accéder via une ligne de commande à vos ressources Google Cloud.
-
Cliquez sur Activer Cloud Shell
en haut de la console Google Cloud.
-
Passez les fenêtres suivantes :
- Accédez à la fenêtre d'informations de Cloud Shell.
- Autorisez Cloud Shell à utiliser vos identifiants pour effectuer des appels d'API Google Cloud.
Une fois connecté, vous êtes en principe authentifié et le projet est défini sur votre ID_PROJET : . Le résultat contient une ligne qui déclare l'ID_PROJET pour cette session :
Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}
gcloud est l'outil de ligne de commande pour Google Cloud. Il est préinstallé sur Cloud Shell et permet la complétion par tabulation.
- (Facultatif) Vous pouvez lister les noms des comptes actifs à l'aide de cette commande :
gcloud auth list
- Cliquez sur Autoriser.
Résultat :
ACTIVE: *
ACCOUNT: {{{user_0.username | "ACCOUNT"}}}
To set the active account, run:
$ gcloud config set account `ACCOUNT`
- (Facultatif) Vous pouvez lister les ID de projet à l'aide de cette commande :
gcloud config list project
Résultat :
[core]
project = {{{project_0.project_id | "PROJECT_ID"}}}
Remarque : Pour consulter la documentation complète sur gcloud, dans Google Cloud, accédez au guide de présentation de la gcloud CLI.
Tâche 1 : Créer un cluster et une instance
-
Commencez par créer un cluster AlloyDB. Dans le menu de navigation de la console Cloud (
), cliquez sur Afficher tous les produits, faites défiler la page jusqu'à la section Bases de données, puis sélectionnez AlloyDB pour PostgreSQL.
-
Cliquez sur Créer un cluster en haut de la page.
-
Dans la section Configurer le cluster, renseignez les champs suivants. Veillez à sélectionner la valeur Région indiquée ci-dessous. Conservez les valeurs par défaut pour les autres champs.
| Élément |
Valeur |
| ID du cluster |
lab-cluster |
| Mot de passe |
Change3Me |
| Région |
|
| Réseau |
peering-network |
-
L'option de connexion d'accès aux services privés a été configurée pour ce projet lorsque vous avez démarré l'atelier. Cette étape est nécessaire pour autoriser l'accès au cluster AlloyDB.
-
Sous Configurer votre instance principale, définissez l'ID de l'instance sur lab-instance.
-
Dans la section "Disponibilité zonale", sélectionnez Zones multiples (disponibilité élevée).
-
Sélectionnez 2 vCPU, 16 Go comme type de machine.
-
Faites défiler la page jusqu'en bas, puis cliquez sur Créer un cluster.
Remarque : La création du cluster prend environ 9 à 13 minutes.
-
Vous accédez alors à la page Présentation du cluster que vous venez de créer. La section inférieure contient les détails de votre instance. Cliquez sur Afficher la configuration de la connectivité dans la section "lab-instance". Notez l'adresse IP privée dans la section "Instances". Copiez l'adresse IP privée dans un fichier texte. Vous pourrez ainsi coller la valeur à une étape ultérieure. N'incluez pas le numéro de port.
-
Cliquez sur Vérifier ma progression pour valider l'objectif.
Créer un cluster et une instance
Tâche 2 : Créer des tables et insérer des données dans votre base de données
-
Une VM nommée alloydb-client, contenant le client PostgreSQL, a été provisionnée pour vous au début de l'atelier.
-
Dans le menu de navigation (
), sous Compute Engine, cliquez sur Instances de VM.
-
Pour l'instance nommée alloydb-client, dans la colonne Connecter, cliquez sur SSH pour ouvrir une fenêtre de terminal.
-
Définissez la variable d'environnement suivante en remplaçant ALLOYDB_ADDRESS par l'adresse IP privée de l'instance AlloyDB.
export ALLOYDB=ALLOYDB_ADDRESS
- Exécutez la commande suivante pour stocker l'adresse IP privée de l'instance AlloyDB sur la VM cliente AlloyDB afin qu'elle soit conservée tout au long de l'atelier.
echo $ALLOYDB > alloydbip.txt
- Utilisez la commande suivante pour lancer le client PostgreSQL (psql). Vous serez invité à fournir le mot de passe de l'utilisateur postgres (Change3Me) que vous avez saisi lors de la création du cluster.
psql -h $ALLOYDB -U postgres
- L'invite de terminal psql s'affiche, comme illustré ci-dessous.
psql (14.5 (Debian 14.5-1.pgdg110+1), server 14.4)
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
Type "help" for help.
postgres=>
- Saisissez et exécutez la commande SQL suivante pour créer une table nommée regions.
CREATE TABLE regions (
region_id bigint NOT NULL,
region_name varchar(25)
) ;
ALTER TABLE regions ADD PRIMARY KEY (region_id);
- Ensuite, ajoutez plusieurs lignes de données à la table regions. Saisissez et exécutez la commande SQL suivante.
INSERT INTO regions VALUES ( 1, 'Europe' );
INSERT INTO regions VALUES ( 2, 'Americas' );
INSERT INTO regions VALUES ( 3, 'Asia' );
INSERT INTO regions VALUES ( 4, 'Middle East and Africa' );
- Exécutez la requête simple suivante pour vérifier que vous avez inséré les enregistrements.
SELECT region_id, region_name from regions;
-
Saisissez \q pour quitter le client psql.
-
Vous pouvez également créer des tables et/ou charger des données à l'aide d'un fichier SQL (.sql). Un fichier SQL peut contenir des instructions LDD, LMD ou toute syntaxe SQL compatible. Vous allez télécharger et exécuter un fichier contenant des instructions LDD et LMD, puis vérifier le chargement.
-
Exécutez la commande suivante afin de télécharger un fichier contenant des instructions LDD et LMD pour trois tables : countries, departments et jobs.
gsutil cp gs://spls/gsp1083/hrm_load.sql hrm_load.sql
- Reconnectez-vous au client PostgreSQL (psql). Vous serez invité à fournir le mot de passe de l'utilisateur postgres (Change3Me).
psql -h $ALLOYDB -U postgres
- Exécutez la commande suivante pour traiter le fichier SQL.
\i hrm_load.sql
- Exécutez la commande suivante pour afficher les tables chargées dans votre base de données.
\dt
List of relations
Schema | Name | Type | Owner
--------+-------------+-------+----------
public | countries | table | postgres
public | departments | table | postgres
public | jobs | table | postgres
public | regions | table | postgres
(4 rows)
- Exécutez une requête de vérification ponctuelle pour examiner les données dans l'une des tables que vous venez de créer et de charger.
select job_title, max_salary
from jobs
order by max_salary desc;
-
Saisissez \q pour quitter le client psql.
-
Saisissez exit pour fermer la fenêtre de terminal.
-
Cliquez sur Vérifier ma progression pour valider l'objectif.
Créer et charger une table
Tâche 3 : Utiliser Google Cloud CLI avec AlloyDB
La console Cloud est très utile, mais dans certains cas d'utilisation, vous devrez gérer les bases de données AlloyDB à l'aide d'autres méthodes. Les services Google Cloud peuvent également être gérés à l'aide de l'outil de ligne de commande gcloud. Le moyen le plus simple d'utiliser la CLI gcloud est de passer par Cloud Shell, mais elle peut aussi être installée sur un large éventail de systèmes d'exploitation.
Créer un cluster et une instance avec la CLI
-
Créer une instance de cluster AlloyDB avec gcloud est très simple. Cliquez sur Activer Cloud Shell
en haut de la console Google Cloud.
-
Dans Cloud Shell, créez un cluster AlloyDB à l'aide de la commande ci-dessous.
gcloud alloydb clusters create gcloud-lab-cluster \
--password=Change3Me \
--network=peering-network \
--region={{{primary_project.default_region|Default Region}}} \
--project={{{primary_project.project_id|Project ID}}}
- Une fois le cluster créé, exécutez la commande suivante pour créer l'instance principale.
Remarque : La création de l'instance prend entre sept et neuf minutes.
gcloud alloydb instances create gcloud-lab-instance\
--instance-type=PRIMARY \
--cpu-count=2 \
--region={{{primary_project.default_region|Default Region}}} \
--cluster=gcloud-lab-cluster \
--project={{{primary_project.project_id|Project ID}}}
- Une fois l'instance créée, vous pouvez exécuter la commande suivante pour afficher la liste des instances de clusters AlloyDB disponibles dans votre projet. L'instance lab-cluster que vous avez créée précédemment et celle que vous venez de créer, gcloud-lab-cluster, sont renvoyées dans la liste.
gcloud alloydb clusters list
- Cliquez sur Vérifier ma progression pour valider l'objectif.
Créer un cluster et une instance avec la CLI
Tâche 4 : Supprimer un cluster
- La CLI permet de supprimer un cluster très rapidement. Exécutez la commande ci-dessous. L'option force supprime également toutes les instances subordonnées. Vous pouvez aussi supprimer un cluster à l'aide de la console Cloud.
Remarque : La suppression d'un cluster prend entre cinq et huit minutes.
gcloud alloydb clusters delete gcloud-lab-cluster \
--force \
--region={{{primary_project.default_region|Default Region}}} \
--project={{{primary_project.project_id|Project ID}}}
- Pour vérifier que le cluster gcloud-lab-cluster a bien été supprimé, exécutez la commande suivante :
Si l'invite Do you want to continue (Y/n)? (Voulez-vous continuer (OUI/non) ?) s'affiche, appuyez sur Y pour continuer.
gcloud alloydb clusters list
Félicitations !
Vous comprenez désormais les tâches essentielles à effectuer pour utiliser une base de données AlloyDB pour PostgreSQL.
Dernière mise à jour du manuel : 15 septembre 2025
Dernier test de l'atelier : 15 septembre 2025
Copyright 2026 Google LLC. Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.