Installer la gcloud CLI et configurer l'API Cloud Spanner

Cette page vous guide à travers les étapes de configuration nécessaires 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 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. Vérifiez que la facturation est activée pour votre projet Google Cloud.

    5. Vous pouvez également consulter 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 d'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 de l'API.

Pour exécuter votre code localement lors des phases de développement et de test, utilisez la Google Cloud CLI ainsi que les 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é votre environnement de développement et votre authentification, exécutez l'outil de ligne de commande gcloud pour interagir avec Spanner:

gcloud spanner instance-configs list

Une liste des configurations d'instances Spanner auxquelles votre projet peut accéder doit s'afficher, y compris les configurations régionales, birégionales et multirégionales. Pour en savoir plus, consultez la page Présentation des instances.

Vous avez terminé la configuration.

Étapes suivantes

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