Configura l'ambiente

Questa pagina descrive 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.

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.

Configurare un progetto Google Cloud

  1. Vai alla pagina Progetti nella console Google Cloud .

    Vai alla pagina Progetti

  2. Crea un nuovo Google Cloud progetto o aprine uno 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. Verify that billing is enabled for your Google Cloud project.

    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 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

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

gcloud init

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

Per configurare gcloud CLI in modo che utilizzi la rappresentazione dell'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 ulteriori informazioni, vedi Impersonificazione del service account.

Terraform

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

    Installa Google Cloud CLI.

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

    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.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Per ulteriori informazioni, vedi 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 leCredenziali predefinite dell'applicazionee con le tue credenziali utente.

    Installa Google Cloud CLI.

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

    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.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

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

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

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

Per ulteriori informazioni, vedi Impersonificazione del service account.

REST

Per utilizzare l'API REST in un ambiente di sviluppo locale, utilizza le credenziali fornite all'interfaccia allagcloud CLId.

    Installa Google Cloud CLI.

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

Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Puoi utilizzare l'impersonificazione del account di servizio per generare un token di accesso per le richieste API REST. Per ulteriori informazioni, vedi Service account 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 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 di Cloud per creare un'istanza, un database, tabelle e indici Spanner. Quindi archivia, esegui query e leggi i dati in Spanner.