Créer une instance d'essai sans frais Spanner et un exemple d'application

Remarque : L'instance d'essai sans frais Spanner est compatible avec les fonctionnalités de l'édition Standard et de l'édition Enterprise, telles que les fonctions de distance vectorielle KNN, la recherche en texte intégral et Spanner Graph. Pour en savoir plus, consultez la présentation des éditions Spanner.

Ce guide de démarrage rapide explique comment utiliser une instance d'essai sans frais Spanner et fournit un exemple d'application. Pour en savoir plus, consultez la présentation des instances d'essai sans frais Spanner.

Se lancer avec une instance d'essai sans frais

L'essai sans frais de 90 jours de l'instance Spanner est disponible pour toute personne disposant d'un compte Google et ayant activé Cloud Billing sur son projet. Des frais ne vous seront facturés que si vous choisissez de mettre à niveau votre instance d'essai sans frais vers une instance payante.

Vous pouvez créer une instance d'essai sans frais à l'aide de la console Google Cloud ou de la Google Cloud CLI.

Remarque : Vous ne pouvez créer qu'une seule instance d'essai sans frais par cycle de vie de projet, et un maximum de cinq instances d'essai sans frais par compte de facturation Cloud.

Avant de commencer

Console Google Cloud

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

   Accéder à Spanner

2. Si ce n'est pas déjà fait, sélectionnez ou créez un projet Google Cloud .

3. Si Cloud Billing est déjà activé sur votre projet, passez à la section Créer une instance d'essai sans frais.

   Si Cloud Billing n'est pas activé sur votre projet, associez un compte de facturation Cloud existant ou créez-en un. Google utilise ces informations de paiement pour valider votre identité. Nous ne facturons pas votre instance Spanner, sauf si vous passez explicitement à un compte de facturation Cloud payant et que vous mettez à niveau votre instance d'essai sans frais Spanner vers une instance payante.

   a. Cliquez sur Accéder à la facturation.

   b. Cliquez ensuite sur Associer un compte de facturation.

   Remarque : Si vous êtes un nouveau client Google Cloud , vous pouvez également bénéficier de l'Google Cloud essai sans frais de 90 jours d'une valeur de 300 $, qui vous offre 300 $ de crédits Cloud Billing gratuits pour payer les ressources Google Cloud. L'instance d'essai sans frais Spanner s'ajoute aux crédits d'essai sans frais d'une valeur de 300 $ proposés par l'essai sans frais Google Cloud . Vous n'avez pas besoin d'utiliser de crédits Cloud Billing gratuits pour créer une instance d'essai sans frais.

   c. Suivez la procédure indiquée pour créer un compte de facturation, puis associez-le à votre projet.

   d. Une fois que vous avez activé Cloud Billing sur votre projet, accédez à la page Spanner.

   Accéder à Spanner

   e. Cliquez sur Créer une instance sans frais, puis passez à la section Créer une instance d'essai sans frais.

4. Facultatif : Si vous avez déjà créé une instance Spanner dans le projet, la page Instances Spanner suivante s'affiche.

   Cliquez sur Créer une instance sans frais.

gcloud

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Install the Google Cloud CLI.

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Pour initialiser la gcloud CLI, exécutez la commande suivante :

gcloud init

Create or select a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

Verify that billing is enabled for your Google Cloud project.

If you're using a local shell, then create local authentication credentials for your user account:

gcloud auth application-default login

You don't need to do this if you're using Cloud Shell.

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Install the Google Cloud CLI.

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Pour initialiser la gcloud CLI, exécutez la commande suivante :

gcloud init

Create or select a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

Verify that billing is enabled for your Google Cloud project.

If you're using a local shell, then create local authentication credentials for your user account:

gcloud auth application-default login

You don't need to do this if you're using Cloud Shell.

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Créer une instance d'essai sans frais

Console Google Cloud

La procédure suivante décrit comment créer une instance d'essai sans frais à l'aide de la consoleGoogle Cloud .

Sur la page Créer votre instance d'essai sans frais, procédez comme suit :

1. Saisissez le nom de l'instance à afficher dans la console Google Cloud . L'instance doit être unique dans votre projet Google Cloud .
2. Saisissez l'ID d'instance pour pouvoir identifier votre instance de manière permanente. L'ID d'instance doit également être unique au sein de votre projet Google Cloud . Vous ne pourrez pas modifier l'ID d'instance par la suite.

3. Sélectionnez un emplacement de configuration dans le menu déroulant Région.

   La configuration que vous choisissez pour votre instance détermine l'emplacement géographique dans lequel votre instance sera stockée et répliquée. Vous pouvez créer une instance d'essai sans frais dans l'une des configurations d'instance régionales de Spanner. Pour obtenir la liste complète de toutes les configurations d'instance disponibles, consultez Configurations régionales, birégionales et multirégionales.

4. Cliquez sur Créer une instance sans frais.

   Une fois votre instance d'essai sans frais créée, Spanner crée un exemple de base de données pour vous permettre d'explorer les fonctionnalités de Spanner et de vous familiariser avec elles. Pour en savoir plus, consultez Présentation des instances d'essai sans frais.

gcloud

Pour créer une instance d'essai sans frais, utilisez la commande gcloud spanner instances create.

gcloud spanner instances create INSTANCE_ID \
   --instance-type=free-instance --config=INSTANCE_CONFIG \
   --description=INSTANCE_DESCRIPTION

Remplacez les éléments suivants :

• INSTANCE_ID : identifiant permanent unique au sein de votre projet Google Cloud . Vous ne pourrez pas modifier l'ID d'instance par la suite.

• INSTANCE_CONFIG : identifiant permanent de la configuration de votre instance, qui définit l'emplacement géographique de l'instance. Vous pouvez créer une instance d'essai sans frais dans n'importe quelle configuration d'instance régionale Spanner :

• INSTANCE_DESCRIPTION : nom à afficher pour l'instance dans la consoleGoogle Cloud . Le nom de l'instance doit être unique au sein de votre projetGoogle Cloud .

Par exemple, pour créer une instance d'essai sans frais nommée trial-instance avec le nom à afficher Trial Instance à l'aide de la configuration d'instance régionale regional-us-east5, exécutez la commande suivante :

gcloud spanner instances create trial-instance --config=regional-us-east5 \
  --instance-type=free-instance --description="Trial Instance"

Remarque : Utilisez l'ID d'instance, et non le nom à afficher, lorsque vous faites référence à une instance dans les commandes gcloud CLI.

Une fois votre instance d'essai sans frais créée, vous êtes invité(e) à poursuivre l'apprentissage et l'exploration de Spanner en lançant un tutoriel par étapes qui vous explique comment créer une base de données à l'aide d'un exemple d'application. Pour en savoir plus, consultez Premiers pas avec un exemple d'application.

Premiers pas avec un exemple de base de données

Une fois que vous avez créé votre instance d'essai sans frais à l'aide de la console Google Cloud , Spanner crée un exemple de base de données pour vous permettre d'explorer les fonctionnalités de Spanner et de vous familiariser avec elles.

Vous pouvez accéder à l'exemple de base de données à l'aide de la console Google Cloud .

Console Google Cloud

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

   Accéder à la page Instances

2. Cliquez sur le nom de l'instance d'essai sans frais.

3. Cliquez sur le nom de l'exemple de base de données.

Vous pouvez afficher les tables et les données de l'exemple de base de données. Vous pouvez également accéder aux requêtes enregistrées et les afficher sur la page Spanner Studio. Les requêtes enregistrées présentent différentes fonctionnalités de Spanner.

Premiers pas avec un exemple d'application

Spanner propose également un exemple d'application Open Source pour vous aider à vous lancer avec l'instance d'essai sans frais Spanner. L'exemple d'application se compose d'un service de backend gRPC qui s'appuie sur une base de données Spanner et d'un générateur de charge de travail qui redirige le trafic vers le service.

Vous pouvez accéder à l'exemple d'application à l'aide de la Google Cloud CLI.

gcloud

1. Suivez les étapes décrites dans la section Configuration de gcloud, qui traite des sujets suivants : création et définition d'un projet Google Cloud par défaut, activation de l'API Cloud Spanner et configuration d'OAuth 2.0 pour obtenir les identifiants d'authentification permettant d'utiliser l'API Cloud Spanner.

   Exécutez la commande gcloud auth application-default login pour configurer votre environnement de développement local avec des identifiants d'authentification.

2. Exécutez la commande gcloud spanner samples run pour télécharger l'exemple d'application et démarrer le service de backend gRPC et le générateur de charge de travail pour l'exemple d'application donné :

   gcloud spanner samples run APPNAME --instance-id INSTANCE_ID
   

3. Pour en savoir plus et obtenir la liste des autres commandes disponibles pour l'exemple d'application, consultez la documentation de la gcloud CLI.

Importer vos propres données

Vous pouvez importer vos propres données dans une base de données Spanner à l'aide d'un fichier CSV, d'un fichier de dump MySQL ou d'un fichier de dump PostgreSQL. Vous pouvez importer un fichier local à l'aide de Cloud Storage ou directement à partir d'un bucket Cloud Storage. L'importation d'un fichier local à l'aide de Cloud Storage peut entraîner des frais.

Si vous choisissez d'utiliser un fichier CSV, vous devez également importer un fichier JSON distinct contenant le schéma de la base de données.

Console Google Cloud

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

   Accéder aux instances Spanner

2. Sélectionnez l'instance dans laquelle créer la base de données.

3. Cliquez sur Importer mes propres données.

4. Saisissez les valeurs suivantes :

   • Sélectionnez le type de fichier.

   • Importez le fichier depuis votre ordinateur ou sélectionnez un chemin de bucket Cloud Storage vers le fichier.

   • (Facultatif) Si vous choisissez d'utiliser un fichier CSV, vous devez également importer un fichier JSON distinct contenant le schéma de la base de données. Le fichier JSON doit utiliser la structure suivante pour définir le schéma :

     {
       "name": "COLUMN_NAME",
       "type": "TYPE",
       "notNull": NOT_NULL_VALUE,
       "primaryKeyOrder": PRIMARY_KEY_ORDER
     }

     Remplacez les éléments suivants :

     • COLUMN_NAME : nom de la colonne dans la table

     • TYPE : type de données de la colonne

     • (Facultatif) NOT_NULL_VALUE : indique si la colonne peut stocker des valeurs nulles ou non. Les entrées valides sont true ou false. La valeur par défaut est false.

     • (Facultatif) PRIMARY_KEY_ORDER : détermine l'ordre des clés primaires. Définissez la valeur sur 0 pour une colonne de clé non primaire. Définissez la valeur sur un entier, par exemple 1, pour une colonne de clé primaire. Les colonnes dont le numéro est plus petit apparaissent plus tôt dans une clé primaire composée.

     Par défaut, le fichier CSV utilise une virgule comme délimiteur de champ et une nouvelle ligne comme délimiteur de ligne. Pour en savoir plus sur l'utilisation de délimiteurs personnalisés, consultez la documentation de référence de gcloud alpha spanner databases import.

   • Sélectionnez une base de données existante ou nouvelle comme destination.

5. Cliquez sur Importer.

6. Spanner ouvre Cloud Shell et renseigne une commande qui installe l'outil de migration Spanner, puis exécute la commande gcloud alpha spanner databases import. Appuyez sur la touche ENTER pour importer des données dans votre base de données.x

Mettre à niveau une instance d'essai sans frais

La procédure suivante décrit comment mettre à niveau une instance d'essai sans frais.

Console Google Cloud

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

   Accéder à la page Instances

2. Cliquez sur le nom de l'instance d'essai sans frais.

3. Sur la page Présentation de l'instance, cliquez sur Modifier l'instance ou Modifier pour effectuer la mise à niveau.

4. Dans le champ Modifier le nom de l'instance, saisissez un nom plus approprié pour votre instance payante, le cas échéant.

5. Sélectionnez l'option de mise à niveau. Vous pouvez sélectionner l'une des options suivantes :

   • Mettre à niveau
   • Mise à niveau automatique vers la version complète de l'édition Enterprise une fois l'essai terminé
   • Me le rappeler plus tard

   La section Résumé fournit une description des coûts de calcul et de stockage pour l'instance payante mise à niveau que vous avez sélectionnée.

6. Cliquez sur Enregistrer pour mettre à niveau votre instance d'essai sans frais.

gcloud

Pour mettre à niveau votre instance d'essai sans frais vers une instance d'édition Enterprise payante avec la même configuration d'instance, exécutez la commande gcloud spanner instances update suivante :

gcloud spanner instances update INSTANCE_ID --instance-type=provisioned

Supprimer l'instance

Avertissement : La suppression définitive d'une instance implique la suppression de toutes ses bases de données. Cette opération est irréversible. De plus, vous ne pouvez pas créer une autre instance d'essai sans frais après avoir supprimé votre première instance d'essai sans frais. Vous pouvez créer une seule instance d'essai sans frais par cycle de vie de projet.

Console Google Cloud

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

   Accéder à la page Instances

2. Cliquez sur le nom de l'instance que vous souhaitez supprimer.

3. Sur la page Présentation de l'instance, cliquez sur Supprimer l'instance.

4. Suivez les instructions pour confirmer que vous souhaitez bien supprimer l'instance.

5. Cliquez sur Supprimer.

gcloud

Pour supprimer votre instance d'essai sans frais, exécutez la commande gcloud spanner instances delete suivante :

gcloud spanner instances delete INSTANCE_ID

Étapes suivantes

• Apprenez-en davantage sur les instances d'essai sans frais Spanner.
• Découvrez-en davantage sur les instances et les bases de données Spanner.
• Pour en savoir plus sur les tarifs de Spanner après la période d'essai sans frais, consultez la page des tarifs.