Crea un'istanza di prova gratuita di Spanner e un'applicazione di esempio

Questa guida rapida mostra come utilizzare un'istanza di prova senza costi di Spanner e un'applicazione di esempio. Per saperne di più, consulta la panoramica delle istanze di prova senza costi di Spanner.

Inizia con un'istanza di prova senza costi

Un'istanza di prova senza costi di Spanner di 90 giorni è disponibile per chiunque abbia un Account Google con la fatturazione Cloud abilitata nel proprio progetto. Non ti verrà addebitato alcun costo a meno che tu non scelga di eseguire l'upgrade dell'istanza di prova senza costi a un'istanza a pagamento.

Puoi creare un'istanza di prova senza costi utilizzando la console Google Cloud o Google Cloud CLI.

Prima di iniziare

Console Google Cloud

  1. Nella console Google Cloud , vai alla pagina Spanner.

    Vai a Spanner

  2. Seleziona o crea un Google Cloud progetto, se non l'hai ancora fatto.

  3. Se la fatturazione Cloud è già abilitata per il tuo progetto, vai a Crea un'istanza di prova senza costi nella sezione successiva.

    Se la fatturazione Cloud non è abilitata per il tuo progetto, collega un account di fatturazione Cloud esistente o crea un nuovo account di fatturazione Cloud. Google utilizza questi dati di pagamento per verificare la tua identità. Non addebitiamo costi per la tua istanza Spanner a meno che tu non esegua esplicitamente l'upgrade del tuo account di fatturazione Cloud a un account a pagamento e non esegua l'upgrade dell'istanza di prova senza costi di Spanner a un'istanza a pagamento.

    a. Fai clic su Vai alla fatturazione.

    b. Poi, fai clic su Collega un account di fatturazione.

    c. Segui i passaggi per creare un account di fatturazione e poi collegalo al tuo progetto.

    d. Dopo aver abilitato la fatturazione Cloud per il tuo progetto, vai alla pagina Spanner.

    Vai a Spanner

    e. Fai clic su Crea istanza senza costi e vai a Crea istanza di prova senza costi nella sezione successiva.

  4. (Facoltativo) Se hai già creato un'istanza Spanner nel progetto, visualizzi la seguente pagina Istanze Spanner.

    Fai clic su Crea istanza senza costi.

gcloud

  1. Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

  2. Installa Google Cloud CLI.

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

  4. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  5. Crea o seleziona un Google Cloud progetto.

    Ruoli richiesti per selezionare o creare un progetto

    • Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
    • Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

    • Creare un progetto Google Cloud :

      gcloud projects create PROJECT_ID

      Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

    • Seleziona il progetto Google Cloud che hai creato:

      gcloud config set project PROJECT_ID

      Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

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

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

    gcloud auth application-default login

    Non è necessario 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.

  8. Installa Google Cloud CLI.

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

  10. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  11. Crea o seleziona un Google Cloud progetto.

    Ruoli richiesti per selezionare o creare un progetto

    • Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
    • Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

    • Creare un progetto Google Cloud :

      gcloud projects create PROJECT_ID

      Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

    • Seleziona il progetto Google Cloud che hai creato:

      gcloud config set project PROJECT_ID

      Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

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

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

    gcloud auth application-default login

    Non è necessario 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.

Creare un'istanza di prova senza costi

Console Google Cloud

I passaggi seguenti spiegano come creare un'istanza di prova senza costi utilizzando la consoleGoogle Cloud .

Nella pagina Crea la tua istanza di prova senza costi, segui questi passaggi:

  1. Inserisci il Nome istanza da visualizzare nella console Google Cloud . L'istanza deve essere univoca all'interno del progetto Google Cloud .
  2. Inserisci l'ID istanza per identificare in modo permanente la tua istanza. L'ID istanza deve essere univoco anche all'interno del progetto Google Cloud . Non puoi modificare l'ID istanza in un secondo momento.

  3. Seleziona una località di configurazione dal menu a discesa Regione.

    La configurazione dell'istanza determina la posizione geografica in cui l'istanza viene archiviata e replicata. Puoi creare un'istanza di prova senza costi in una qualsiasi delle configurazioni regionali delle istanze di Spanner. Per un elenco completo di tutte le configurazioni di istanza disponibili, consulta Configurazioni a regione singola, a due regioni e multiregionali.

  4. Fai clic su Crea istanza senza costi.

    Dopo aver creato l'istanza di prova senza costi, Spanner crea un database di esempio per consentirti di esplorare e familiarizzare con le funzionalità di Spanner. Per maggiori informazioni, vedi Panoramica delle istanze di prova senza costi.

gcloud

Per creare un'istanza di prova senza costi, utilizza il comando gcloud spanner instances create.

gcloud spanner instances create INSTANCE_ID \
   --instance-type=free-instance --config=INSTANCE_CONFIG \
   --description=INSTANCE_DESCRIPTION

Sostituisci quanto segue:

  • INSTANCE_ID: un identificatore permanente univoco all'interno del tuo progetto Google Cloud . Non potrai modificare l'ID istanza in un secondo momento.

  • INSTANCE_CONFIG: un identificatore permanente della configurazione dell'istanza, che definisce la posizione geografica dell'istanza. Puoi creare un'istanza di prova senza costi in una delle configurazioni regionali di istanze di Spanner:

  • INSTANCE_DESCRIPTION: il nome da visualizzare per l'istanza nella consoleGoogle Cloud . Il nome dell'istanza deve essere univoco all'interno del progettoGoogle Cloud .

Ad esempio, per creare un'istanza di prova senza costi denominata trial-instance con il nome visualizzato Trial Instance utilizzando la configurazione dell'istanza regionale regional-us-east5, esegui il seguente comando:

gcloud spanner instances create trial-instance --config=regional-us-east5 \
  --instance-type=free-instance --description="Trial Instance"

Dopo aver creato l'istanza di prova senza costi, ti viene chiesto di continuare a imparare e a esplorare Spanner avviando un tutorial passo passo che ti insegna a creare un database utilizzando un'applicazione di esempio. Per ulteriori informazioni, consulta Guida introduttiva a un'applicazione di esempio.

Iniziare a utilizzare un database di esempio

Dopo aver creato l'istanza di prova senza costi utilizzando la console, Spanner crea un database di esempio che puoi esplorare per acquisire familiarità con le funzionalità di Spanner. Google Cloud

Puoi accedere al database di esempio utilizzando la console Google Cloud .

Console Google Cloud

  1. Nella console Google Cloud , vai alla pagina Istanze Spanner.

    Vai alla pagina Istanze

  2. Fai clic sul nome dell'istanza di prova senza costi.

  3. Fai clic sul nome del database di esempio.

Puoi visualizzare le tabelle e i dati nel database di esempio. Puoi anche accedere alle query salvate e visualizzarle nella pagina Spanner Studio. Le query salvate mostrano diverse funzionalità e capacità di Spanner.

Inizia a utilizzare un'applicazione di esempio

Spanner offre anche un'applicazione di esempio open source per aiutarti a iniziare a utilizzare l'istanza di prova senza costi di Spanner. L'applicazione di esempio è costituita da un servizio gRPC di backend supportato da un database Spanner e da un generatore di carichi di lavoro che indirizza il traffico al servizio.

Puoi accedere all'applicazione di esempio utilizzando Google Cloud CLI.

gcloud

  1. Completa i passaggi descritti nella configurazione di gcloud, che include la creazione e l'impostazione di un progetto Google Cloud predefinito, l'attivazione dell'API Cloud Spanner e la configurazione di OAuth 2.0 per ottenere le credenziali di autenticazione per utilizzare l'API Cloud Spanner.

    Esegui il comando gcloud auth application-default login per configurare l'ambiente di sviluppo locale con le credenziali di autenticazione.

  2. Esegui il comando gcloud spanner samples run per scaricare l'applicazione di esempio e avviare il servizio gRPC di backend e il generatore di carichi di lavoro per l'applicazione di esempio specificata:

    gcloud spanner samples run APPNAME --instance-id INSTANCE_ID

  3. Per saperne di più e per un elenco di altri comandi disponibili per l'applicazione di esempio, consulta la documentazione di gcloud CLI.

Importa i tuoi dati

Puoi importare i tuoi dati in un database Spanner utilizzando un file CSV, un file di dump MySQL o un file di dump PostgreSQL. Puoi caricare un file locale utilizzando Cloud Storage o direttamente da un bucket Cloud Storage. Il caricamento di un file locale utilizzando Cloud Storage potrebbe comportare costi.

Se scegli di utilizzare un file CSV, devi anche caricare un file JSON separato che contiene lo schema del database.

Console Google Cloud

  1. Nella console Google Cloud , vai alla pagina Istanze Spanner.

    Vai alle istanze Spanner

  2. Seleziona l'istanza in cui creare il database.

  3. Fai clic su Importa i miei dati.

  4. Inserisci i seguenti valori:

    • Seleziona il Tipo di file.

    • Carica il file dal computer o seleziona un percorso del bucket Cloud Storage al file.

    • (Facoltativo) Se scegli di utilizzare un file CSV, devi anche caricare un file JSON separato contenente lo schema del database. Il file JSON deve utilizzare la seguente struttura per definire lo schema:

      {
  "name": "COLUMN_NAME",
  "type": "TYPE",
  "notNull": NOT_NULL_VALUE,
  "primaryKeyOrder": PRIMARY_KEY_ORDER
}

      Sostituisci quanto segue:

      • COLUMN_NAME: il nome della colonna nella tabella.

      • TYPE: il tipo di dati della colonna.

      • (Facoltativo) NOT_NULL_VALUE: indica se la colonna può memorizzare valori nulli o meno. Gli input validi sono true o false. Il valore predefinito è false.

      • (Facoltativo): PRIMARY_KEY_ORDER: determina l'ordine della chiave primaria. Il valore è impostato su 0 per una colonna della chiave non primaria. Imposta il valore su un numero intero, ad esempio 1 per una colonna della chiave primaria. Le colonne con numeri più bassi vengono visualizzate prima in una chiave primaria composta.

      Per impostazione predefinita, il file CSV prevede una virgola come delimitatore di campo e una nuova riga come delimitatore di riga. Per ulteriori informazioni sull'utilizzo di delimitatori personalizzati, consulta il riferimento gcloud alpha spanner databases import.

    • Seleziona un database nuovo o esistente come destinazione.

  5. Fai clic su Importa.

  6. Spanner apre Cloud Shell e compila un comando che installa lo strumento di migrazione di Spanner ed esegue il comando gcloud alpha spanner databases import. Premi il tasto ENTER per importare i dati nel database.

Eseguire l'upgrade di un'istanza di prova senza costi

I passaggi seguenti spiegano come eseguire l'upgrade dell'istanza di prova senza costi.

Console Google Cloud

  1. Nella console Google Cloud , vai alla pagina Istanze Spanner.

    Vai alla pagina Istanze

  2. Fai clic sul nome dell'istanza di prova senza costi.

  3. Nella pagina Panoramica istanza, fai clic su Modifica istanza o Modifica per eseguire l'upgrade.

  4. Nel campo Aggiorna nome istanza, inserisci un nome più appropriato per l'istanza a pagamento, se applicabile.

  5. Seleziona l'opzione di upgrade. Puoi selezionare una delle seguenti opzioni:

    • Esegui l'upgrade ora
    • Esegui automaticamente l'upgrade alla versione completa di Enterprise al termine della prova
    • Ricordamelo più tardi

    La sezione Riepilogo fornisce una descrizione dei costi di calcolo e archiviazione per l'istanza a pagamento di cui è stato eseguito l'upgrade che hai selezionato.

  6. Fai clic su Salva per eseguire l'upgrade dell'istanza di prova senza costi.

gcloud

Per eseguire l'upgrade dell'istanza di prova senza costi a un'istanza dell'edizione Enterprise a pagamento con la stessa configurazione, esegui il seguente comando gcloud spanner instances update:

gcloud spanner instances update INSTANCE_ID --instance-type=provisioned

Elimina l'istanza

Console Google Cloud

  1. Vai alla pagina Istanze Spanner nella console Google Cloud .

    Vai alla pagina Istanze

  2. Fai clic sul nome dell'istanza che vuoi eliminare.

  3. Nella pagina Panoramica istanza, fai clic su Elimina istanza.

  4. Segui le istruzioni per confermare che vuoi eliminare l'istanza.

  5. Fai clic su Elimina.

gcloud

Per eliminare l'istanza di prova senza costi, utilizza il seguente comando gcloud spanner instances delete:

gcloud spanner instances delete INSTANCE_ID

Passaggi successivi