Cette page a été traduite par l'API Cloud Translation.

Guide de démarrage rapide avec la console

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 Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

Accéder au sélecteur de projet

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.

Activer l'API Cloud Spanner

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.

Accéder à la page Instances
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.
Utilisez la capacité de calcul par défaut de 1 000 unités de traitement.

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.

Accéder à la page Instances
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 :
Ignorez l'étape Définir votre schéma 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 :

Champ	Valeur
SingerId:INT64	`1`
BirthDate:DATE	[laissez le champ vide]
FirstName:STRING	`Marc`
LastName:STRING	`Richards`
SingerInfo:BYTES	[laissez le champ vide]

Champ	Valeur
SingerId:INT64	`2`
BirthDate:DATE	[laissez le champ vide]
FirstName:STRING	`Catalina`
LastName:STRING	`Smith`
SingerInfo:BYTES	[laissez le champ vide]

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 (Artistes) contient désormais trois lignes, dont une, SingerId 3, comporte un LastName qui est une chaîne vide:

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]

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 (Artistes) contient maintenant une valeur BirthDate:

Champ	Valeur
BirthDate:DATE	`1961-04-01`
[tous les autres champs]	[ne modifiez aucune valeur]

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

Accéder à la page Instances
Cliquez sur Test Instance.
Cliquez sur example-db.
Sur la page Détails de la base de données, cliquez sur SUPPRIMER LA BASE DE DONNÉES.
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.

Accéder à la page Instances
Cliquez sur Test Instance.
Cliquez sur Supprimer l'instance ().
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.