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 Google Cloud console, consulta la guida rapida all'utilizzo della console.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare e interagire con i database Spanner, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Configura un Google Cloud progetto

  1. Vai alla pagina Progetti nella Google Cloud console.

    Vai alla pagina Progetti

  2. Crea un nuovo Google Cloud progetto o apri un progetto esistente facendo clic sul nome del progetto.

  3. Apri una finestra del terminale e imposta il progetto come progetto predefinito per Google Cloud CLI, sostituendo MY_PROJECT_ID con l'ID progetto (non il nome del progetto): 

    gcloud config set project MY_PROJECT_ID

  4. Verifica che la fatturazione sia abilitata per il tuo Google Cloud progetto.

    5. Puoi anche scoprire di più sui prezzi di Spanner.

  5. 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 all'istanza Spanner, devi abilitare l'API Spanner in entrambi i progetti.

Configura l'autenticazione

Seleziona le schede relative alla modalità di accesso all'API:

Console

Quando utilizzi la Google Cloud console per accedere a Google Cloud servizi e API, non devi configurare l'autenticazione.

gcloud

Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente: 

gcloud init

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per configurare gcloud CLI in modo che utilizzi la simulazione dell'identità dei account di servizio per l'autenticazione alle API di Google, anziché le tue credenziali utente, esegui questo comando: 

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Per saperne di più, consulta Simulazione dell'identità dei service account.

Terraform

Per utilizzare il codice Terraform in un ambiente di sviluppo locale, installa e inizializza la gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.

  1. Installa Google Cloud CLI.

  2. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  3. Se utilizzi una shell locale, crea le credenziali di autenticazione locali per il tuo account utente: 

    gcloud auth application-default login

    Non devi eseguire questa operazione se utilizzi Cloud Shell.

    Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

Librerie client

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

  1. Installa Google Cloud CLI.

  2. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  3. Se utilizzi una shell locale, crea le credenziali di autenticazione locali per il tuo account utente: 

    gcloud auth application-default login

    Non devi eseguire questa operazione se utilizzi Cloud Shell.

    Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

Per configurare il file ADC locale in modo che utilizzi la simulazione dell'identità dei account di servizio per l'autenticazione alle API di Google, anziché le credenziali utente, esegui questo comando: 

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

Per saperne di più, consulta Simulazione dell'identità dei service account.

REST

Per utilizzare l'API REST in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

    Installa Google Cloud CLI.

    Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella Google Cloud documentazione sull'autenticazione di.

Puoi utilizzare la simulazione dell'identità dei service account per generare un token di accesso per le richieste API REST. Per saperne di più, consulta Service account con identità simulata.

Esegui Google Cloud CLI

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

gcloud spanner instance-configs list

Dovresti visualizzare un elenco delle configurazioni dell'istanza Spanner a cui il tuo progetto può accedere, incluse le configurazioni regionali, a due regioni e multiregionali. Per saperne di più, 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. Quindi archivia, esegui query e leggi i dati in Spanner.