Configurer et interroger Spanner Graph à l'aide de la console Google Cloud

Preview — Spanner Graph

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Remarque : Cette fonctionnalité est disponible dans les éditions Enterprise et Enterprise Plus de Spanner. Pour en savoir plus, consultez la présentation des éditions Spanner.

Ce document vous explique comment configurer et interroger Spanner Graph à l'aide de la console Google Cloud. Dans ce document, vous allez:

• Créer une instance Spanner
• Créer une base de données
• Créer un schéma de graphique
• Insérez les données du graphique.
• Interrogez le graphique que vous avez créé.

Pour en savoir plus sur les tarifs de Spanner, consultez la page Tarifs de Spanner.

Pour essayer un atelier de programmation, consultez Premiers pas avec Spanner Graph.

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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. L'API Spanner doit être activée automatiquement. Si ce n'est pas le cas, activez-la manuellement :
   Activer l'API Spanner

4. Pour obtenir les autorisations dont vous avez besoin pour créer des instances et des bases de données, demandez à votre administrateur de vous accorder le Rôle IAM Administrateur Cloud Spanner (roles/spanner.admin) sur votre projet.

Créer une instance

Remarque : Pour découvrir Spanner à l'aide d'une instance d'essai gratuit de 90 jours, consultez Créer une instance d'essai gratuit Spanner.

Lorsque vous utilisez 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 Spanner.

1. Dans la console Google Cloud, accédez à la page Spanner.

   Accéder à Spanner

2. Sélectionnez ou créez un projet Google Cloud si vous ne l'avez pas déjà fait.

3. Effectuez l'une des opérations suivantes :

   1. Si vous n'avez jamais créé d'instance Spanner, sur la page Bienvenue dans Spanner, cliquez sur Créer une instance provisionnée.

   2. Si vous avez créé une instance Spanner, sur la page Instances, cliquez sur Créer une instance.

4. Sur la page Sélectionner une édition, choisissez Enterprise Plus ou Grandes entreprises :

   Spanner Graph n'est disponible que dans l'édition Enterprise ou Édition Enterprise Plus. Pour comparer les différentes éditions, cliquez sur Comparer les éditions Pour en savoir plus, consultez la présentation des éditions Spanner.

5. Cliquez sur Continuer.

6. Dans Nom de l'instance, saisissez un nom d'instance. Par exemple, test-instance

7. Dans ID d'instance, conservez ou modifiez l'ID d'instance. Par défaut, votre ID d'instance par le nom de votre instance, mais vous pouvez le modifier. Le nom de votre instance et les ID d'instance peuvent être identiques ou différents.

8. Cliquez sur Continuer.

9. Dans Sélectionner une configuration, procédez comme suit:

   1. Laissez l'option Régional sélectionnée.

   2. Dans Sélectionner une configuration, sélectionnez une région. La région que vous sélectionnez est l'emplacement où vos instances sont stockées et dupliquées.

   3. Cliquez sur Continuer.

10. Dans Configurer la capacité de calcul, procédez comme suit:

    1. Dans Sélectionner une unité, choisissez Unités de traitement (PU).

    2. Dans Choisir un mode de scaling, laissez Allocation manuelle sélectionné et dans Quantité, conservez 1 000 unités de traitement.

11. Cliquez sur Créer. La console Google Cloud affiche la page Présentation de la que vous avez créée.

Créer une base de données

1. Dans la console Google Cloud, accédez à la page Spanner Instances.

   Accéder à la page Instances Spanner

2. Cliquez sur l'instance que vous avez créée, par exemple Test Instance.

3. Dans Vue d'ensemble, sous le nom de votre instance, cliquez sur Créer une base de données.

4. Dans Nom de la base de données, saisissez un nom de base de données. Exemple :example-db

5. Dans Sélectionner le dialecte de base de données, choisissez "SQL standard Google". Spanner Graph n'est pas disponible dans le dialecte PostgreSQL. Voici à quoi ressemble la page de création de votre base de données :

   

6. Cliquez sur Créer. La console Google Cloud affiche la page Vue d'ensemble de la base de données que vous avez créée.

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

1. Dans le menu de navigation, cliquez sur Spanner Studio.

2. Sur la page Spanner Studio, cliquez sur l'onglet Éditeur 1 ou sur Nouvel onglet ou utilisez-en un nouvel onglet.

3. Copiez et collez le schéma suivant dans l'onglet de l'éditeur. Le schéma contient deux définitions de table de nœuds, Person et Account, et deux arêtes les définitions de table, PersonOwnAccount et AccountTransferAccount. Spanner Graph utilise des tables relationnelles pour définir des graphiques. Vous voyez donc à la fois des tables relationnelles et des instructions de graphique dans le schéma. Pour en savoir plus sur le schéma de graphique Spanner, consultez la présentation du schéma de graphique Spanner.

   CREATE TABLE Person (
     id               INT64 NOT NULL,
     name             STRING(MAX),
     birthday         TIMESTAMP,
     country          STRING(MAX),
     city             STRING(MAX),
   ) PRIMARY KEY (id);
   
   CREATE TABLE Account (
     id               INT64 NOT NULL,
     create_time      TIMESTAMP,
     is_blocked       BOOL,
     nick_name        STRING(MAX),
   ) PRIMARY KEY (id);
   
   CREATE TABLE PersonOwnAccount (
     id               INT64 NOT NULL,
     account_id       INT64 NOT NULL,
     create_time      TIMESTAMP,
     FOREIGN KEY (account_id) REFERENCES Account (id)
   ) PRIMARY KEY (id, account_id),
     INTERLEAVE IN PARENT Person ON DELETE CASCADE;
   
   CREATE TABLE AccountTransferAccount (
     id               INT64 NOT NULL,
     to_id            INT64 NOT NULL,
     amount           FLOAT64,
     create_time      TIMESTAMP NOT NULL,
     order_number     STRING(MAX),
     FOREIGN KEY (to_id) REFERENCES Account (id)
   ) PRIMARY KEY (id, to_id, create_time),
     INTERLEAVE IN PARENT Account ON DELETE CASCADE;
   
   CREATE OR REPLACE PROPERTY GRAPH FinGraph
     NODE TABLES (Account, Person)
     EDGE TABLES (
       PersonOwnAccount
         SOURCE KEY (id) REFERENCES Person (id)
         DESTINATION KEY (account_id) REFERENCES Account (id)
         LABEL Owns,
       AccountTransferAccount
         SOURCE KEY (id) REFERENCES Account (id)
         DESTINATION KEY (to_id) REFERENCES Account (id)
         LABEL Transfers
     );
   

4. Cliquez sur Exécuter. La page Résultats indique que des mises à jour de schéma sont en cours. Une fois la mise à jour terminée, un message s'affiche dans Résultats pour indiquer que la mise à jour terminé.

Insérer des données de graphique

La console Google Cloud fournit une interface qui permet d'insérer, la modification et la suppression de données.

Insérer des données

1. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur.

2. Copiez et collez les instructions d'insertion de données de graphique suivantes dans les nœuds et les arêtes.

   INSERT INTO Account
     (id, create_time, is_blocked, nick_name)
   VALUES
     (7,"2020-01-10 06:22:20.222",false,"Vacation Fund"),
     (16,"2020-01-27 17:55:09.206",true,"Vacation Fund"),
     (20,"2020-02-18 05:44:20.655",false,"Rainy Day Fund");
   
   INSERT INTO Person
     (id, name, birthday, country, city)
   VALUES
     (1,"Alex","1991-12-21 00:00:00","Australia","Adelaide"),
     (2,"Dana","1980-10-31 00:00:00","Czech_Republic","Moravia"),
     (3,"Lee","1986-12-07 00:00:00","India","Kollam");
   
   INSERT INTO AccountTransferAccount
     (id, to_id, amount, create_time, order_number)
   VALUES
     (7,16,300,"2020-08-29 15:28:58.647","304330008004315"),
     (7,16,100,"2020-10-04 16:55:05.342","304120005529714"),
     (16,20,300,"2020-09-25 02:36:14.926","103650009791820"),
     (20,7,500,"2020-10-04 16:55:05.342","304120005529714"),
     (20,16,200,"2020-10-17 03:59:40.247","302290001255747");
   
   INSERT INTO PersonOwnAccount
     (id, account_id, create_time)
   VALUES
     (1,7,"2020-01-10 06:22:20.222"),
     (2,20,"2020-01-27 17:55:09.206"),
     (3,16,"2020-02-18 05:44:20.655");
   

   Le graphique suivant montre les utilisateurs, les comptes, le propriétaire du compte et transferts de compte à partir des hors-texte:

   

3. Cliquez sur Exécuter. Une fois l'exécution terminée, l'onglet Results (Résultats) indique que 3 lignes ont été insérées.

Exécuter une requête de graphique

1. Sur la page Présentation de la base de données, cliquez sur Spanner Studio dans la le menu de navigation.

2. Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet de l'éditeur.

3. Saisissez la requête suivante dans l'éditeur de requête. La requête trouve tout le monde vers lequel Dana a transféré de l'argent, et le montant de ces transferts.

   GRAPH FinGraph
   MATCH
     (from_person:Person {name: "Dana"})-[:Owns]->
     (from_account:Account)-[transfer:Transfers]->
     (to_account:Account)<-[:Owns]-(to_person:Person)
   RETURN
     from_person.name AS from_account_owner,
     from_account.id AS from_account_id,
     to_person.name AS to_account_owner,
     to_account.id AS to_account_id,
     transfer.amount AS amount
   

4. Cliquez sur Exécuter.

   L'onglet Résultats affiche les chemins suivants de Dana à Account {id:20} :

   • À Account {id:7} appartenant à Alex.

   • À Account {id:16} appartenant à Lee.

     

Effectuer un nettoyage

De nombreux exemples de la section Étape suivante utilisent les ressources que vous avez configurées dans ce document. Si vous souhaitez continuer à travailler avec Spanner Graph utilisant l'un de ces exemples, n'effectuez pas ces nettoyages étapes.

Sinon, pour éviter que des frais supplémentaires ne soient facturés sur votre compte de facturation Cloud, supprimez la base de données et l'instance que vous avez créées lors de la configuration. La suppression d'une instance entraîne automatiquement la suppression de toutes les bases de données créées dans celle-ci.

Supprimer la base de données

1. Dans la console Google Cloud, accédez à la page Instances Spanner.

   Accéder à la page Instances Spanner

2. Cliquez sur le nom de l'instance contenant la base de données à laquelle vous souhaitez delete, par exemple : Test Instance.

3. Cliquez sur le nom de la base de données que vous souhaitez supprimer, par exemple, example-db :

4. Sur la page Détails de la base de données, cliquez sur Supprimer la base de données.

5. Confirmez que vous souhaitez supprimer la base de données en la saisissant et cliquez sur Supprimer.

Supprimer l'instance

Avertissement : La suppression définitive d'une instance implique la suppression de toutes ses bases de données. Cette action est irréversible. Vous ne pouvez pas non plus en créer instance en essai sans frais une fois que vous avez supprimé votre première instance en essai sans frais. Vous pouvez créer une instance en essai sans frais par cycle de vie de projet.

1. Dans la console Google Cloud, accédez à la page Instances Spanner.

   Accéder aux instances Spanner

2. Cliquez sur le nom de l'instance que vous souhaitez supprimer, par exemple Instance de test.

3. Cliquez sur Supprimer l'instance.

4. Confirmez la suppression de l'instance en la saisissant et cliquez sur Supprimer.

Étape suivante

• Découvrez Spanner Graph grâce à un atelier de programmation.
• Apprenez-en plus sur le schéma du graphique Spanner.
• Créer, mettre à jour ou supprimer un schéma de graphique Spanner
• Insérez, mettez à jour ou supprimez des données de graphique Spanner.
• Présentation des requêtes Spanner Graph
• Migrer vers Spanner Graph