Installer la CLI gcloud et configurer l'API Cloud Spanner

Cette page vous guide tout au long de la procédure de configuration requise pour utiliser l'API Cloud Spanner. à l'aide de la Google Cloud CLI, bibliothèques clientes Pilotes Spanner.

Si vous souhaitez utiliser Spanner avec la console Google Cloud, consultez la page Guide de démarrage rapide avec la console

Avant de commencer

Votre ordinateur de développement doit être équipé des éléments suivants :

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, en remplaçant MY_PROJECT_ID par l'ID de votre projet (et non le nom de votre projet): 

    gcloud config set project MY_PROJECT_ID

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

    5. Vous pouvez également en savoir plus sur les tarifs de Spanner.

  5. 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 et l'autorisation

Spanner utilise OAuth 2.0. pour l'authentification et l'autorisation des API.

Pour exécuter votre code en local lors des phases de développement et de test, utilisez la classe Google Cloud CLI ainsi que Identifiants par défaut de l'application. À l'invite de commande, exécutez la commande suivante :

gcloud auth application-default login

Une fois que vous avez procédé à l'authentification à l'aide de la commande gcloud auth application-default login, les bibliothèques clientes de l'API qui utilisent les identifiants par défaut de l'application sélectionnent automatiquement les identifiants créés. Vous ne devez exécuter la commande qu'une seule fois pour chaque environnement d'utilisateur local.

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'instances Spanner doit s'afficher. auquel le projet peut accéder, y compris pour les emplacements régionaux, birégionaux et multirégionaux de configuration. Pour en savoir plus, consultez la présentation des instances.

Vous avez terminé la configuration.

Étape suivante

Apprenez à utiliser les bibliothèques clientes et les pilotes Cloud pour créer Instance, base de données, tables et index Spanner. Ensuite, stockez, interrogez et lisez des données dans Spanner.