Configurer votre environnement

Cette page vous guide à travers les étapes de configuration requises pour utiliser l'API Cloud Spanner avec la Google Cloud CLI, les bibliothèques clientes et les pilotes Spanner.

Si vous souhaitez utiliser Spanner avec la console Google Cloud, consultez le guide de démarrage rapide avec la console.

Configurer un projet Google Cloud

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

    Accéder à la page Projets

  2. Créez un projet Google Cloud ou ouvrez un projet existant en cliquant sur son nom.
  3. Ouvrez une fenêtre de terminal et définissez votre projet comme projet par défaut pour la Google Cloud CLI. Pour ce faire, remplacez MY_PROJECT_ID par l'ID de votre projet (et non pas son nom) dans la commande suivante :

    gcloud config set project MY_PROJECT_ID
  4. Make sure that billing is enabled for your Google Cloud project.

  5. Vous pouvez également obtenir plus d'informations sur la tarification de Spanner.
  6. Activez l'API Cloud Spanner pour le projet.

    Activer l'API Cloud Spanner

    Remarque: Si vous utilisez un compte de service dans un autre projet pour accéder à votre instance Spanner, vous devez activer l'API Spanner dans les deux projets.

Configurer l'authentification

Select the tabs for how you plan to access the API:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

gcloud

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

Pour configurer la gcloud CLI afin qu'elle utilise l'emprunt d'identité d'un compte de service pour s'authentifier auprès des Google APIs plutôt que d'utiliser vos identifiants utilisateur, exécutez la commande suivante :

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Pour en savoir plus, consultez Emprunt d'identité d'un compte de service.

Terraform

Pour utiliser le code Terraform dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application avec vos identifiants utilisateur.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

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

Pour en savoir plus, consultez Set up authentication for a local development environment.

Bibliothèques clientes

Pour utiliser des bibliothèques clientes dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application avec vos identifiants utilisateur.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

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

Pour en savoir plus, consultez Set up authentication for a local development environment.

Pour configurer votre fichier ADC local afin d'utiliser l'emprunt d'identité de compte de service pour vous authentifier auprès des Google APIs plutôt que vos identifiants utilisateur, exécutez la commande suivante :

gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

Pour en savoir plus, consultez Emprunt d'identité d'un compte de service.

REST

Pour utiliser l'API REST dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

    Install the Google Cloud CLI, then initialize it by running the following command:

    gcloud init

Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.

Vous pouvez utiliser l'emprunt d'identité de compte de service pour générer un jeton d'accès pour les requêtes API REST. Pour en savoir plus, consultez la section Compte de service dont l'identité est empruntée.

Exécuter la Google Cloud CLI

Maintenant que vous avez configuré l'environnement de développement et l'authentification, exécutez l'outil de ligne de commande gcloud pour interagir avec Spanner:

gcloud spanner instance-configs list

La liste des configurations d'instance Spanner auxquelles votre projet a accès doit s'afficher. Elle inclut les configurations régionales, birégionales et multirégionales. Pour en savoir plus, consultez la présentation des instances.

Vous avez terminé la configuration.

Étape suivante

Découvrez comment utiliser les bibliothèques clientes Cloud et les pilotes pour créer une instance, une base de données, des tables et des index Spanner. Ensuite, stockez, interrogez et lisez des données dans Spanner.