Installa l'interfaccia alla gcloud CLI e configura l'API Cloud Spanner

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.

Prima di iniziare

Sul computer di sviluppo deve essere installato quanto segue:

• gcloud CLI, che include la configurazione di Google Cloud CLI (scarica).

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 aprine uno esistente facendo clic sul nome del progetto.
Importante: Il nome utilizzato deve essere compreso tra 4 e 30 caratteri. Quando digiti il nome, il modulo suggerisce un ID progetto che puoi modificare. L'ID progetto che utilizzi deve essere compreso tra 6 e 30 caratteri, con una lettera minuscola come primo carattere. Puoi utilizzare un trattino, una lettera minuscola o una cifra per i caratteri rimanenti, ma l'ultimo carattere non può essere un trattino. Tieni presente che alcuni identificatori di risorse (come gli ID progetto) potrebbero essere conservati per tutta la durata del progetto. Per questo motivo, evita di archiviare informazioni sensibili negli identificatori delle risorse.
...vedi le linee guida per l'assegnazione dei nomi.

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 con il nome del tuo progetto):

   gcloud config set project MY_PROJECT_ID

4. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Puoi anche scoprire di più sui prezzi di Spanner.

5. Abilitare 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 autenticazione e autorizzazione

Spanner utilizza OAuth 2.0 per l'autenticazione e l'autorizzazione delle API.

Per eseguire il codice localmente durante lo sviluppo e il test, utilizza Google Cloud CLI insieme alle Credenziali predefinite dell'applicazione. Al prompt dei comandi, esegui:

gcloud auth application-default login

Dopo aver eseguito l'autenticazione utilizzando il comando gcloud auth application-default login, le librerie client API che utilizzano le credenziali predefinite dell'applicazione raccolgono automaticamente le credenziali create. Devi eseguire il comando solo una volta per ambiente utente locale.

Nota: l'utilizzo di gcloud auth application-default login è adatto per lo sviluppo locale. Quando è tutto pronto per utilizzare Spanner nel tuo ambiente di produzione, scopri altre opzioni per le credenziali in Ottenere le credenziali per il flusso incentrato sul server.

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 vedere un elenco delle configurazioni di istanze Spanner a cui il tuo progetto può accedere, incluse quelle a livello di una regione, di due regioni e di più regioni. Per ulteriori informazioni, consulta la panoramica delle istanze.

Hai completato la configurazione.

Passaggi successivi

Scopri come utilizzare le librerie client e i driver di Cloud per creare istanze, database, tabelle e indici di Spanner. Quindi archivia, esegui query e leggi i dati in Spanner.

• Introduzione a Spanner in C++
• Guida introduttiva a Spanner in C#
• Guida introduttiva a Spanner in Go
• Introduzione a Spanner in Java
• Introduzione a Spanner in JDBC
• Introduzione a Spanner in Node.js
• Introduzione a Spanner in PHP
• Introduzione a Spanner in Python
• Introduzione a Spanner in Ruby
• Introduzione a Spanner in REST
• Introduzione a Spanner in gcloud