Configura l'ambiente

Questa pagina illustra i passaggi di configurazione necessari per utilizzare l'API Cloud Spanner con Google Cloud CLI, le librerie client e i driver Spanner.

Se vuoi utilizzare Spanner con la console Google Cloud, consulta la guida rapida all'utilizzo della console.

Configura un progetto Google Cloud

  1. Vai alla pagina Progetti nella console Google Cloud.

    Vai alla pagina Progetti

  2. Crea un nuovo progetto Google Cloud o apri un progetto esistente facendo clic sul nome del progetto.
  3. Apri una finestra del terminale e imposta il tuo progetto come progetto predefinito per Google Cloud CLI, sostituendo MY_PROJECT_ID con il tuo ID progetto (non il nome del progetto):

    gcloud config set project MY_PROJECT_ID
  4. Make sure that billing is enabled for your Google Cloud project.

  5. Puoi anche scoprire i prezzi di Spanner.
  6. Abilita l'API Cloud Spanner per il progetto.

    Abilita l'API Cloud Spanner

    Nota: se utilizzi un account di servizio in un progetto diverso per accedere alla tua istanza Spanner, devi attivare l'API Spanner in entrambi i progetti.

Configura l'autenticazione

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

Per configurare gcloud CLI in modo che utilizzi l'usurpazione di identità dell'account di servizio per autenticarsi alle API di Google anziché alle credenziali utente, esegui il seguente comando:

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Per ulteriori informazioni, vedi Rappresentazione dell'account di servizio.

Terraform

Per utilizzare il codice Terraform in un ambiente di sviluppo locale, installa e inizializza l'interfaccia a riga di comando gcloud, quindi configura le credenziali predefinite dell'applicazione con le tue credenziali utente.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. 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.

Per ulteriori informazioni, consulta Set up authentication for a local development environment.

Librerie client

Per utilizzare le librerie client in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le credenziali predefinite dell'applicazione con le tue credenziali utente.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. 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.

Per ulteriori informazioni, consulta Set up authentication for a local development environment.

Per configurare il file ADC locale in modo che utilizzi l'usurpazione dell'identità dell'account di servizio per autenticarsi alle API di Google anziché alle credenziali utente, esegui il seguente comando:

gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

Per ulteriori informazioni, vedi Rappresentazione dell'account di servizio.

REST

Per utilizzare l'API REST in un ambiente di sviluppo locale, utilizza le credenziali fornite all'interfaccia a riga di comando gcloud.

    Install the Google Cloud CLI, then initialize it by running the following command:

    gcloud init

Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione Google Cloud sull'autenticazione.

Puoi utilizzare l'usurpazione di identità dell'account di servizio per generare un token di accesso per le richieste all'API REST. Per saperne di più, consulta Account di servizio impersonato.

Esegui Google Cloud CLI

Ora che hai configurato l'ambiente di sviluppo e l'autenticazione, esegui lo strumento a riga di comando gcloud per interagire con Spanner:

gcloud spanner instance-configs list

Dovresti visualizzare un elenco delle configurazioni di istanze Spanner a cui può accedere il tuo progetto, incluse le configurazioni a livello di una o più regioni e a due regioni. Per ulteriori informazioni, consulta la Panoramica delle istanze.

Hai completato la configurazione.

Passaggi successivi

Scopri come utilizzare le librerie client e i driver Cloud per creare un'istanza, un database, tabelle e indici Spanner. Poi archivia, esegui query e leggi i dati in Spanner.