Configurer

Cette page présente les étapes de configuration nécessaires pour utiliser l'API Cloud Spanner avec la CLI Google Cloud et les bibliothèques clientes.

Si vous souhaitez utiliser Cloud Spanner avec Google Cloud Console, consultez la page Guide de démarrage rapide sur l'utilisation de 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 dans Google Cloud Console.

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

    gcloud config set project MY_PROJECT_ID

  4. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.

    5. En savoir plus sur les tarifs de Cloud Spanner

  5. Activez l'API Cloud Spanner pour le projet.

    Activer l'API Cloud Spanner

Configurer l'authentification et l'autorisation

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

Pour exécuter votre code localement lors du développement et des tests, utilisez la CLI Google Cloud 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 CLI Google Cloud

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 Cloud Spanner :

gcloud spanner instance-configs list

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

Vous avez terminé la configuration.

Étapes suivantes

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