Installa la 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, librerie client e Driver di Spanner.

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

Prima di iniziare

Sulla macchina di sviluppo devono essere installati i seguenti componenti:

• La CLI gcloud, 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 il nome del progetto):

   gcloud config set project MY_PROJECT_ID

4. Make sure that billing is enabled for your Google Cloud project.

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 altro progetto per accedere al tuo un'istanza Spanner, devi abilitare 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 la classe Google Cloud CLI, oltre a Credenziali predefinite dell'applicazione. Al prompt dei comandi, esegui:

gcloud auth application-default login

Dopo l'autenticazione tramite il comando gcloud auth application-default login, le librerie client API che utilizzano le credenziali predefinite dell'applicazione acquisiscono automaticamente le credenziali create. Devi eseguire solo il comando 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 nella tua produzione dell'ambiente di rete, scopri altre opzioni per le credenziali Recupero delle 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 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.

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