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
-
Accédez à la page Projets de la console Google Cloud.
- Créez un projet Google Cloud ou ouvrez un projet existant en cliquant sur son nom.
-
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
-
Make sure that billing is enabled for your Google Cloud project.
Vous pouvez également obtenir plus d'informations sur la tarification de Spanner.
-
Activez l'API Cloud Spanner pour le projet.
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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
- Premiers pas avec Spanner en C++
- Premiers pas avec Spanner en C#
- Premiers pas avec Spanner en Go
- Premiers pas avec Spanner en Java
- Premiers pas avec Spanner en JDBC
- Premiers pas avec Spanner en Node.js
- Premiers pas avec Spanner en PHP
- Premiers pas avec Spanner en Python
- Premiers pas avec Spanner en Ruby
- Premiers pas avec Spanner en REST
- Premiers pas avec Spanner dans gcloud
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/02/05 (UTC).