Installer la gcloud CLI et configurer l'API Cloud Spanner

Cette page vous guide tout au long du processus de configuration requis pour utiliser l'API Cloud Spanner avec Google Cloud CLI, les bibliothèques clientes et les pilotes Spanner.

Si vous souhaitez utiliser Spanner avec la console Google Cloud, consultez la page 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 votre ID de projet (et non par 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 pendant le développement et les tests, utilisez la Google Cloud CLI avec 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é 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 auxquelles votre projet a accès doit s'afficher, y compris les configurations régionales et multirégionales. Pour en savoir plus, consultez la page Instances.

Vous avez terminé la configuration.

Étapes suivantes

Découvrez comment utiliser les pilotes et les bibliothèques 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.