GSP1048

Présentation

Cloud Spanner est le service de base de données relationnelle entièrement géré et à évolutivité horizontale de Google. Les clients des secteurs des services financiers, des jeux vidéo, du commerce et de bien d'autres domaines d'activité font confiance à Cloud Spanner pour exécuter leurs charges de travail les plus exigeantes, où la cohérence et la disponibilité à grande échelle sont primordiales.

Dans cet atelier, vous allez effectuer des tâches d'administration de base dans une instance Cloud Spanner.

Objectifs de l'atelier

Dans cet atelier, vous allez apprendre à effectuer les tâches suivantes :

• Créer une instance
• Créer une base de données
• Créer des tables
• Insérer et modifier des données
• Utiliser la Google Cloud CLI avec Cloud Spanner
• Utiliser des outils d'automatisation avec Cloud Spanner
• 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

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

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

3. 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".

4. Cliquez sur Suivant.

5. 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".

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

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

1. Cliquez sur Activer Cloud Shell  en haut de la console Google Cloud.

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

3. (Facultatif) Vous pouvez lister les noms des comptes actifs à l'aide de cette commande :

gcloud auth list

4. Cliquez sur Autoriser.

Résultat :

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (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 une instance

1. Pour utiliser Cloud Spanner, vous devez d'abord créer une instance. Une instance est une allocation de ressources de calcul et de stockage Google Cloud. Dans la console, ouvrez le menu de navigation () > Afficher tous les produits. Dans la section Bases de données, cliquez sur Spanner.

2. Acceptez toute fenêtre d'accusé de réception ou d'information qui pourrait s'afficher.

3. Cliquez ensuite sur Créer une instance provisionnée.

4. Renseignez les champs suivants et conservez les valeurs par défaut dans les autres champs :

Élément	Valeur
Sélectionner une édition	Enterprise
Nom de l'instance	banking-instance
Sélectionner une configuration
Configurer la capacité de calcul	Unité : nœuds // Quantité : 1

5. Cliquez sur Créer. Votre instance s'affiche maintenant sur la page "Détails de l'instance". Vous y trouverez un aperçu des performances de l'instance, de son utilisation, etc. L'étape suivante consiste à créer une base de données.

Tâche 2 : Créer une base de données

1. Sur la page "Détails de l'instance", cliquez sur Créer une base de données.

2. Pour le nom de la base de données, saisissez banking-db.

3. Ignorez l'étape Définir votre schéma (facultatif) pour le moment. Vous découvrirez comment définir votre schéma dans la prochaine section.

4. Cliquez sur Créer.

5. Vous accédez alors à la page Présentation de la base de données que vous venez de créer. Vous constatez que cette page ressemble à celle de l'instance, mais que les statistiques concernent la base de données spécifique. Notez également les nouvelles options du menu de gauche.

6. Cliquez sur Vérifier ma progression pour valider l'objectif.

Créer une instance et une base de données

Tâche 3 : Créer une table dans votre base de données

1. Sur la page "Détails de la base de données" de votre base de données banking-db, faites défiler la page vers le bas et cliquez sur Créer une table.

2. Cliquez sur l'icône représentant un + bleu pour ouvrir la page Requête, puis saisissez :

CREATE TABLE Customer ( CustomerId STRING(36) NOT NULL, Name STRING(MAX) NOT NULL, Location STRING(MAX) NOT NULL, ) PRIMARY KEY (CustomerId);

3. Cliquez sur Exécuter.

4. Une fois l'opération terminée, cliquez sur Présentation sous Base de données dans le menu de gauche. Faites défiler la page jusqu'à Tables, puis cliquez sur Customer pour afficher les détails du schéma :

5. Cliquez sur Vérifier ma progression pour valider l'objectif.

Créer un schéma pour votre base de données

Tâche 4 : Insérer et modifier des données

Cloud Console fournit une interface permettant d'insérer, de modifier et de supprimer des données.

Insérer des données

1. Sur la page Schéma, cliquez sur Données dans le menu de gauche. Cliquez ensuite sur Insérer.

2. Vous êtes automatiquement redirigé vers l'onglet Requête de Spanner Studio. Cliquez sur Effacer la requête, collez la requête ci-dessous, puis cliquez sur Exécuter :

INSERT INTO Customer (CustomerId, Name, Location) VALUES ('bdaaaa97-1b4b-4e58-b4ad-84030de92235', 'Richard Nelson', 'Ada Ohio' );

3. La partie inférieure de l'écran affiche le résultat. La table Customer contient maintenant une ligne :

4. Ajoutez une deuxième ligne. Remplacez l'instruction précédente par celle qui suit, puis cliquez sur Exécuter :

INSERT INTO Customer (CustomerId, Name, Location) VALUES ('b2b4002d-7813-4551-b83b-366ef95f9273', 'Shana Underwood', 'Ely Iowa' );

Exécuter une requête

1. Vous pouvez exécuter une instruction SQL sur la page de requête de votre base de données.

2. Dans le volet de gauche de la console Cloud Platform, cliquez sur Spanner Studio pour accéder à la fenêtre de l'UI de requête.

3. Cliquez sur l'icône représentant un + bleu pour ouvrir la page Requête. Cliquez sur Effacer la requête, collez la requête ci-dessous, puis cliquez sur "Exécuter" :

SELECT * FROM Customer;

4. Cliquez sur Exécuter.

5. Les résultats de votre requête s'affichent dans la console Cloud.

Tâche 5 : Utiliser la Google Cloud CLI avec Cloud Spanner

La console Cloud est très utile, mais dans certains cas d'utilisation, devrez gérer les instances Spanner à 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 une instance avec la CLI

1. Créer une instance Spanner avec gcloud est très simple. La commande de base est la suivante :

gcloud spanner instances create [INSTANCE-ID] \ --config=[INSTANCE-CONFIG] \ --description="[INSTANCE-NAME]" \ --nodes=[NODE-COUNT]

2. Dans Cloud Shell, créez une instance Cloud Spanner à l'aide de la commande ci-dessous.

gcloud spanner instances create banking-instance-2 \ --config=regional-{{{project_0.default_region}}} \ --description="Banking Instance 2" \ --nodes=2

Répertorier les instances

1. Vous pouvez exécuter la commande suivante pour répertorier les instances Spanner disponibles dans votre projet.

gcloud spanner instances list

Créer une base de données

1. Vous pouvez également créer des bases de données dans une instance Spanner à l'aide de gcloud.

2. Dans Cloud Shell, créez une base de données à l'aide de la commande ci-dessous.

gcloud spanner databases create banking-db-2 --instance=banking-instance-2

3. Cliquez sur Vérifier ma progression pour valider l'objectif.

Créer une instance et une base de données avec la CLI

Modifier le nombre de nœuds

N'oubliez pas qu'il est important de provisionner suffisamment de nœuds pour que l'utilisation du processeur et du stockage reste inférieure aux valeurs maximales recommandées. Cependant, il est parfois nécessaire de réduire le nombre de nœuds.

1. Vous allez maintenant réduire le nombre de nœuds de l'instance banking-instance-2 de deux à un.

2. Utilisez la commande gcloud suivante pour ajuster l'instance :

gcloud spanner instances update banking-instance-2 --nodes=1

3. Une fois l'opération terminée, vérifiez que le nombre de nœuds a été réduit :

gcloud spanner instances list

Tâche 6 : Utiliser des outils d'automatisation avec Cloud Spanner

À mesure que vos architectures Spanner se développent et deviennent plus complexes, vous souhaitez automatiser le déploiement et la gestion des instances Spanner. Terraform est l'un des outils disponibles pour déployer et gérer Spanner.

L'objectif de cet atelier n'est pas d'expliquer le fonctionnement de Terraform. Si vous ne connaissez pas Terraform, vous pouvez consulter la documentation.

En résumé, vous fournissez à Terraform un ensemble de fichiers qui décrivent l'infrastructure ou les services que vous souhaitez déployer dans Google Cloud. Cet ensemble de fichiers est appelé configuration. Ensuite, vous demandez à Terraform d'initialiser et de planifier le déploiement, avant d'appliquer les modifications.

Vérifier l'installation de Terraform

1. Terraform est préinstallé dans Cloud Shell. Dans la fenêtre Cloud Shell précédente (ouvrez-la à nouveau si vous l'avez fermée), vérifiez que Terraform est disponible :

terraform -version

2. Un résultat semblable aux lignes suivantes doit s'afficher :

Terraform v1.5.6 on linux_amd64 Remarque : Vous pouvez ignorer les avertissements signalant que la version de Terraform est obsolète.

Créer une configuration Terraform

1. Dans Cloud Shell, saisissez la commande suivante pour appeler l'éditeur de texte Nano et créer un fichier de configuration vide nommé spanner.tf.

nano spanner.tf

2. Dans l'éditeur Nano, collez le bloc de code ci-dessous.

resource "google_spanner_instance" "banking-instance-3" { name = "banking-instance-3" config = "regional-{{{project_0.default_region}}}" display_name = "Banking Instance 3" num_nodes = 2 labels = { } }

3. Appuyez sur Ctrl+X pour quitter Nano, sur Y pour confirmer la mise à jour, puis sur Entrée pour enregistrer vos modifications.

Déployer

1. L'étape suivante consiste à s'assurer que tous les fournisseurs de services Terraform sont disponibles (dans ce cas, le fournisseur de services Spanner). Pour cela, exécutez la commande suivante dans Cloud Shell :

terraform init

2. Ensuite, demandez à Terraform de créer un plan d'exécution basé sur le fichier de configuration que vous avez créé il y a quelques étapes. Exécutez la commande suivante :

terraform plan

3. Le résultat affiche des informations sur la nouvelle instance qui sera créée. Exécutez la commande suivante pour appliquer le plan à votre projet :

terraform apply

4. Le plan s'affiche à nouveau et Terraform s'interrompt pour obtenir votre approbation avant de continuer. Saisissez yes pour que Terraform crée la nouvelle instance.

5. La commande "apply" va traiter le fichier et renvoyer le résultat suivant :

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.

6. Vérifiez que la nouvelle instance, banking-instance-3, a bien été créée :

gcloud spanner instances list

Tâche 7 : Supprimer des instances

1. La CLI permet de supprimer une instance très rapidement. Exécutez la commande suivante :

gcloud spanner instances delete banking-instance-2

2. Pour vérifier que l'instance banking-instance-2 a été supprimée, exécutez la commande suivante :

gcloud spanner instances list

Félicitations !

Vous maîtrisez désormais plusieurs actions d'administration de base permettant d'utiliser une instance Cloud Spanner.

Formations et certifications Google Cloud

Les formations et certifications Google Cloud vous aident à tirer pleinement parti des technologies Google Cloud. Nos cours portent sur les compétences techniques et les bonnes pratiques à suivre pour être rapidement opérationnel et poursuivre votre apprentissage. Nous proposons des formations pour tous les niveaux, à la demande, en salle et à distance, pour nous adapter aux emplois du temps de chacun. Les certifications vous permettent de valider et de démontrer vos compétences et votre expérience en matière de technologies Google Cloud.

Dernière mise à jour du manuel : 24 février 2025

Dernier test de l'atelier : 24 février 2025

Copyright 2025 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.