Démarrage rapide avec la console

Aperçu – Interface PostgreSQL

Cette fonctionnalité est couverte par les Conditions des offres avant disponibilité générale des conditions d'utilisation de Google Cloud. Les fonctionnalités avant disponibilité générale sont susceptibles de présenter une compatibilité limitée, et les modifications apportées à ces fonctionnalités peuvent ne pas être compatibles avec d'autres versions avant disponibilité générale. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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.

Remarque : Pour en savoir plus sur le coût d'utilisation de Cloud Spanner, consultez la page Tarifs.

Avant de commencer

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

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

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

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

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

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

1. Accédez à la page Instances de Cloud Spanner dans Cloud Console.

   Accéder à la page Instances

2. Cliquez sur Créer une instance.

3. Pour le nom de l'instance, saisissez Test Instance.

4. Pour l'ID d'instance, saisissez test-instance.

5. Choisissez la configuration Regional (Régionale).

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

   Remarque sur l'interface PostgreSQL : Actuellement, seul un sous-ensemble des régions Cloud Spanner permet de créer des bases de données PostgreSQL dans la version bêta de la fonctionnalité d'interface PostgreSQL. Consultez l'invitation à recevoir un aperçu pour plus de détails.

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

   

8. Cliquez sur Create (Créer).

   Votre instance apparaît dans la liste d'instances.

Créer une base de données

1. Accédez à la page Instances de Cloud Spanner dans Cloud Console.

   Accéder à la page Instances

2. Cliquez sur l'instance Test Instance.

3. Cliquez sur Créer une base de données.

4. Pour le nom de la base de données, saisissez example-db.

   Voici à quoi ressemble la page de création de votre instance :

   

5. Sélectionnez un dialecte de base de données.

   Pour plus d'informations sur la compatibilité de PostgreSQL et sur le choix d'un dialecte, consultez la page Interface PostgreSQL.

6. Si vous avez sélectionné l'option "Standard Google SQL", laissez le champ de texte Define your schema (Définir votre schéma) vide. Vous allez définir votre schéma dans la section suivante de ce guide de démarrage.

7. Cliquez sur Create (Créer).

   Cloud Console affiche la page Présentation de la base de données que vous avez créée.

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

1. Sur la page Présentation de example-db, cliquez sur Créer une table au début de la liste des tables.

   Cloud Console affiche la page Écrire des instructions LDD.

2. Saisissez :

   SQL standard Google

   CREATE TABLE Singers (
     SingerId   INT64 NOT NULL,
     FirstName  STRING(1024),
     LastName   STRING(1024),
     SingerInfo BYTES(MAX),
     BirthDate  DATE,
   ) PRIMARY KEY(SingerId);
   

   PostgreSQL

   CREATE TABLE Singers (
     SingerId   BIGINT PRIMARY KEY,
     FirstName  VARCHAR(1024),
     LastName   VARCHAR(1024),
     SingerInfo BYTEA,
     BirthDate  TIMESTAMPTZ
   );
   

3. Cliquez sur Envoyer.

   Cloud Console revient à la page Présentation de example-db et indique que des mises à jour du schéma sont en cours. Une fois la mise à jour terminée, la page se présente comme suit :

   SQL standard Google

   

   PostgreSQL

   

   Notez que PostgreSQL convertit le nom de la table en minuscules.

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 Présentation de example-db, cliquez sur la table Singers dans la liste des tables.

   Cloud Console affiche la page Schéma de la table "Singers".

2. Dans le menu latéral, cliquez sur Données pour afficher la page Données de la table "Singers".

3. Cliquez sur Insert.

   Cloud Console affiche la page Requête de la table "Singers" avec un nouvel onglet de requête contenant les instructions INSERT et SELECT du modèle que vous modifiez pour insérer une ligne dans la table Singers et afficher le résultat de cette insertion :

   SQL standard Google

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     Singers (SingerId,
       BirthDate,
       FirstName,
       LastName,
       SingerInfo)
   VALUES
     (<SingerId>, -- type: INT64
       <BirthDate>, -- type: DATE
       <FirstName>, -- type: STRING(1024)
       <LastName>, -- type: STRING(1024)
       <SingerInfo> -- type: BYTES(MAX)
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=<SingerId>;
   

   PostgreSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     singers (singerid,
       birthdate,
       firstname,
       lastname,
       singerinfo)
   VALUES
     (<singerid>, -- type: bigint
       <birthdate>, -- type: timestamp with time zone
       <firstname>, -- type: character varying
       <lastname>, -- type: character varying
       <singerinfo> -- type: bytea
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     singers
   WHERE
     singerid=<singerid>;
   

   Notez que PostgreSQL convertit les noms de colonnes en minuscules.

4. Modifiez la clause VALUES de l'instruction INSERT et la clause WHERE de l'instruction SELECT :

   SQL standard Google

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     Singers (SingerId,
       BirthDate,
       FirstName,
       LastName,
       SingerInfo)
   VALUES
     (1, -- type: INT64
       NULL, -- type: DATE
       'Marc', -- type: STRING(1024)
       'Richards', -- type: STRING(1024)
       NULL -- type: BYTES(MAX)
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=1;
   

   PostgreSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     singers (singerid,
       birthdate,
       firstname,
       lastname,
       singerinfo)
   VALUES
     (1, -- type: bigint
       NULL, -- type: timestamp with time zone
       'Marc', -- type: character varying
       'Richards', -- type: character varying
       NULL -- type: bytea
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     singers
   WHERE
     singerid=1;
   

5. Cliquez sur Run (Exécuter).

   Cloud Spanner exécute les instructions. Lorsque vous avez terminé, l'onglet Résultats indique que la première instruction a inséré une ligne et fournit un lien pour afficher les données de la table.

6. Dans l'onglet Résultats, cliquez sur le lien table. La table Singers contient maintenant une ligne :

   SQL standard Google

   

   PostgreSQL

   

7. Cliquez sur Insérer pour ajouter une ligne.

   Cloud Console affiche à nouveau la page Requête de la table "Singers". Elle comporte un nouvel onglet de requête contenant les mêmes instructions INSERT et SELECT.

8. Modifiez la clause VALUES de l'instruction INSERT et la clause WHERE de l'instruction SELECT :

   SQL standard Google

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     Singers (SingerId,
       BirthDate,
       FirstName,
       LastName,
       SingerInfo)
   VALUES
     (2, -- type: INT64
       NULL, -- type: DATE
       'Catalina', -- type: STRING(1024)
       'Smith', -- type: STRING(1024)
       NULL -- type: BYTES(MAX)
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=2;
   

   PostgreSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     singers (singerid,
       birthdate,
       firstname,
       lastname,
       singerinfo)
   VALUES
     (2, -- type: bigint
       NULL, -- type: timestamp with time zone
       'Catalina', -- type: character varying
       'Smith', -- type: character varying
       NULL -- type: bytea
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     singers
   WHERE
     singerid=2;
   

9. Cliquez sur Run (Exécuter).

   Une fois que Cloud Spanner a exécuté les instructions, l'onglet Résultats indique que la première instruction a inséré une ligne.

10. Cliquez sur le lien de table. La table Singers contient maintenant deux lignes :

    SQL standard Google

    

    PostgreSQL

    

Vous pouvez également insérer des valeurs de chaîne vide lorsque vous saisissez des données.

1. Cliquez sur Insérer pour ajouter une ligne.

   Cloud Console affiche à nouveau la page Requête de la table "Singers". Elle comporte un nouvel onglet de requête contenant les mêmes instructions INSERT et SELECT.

2. Modifiez la clause VALUES de l'instruction INSERT du modèle et la clause WHERE de l'instruction SELECT :

   SQL standard Google

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     Singers (SingerId,
       BirthDate,
       FirstName,
       LastName,
       SingerInfo)
   VALUES
     (3, -- type: INT64
       NULL, -- type: DATE
       'Kena', -- type: STRING(1024)
       '', -- type: STRING(1024)
       NULL -- type: BYTES(MAX)
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=3;
   

   PostgreSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     singers (singerid,
       birthdate,
       firstname,
       lastname,
       singerinfo)
   VALUES
     (3, -- type: bigint
       NULL, -- type: timestamp with time zone
       'Kena', -- type: character varying
       '', -- type: character varying
       NULL -- type: bytea
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     singers
   WHERE
     singerid=3;
   

   Notez que la valeur fournie pour la colonne du nom de famille est une chaîne vide, '', et non une valeur NULL.

3. Cliquez sur Run (Exécuter).

   Une fois que Cloud Spanner a exécuté les instructions, l'onglet Résultats indique que la première instruction a inséré une ligne.

4. Cliquez sur le lien de table. La table Fiddler contient maintenant trois lignes, et celle dont la valeur de la clé primaire correspond à 3 comporte une colonne de nom qui correspond à une chaîne vide:

   SQL standard Google

   

   PostgreSQL

   

Modifier des données

1. Sur la page Données de la table "Singers", cochez la case à côté de la ligne correspondant à la valeur de la clé primaire de 3, puis cliquez sur Modifier.

   Cloud Console affiche la page Requête avec un nouvel onglet contenant les instructions UPDATE et SELECT de modèle que vous modifiez. Notez que les clauses WHERE des deux instructions indiquent que la ligne à mettre à jour est celle qui possède la valeur de clé primaire 3.

   SQL standard Google

     -- Change values in the SET clause to update the row where the WHERE condition is true.
   UPDATE
     Singers
   SET
     BirthDate='',
     FirstName='Kena',
     LastName='',
     SingerInfo=''
   WHERE
     SingerId=3;
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=3;
   

   PostgreSQL

     -- Change values in the SET clause to update the row where the WHERE condition is true.
   UPDATE
     singers
   SET
     birthdate='',
     firstname='Kena',
     lastname='',
     singerinfo=''
   WHERE
     singerid='3';
   SELECT
     *
   FROM
     singers
   WHERE
     singerid='3';
   

2. Modifiez la clause SET de l'instruction UPDATE pour ne mettre à jour que la date de naissance :

   SQL standard Google

     -- Change values in the SET clause to update the row where the WHERE condition is true.
   UPDATE
     Singers
   SET
     BirthDate='1961-04-01'
   WHERE
     SingerId=3;
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=3;
   

   PostgreSQL

     -- Change values in the SET clause to update the row where the WHERE condition is true.
   UPDATE
     singers
   SET
     birthdate='1961-04-01 00:00:00 -8:00'
   WHERE
     singerid='3';
   SELECT
     *
   FROM
     singers
   WHERE
     singerid='3';
   

3. Cliquez sur Run (Exécuter).

   Cloud Spanner exécute les instructions. Lorsque vous avez terminé, l'onglet Results (Résultats) indique que la première instruction a mis à jour une ligne et contient un lien permettant d'afficher les données de la table.

4. Dans l'onglet Résultats, cliquez sur le lien table.

   La ligne mise à jour comporte maintenant une valeur pour la date de naissance.

   SQL standard Google

   

   PostgreSQL

   

Supprimer des données

1. Sur la page Données de la table "Singers", cochez la case à côté de la ligne contenant 2 dans la première colonne, puis cliquez sur Supprimer.

2. Dans la boîte de dialogue qui s'affiche, cliquez sur Confirmer.

   La table Singers contient maintenant deux lignes :

   SQL standard Google

   

   PostgreSQL

   

Exécuter une requête

1. Sur la page de présentation de example-db, cliquez sur Requête dans le menu latéral pour afficher la page Requête de example-db.

2. Cliquez sur Nouvel onglet pour créer un onglet de requête. Saisissez ensuite cette requête :

   SQL standard Google

   SELECT * FROM Singers;
   

   PostgreSQL

   SELECT * FROM singers;
   

3. Cliquez sur Run (Exécuter).

   Cloud Spanner exécute la requête. Lorsque vous avez terminé, l'onglet Résultats affiche le résultat de votre requête :

   SQL standard Google

   

   PostgreSQL

   

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 des frais supplémentaires sur votre compte de facturation Cloud, supprimez la base de données et l'instance que vous avez créées.

Supprimer la base de données

1. Accédez à la page Instances de Cloud Spanner dans Google Cloud Console.

   Accéder à la page Instances

2. Cliquez sur Test Instance.

3. Cliquez sur example-db.

4. Sur la page Détails de la base de données, cliquez sur SUPPRIMER LE BASE DE DONNÉES ().

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

1. Accédez à la page Instances de Cloud Spanner dans Google Cloud Console.

   Accéder à la page Instances

2. Cliquez sur Test Instance.

3. Cliquez sur Supprimer l'instance ().

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