Ce guide de démarrage rapide vous explique comment effectuer des opérations de base dans Cloud Spanner à l'aide de Google Cloud Console. Vous allez :
- créer une instance, une base de données et une table Cloud Spanner ;
- ajouter un schéma ;
- écrire et modifier des données ;
- exécuter une requête.
Avant de commencer
- Connectez-vous à votre compte Google.
Si vous n'en possédez pas déjà un, vous devez en créer un.
-
Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
-
Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.
-
Activez l'API Cloud Spanner pour le projet.
Créer une instance
Lorsque vous utilisez Cloud Spanner pour la première fois, vous devez créer une instance, c'est-à-dire un élément qui alloue les ressources utilisées par les bases de données Cloud Spanner dans cette instance.
Accédez à la page Instances de Cloud Spanner dans Cloud Console.
Cliquez sur Créer une instance.
Pour le nom de l'instance, saisissez Test Instance.
Pour l'ID d'instance, saisissez test-instance.
Choisissez la configuration Regional (Régionale).
Sélectionnez la configuration régionale de votre choix dans le menu déroulant.
La configuration que vous choisissez détermine l'emplacement géographique où vos instances seront stockées et dupliquées.
Dans "Nodes" (Nœuds), saisissez 1.
Voici à quoi ressemble la page de création de votre instance :
Cliquez sur Create (Créer).
Votre instance apparaît dans la liste d'instances.
Créer une base de données
Accédez à la page Instances de Cloud Spanner dans Cloud Console.
Cliquez sur l'instance Test Instance.
Cliquez sur Créer une base de données.
Pour le nom de la base de données, saisissez example-db.
Voici à quoi ressemble la page de création de votre instance :
Cliquez sur Continue (Continuer).
Ignorez l'étape Define your database schema (Définir le schéma de votre base de données) pour le moment. Vous allez définir votre schéma dans la section suivante de ce guide de démarrage.
Cliquez sur Créer.
Cloud Console affiche la page Détails de la base de données après la création de la base de données.
Créer un schéma pour votre base de données
Cloud Console propose deux options pour créer, modifier et supprimer des tableaux et des index dans une base de données :
- via l'éditeur de base de données par défaut pour spécifier chaque partie des tables, des colonnes et des index ;
- en faisant passer l'éditeur en mode Modifier sous forme de texte et en saisissant des instructions SQL dans la syntaxe du langage de définition de données (DDL) de Cloud Spanner.
Ce guide de démarrage utilise DDL.
- Dans le volet gauche de Cloud Console, cliquez sur la base de données example-db.
- Cliquez sur Créer une table.
- Cliquez sur le bouton Modifier sous forme de texte.
Dans le champ Instruction LDD saisissez ce qui suit :
CREATE TABLE Singers ( SingerId INT64 NOT NULL, FirstName STRING(1024), LastName STRING(1024), SingerInfo BYTES(MAX), BirthDate DATE, ) PRIMARY KEY(SingerId);
Cliquez sur Créer.
Ce processus peut prendre quelques minutes. Une fois l'opération terminée, Cloud Console affiche les détails de la table que vous avez créée :
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
- Dans le volet gauche de Cloud Console, cliquez sur Singers (Chanteurs).
- Cliquez sur Data (Données).
- Cliquez sur Insert (Insérer).
Saisissez les valeurs suivantes :
Champ Valeur SingerId:INT64 1
BirthDate:DATE [laissez le champ vide] FirstName:STRING Marc
LastName:STRING Richards
SingerInfo:BYTES [laissez le champ vide] Cliquez sur Enregistrer.
La table Singers (Chanteurs) contient maintenant une ligne :
Cliquez sur Insert (Insérer) pour ajouter une ligne.
Saisissez les valeurs suivantes :
Champ Valeur SingerId:INT64 2
BirthDate:DATE [laissez le champ vide] FirstName:STRING Catalina
LastName:STRING Smith
SingerInfo:BYTES [laissez le champ vide] Cliquez sur Enregistrer.
La table Singers (Chanteurs) contient maintenant deux lignes :
Vous pouvez également insérer des valeurs de chaîne vide lorsque vous saisissez des données.
- Dans le volet de gauche, cliquez sur Singers.
- Cliquez sur Data (Données).
- Cliquez sur Insert (Insérer).
Saisissez les valeurs suivantes :
Champ Valeur SingerId:INT64 3
BirthDate:DATE [laissez le champ vide] FirstName:STRING Kena
LastName:STRING [vérifiez Chaîne vide] SingerInfo:BYTES [laissez le champ vide] Cliquez sur Enregistrer.
La table Singers (Chanteurs) contient désormais trois lignes, dont une, SingerId
3
, comporte un champ LastName correspondant à une chaîne vide :
Modifier des données
- Dans le volet gauche de Cloud Console, cliquez sur Singers (Chanteurs).
- Cliquez sur Data (Données).
- Cochez la case correspondant à la ligne SingerId
3
, puis cliquez sur Edit (Modifier). Saisissez la valeur suivante :
Champ Valeur BirthDate:DATE 1961-04-01
[tous les autres champs] [ne modifiez aucune valeur] Cliquez sur Enregistrer.
La ligne SingerId
3
de la table Singers (Chanteurs) comporte maintenant une valeur pour le champ BirthDate :
Supprimer des données
- Dans le volet gauche de Cloud Console, cliquez sur Singers (Chanteurs).
- Cliquez sur Data (Données).
- Cochez la case correspondant à la ligne SingerId
2
, puis cliquez sur Delete (Supprimer). Dans la boîte de dialogue qui s'affiche, cliquez sur Confirmer.
La table Singers contient maintenant deux lignes :
Exécuter une requête
Vous pouvez maintenant exécuter une instruction SQL sur la page de requête.
- Dans le volet gauche de Cloud Console, cliquez sur example-db pour accéder à la page Détails de la base de données.
- Sur la page Détails de la base de données, cliquez sur Requête.
Saisissez la requête suivante :
SELECT * FROM Singers
Cliquez sur Run (Exécuter).
Les résultats de votre requête s'affichent dans Cloud Console :
Félicitations ! Vous avez bien créé une base de données Cloud Spanner et exécuté une instruction SQL à l'aide de l'éditeur de requête.
Nettoyage
Pour éviter que des frais supplémentaires ne soient facturés sur votre compte Cloud Billing, supprimez la base de données et l'instance que vous avez créées.
Supprimer la base de données
Accédez à la page Instances de Cloud Spanner dans Google Cloud Console.
Cliquez sur Test Instance.
Cliquez sur example-db.
Sur la page Détails de la base de données, cliquez sur SUPPRIMER LE BASE DE DONNÉES (delete).
Confirmez que vous souhaitez supprimer la base de données, puis cliquez sur Supprimer.
Supprimer l'instance
La suppression d'une instance entraîne automatiquement la suppression de toutes les bases de données créées dedans.
Accédez à la page Instances de Cloud Spanner dans Google Cloud Console.
Cliquez sur Test Instance.
Cliquez sur Supprimer l'instance (delete).
Confirmez que vous souhaitez supprimer l'instance, puis cliquez sur Supprimer.
Étape suivante
- Découvrez davantage d'informations sur les instances.
- Apprenez à mieux connaître le schéma et le modèle de données Cloud Spanner.
- Obtenez des précisions sur le langage de définition de données (DDL).
- Découvrez-en plus sur les plans d'exécution de requêtes.
- Découvrez comment utiliser Cloud Spanner avec C++, C#, Go, Java, Node.js, PHP, Python, Ruby, REST ou gcloud.