Crea e connettiti a un database

Questa pagina descrive la procedura per creare e connetterti al tuo primo database su AlloyDB per PostgreSQL.

Le istruzioni fornite alla fine di questa guida rapida ti illustrano come ripulire questo nuovo database. La pagina termina con i passaggi successivi per scoprire di più sull'utilizzo di AlloyDB con le tue applicazioni.

Prima di iniziare

Console

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

  6. Abilita le API Cloud necessarie per creare e connetterti ad AlloyDB per PostgreSQL.

    Abilita le API

    1. Nel passaggio Conferma progetto, fai clic su Avanti per confermare il nome del progetto a cui apporterai modifiche.

    2. Nel passaggio Abilita API, fai clic su Abilita per attivare quanto segue:

      • API AlloyDB
      • API Compute Engine
      • API Cloud Resource Manager
      • API Service Networking

      L'API Service Networking è necessaria se prevedi di configurare la connettività di rete ad AlloyDB utilizzando una rete VPC che si trova nello stesso progetto Google Cloud di AlloyDB.

      L'API Compute Engine e l'API Cloud Resource Manager sono necessarie se prevedi di configurare la connettività di rete ad AlloyDB utilizzando una rete VPC che si trova in un altro progetto Google Cloud .

gcloud

  1. Crea un progetto Google Cloud o utilizzane uno esistente:

    gcloud projects create PROJECT_ID --set-as-default
# For an existing project
gcloud config set project PROJECT_ID

    Sostituisci quanto segue:

    • PROJECT_ID: l'identificatore permanente del progetto.

  2. Assicurati che la fatturazione sia abilitata per il tuo progetto Google Cloud . Scopri come verificare che la fatturazione sia attivata per il tuo progetto.

  3. Abilita le API AlloyDB, Compute Engine e Resource Manager:

    gcloud services enable alloydb.googleapis.com
gcloud services enable compute.googleapis.com
gcloud services enable cloudresourcemanager.googleapis.com

  4. Se prevedi di configurare la connettività di rete ad AlloyDB utilizzando una rete VPC che si trova nello stesso progetto Google Cloud di AlloyDB, abilita l'API Service Networking nel progetto.

    gcloud services enable servicenetworking.googleapis.com

  5. Se prevedi di configurare la connettività di rete ad AlloyDB utilizzando una rete VPC che si trova in un altro progetto Google Cloud , verifica che le API Compute Engine e Service Networking in quel progetto siano abilitate in modo da poter configurare l'accesso ai servizi privati e alla VPC condivisa in quel progetto.

    gcloud services list

Creazione di un cluster e della relativa istanza principale

NOTA : se prevedi di utilizzare la rete privata, puoi eseguire il deployment sia della configurazione della rete privata che dell'istanza AlloyDB insieme a client come le VM Compute Engine utilizzando Terraform. Per ulteriori informazioni, consulta Soluzioni di configurazione semplificata della rete cloud.

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

    Vai a Cluster

  2. Fai clic su Crea cluster.

  3. In ID cluster, inserisci my-cluster.

  4. Inserisci una password. Prendi nota di questa password perché la utilizzerai in questo quickstart.

  5. Mantieni la versione del database predefinita.

  6. Seleziona la regione us-central1 (Iowa).

  7. Seleziona la rete predefinita.

    Se hai una connessione di accesso privato, vai al passaggio successivo. In caso contrario, fai clic su Configura connessione e segui questi passaggi:

    1. In Alloca un intervallo IP, fai clic su Utilizza un intervallo IP allocato automaticamente.

    2. Fai clic su Continua e poi su Crea connessione.

  8. Mantieni l'ID istanza predefinito, my-cluster-primary.

  9. In Disponibilità a livello di zona, mantieni Zona singola come opzione selezionata. Sebbene non sia consigliabile utilizzare un'istanza a zona singola per la produzione, in questa guida rapida utilizzerai una singola zona per ridurre al minimo i costi. Per ulteriori informazioni, consulta la pagina Ridurre i costi utilizzando istanze di base.

  10. Seleziona il tipo di macchina 2 vCPU, 16 GB.

  11. Mantieni le impostazioni predefinite in Connettività e Sicurezza di rete.

  12. Non apportare modifiche in Mostra opzioni avanzate.

  13. Fai clic su Crea cluster. Potrebbero essere necessari diversi minuti prima che AlloyDB crei il cluster e lo mostri nella pagina Panoramica del cluster principale.

Connettiti all'istanza e crea un database

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

    Vai a Cluster

  2. Fai clic sul nome del tuo cluster, my-cluster, nella colonna Nome risorsa.

  3. Nel riquadro di navigazione, fai clic su AlloyDB Studio.

  4. Nella pagina Accedi ad AlloyDB Studio, segui questi passaggi:

    1. Seleziona il database postgres.

    2. Seleziona l'utente postgres.

    3. Inserisci la password che hai creato in Creare un cluster e la relativa istanza principale.

    4. Fai clic su Authenticate (Autentica). Il riquadro Explorer mostra un elenco degli oggetti nel database postgres.

  5. Per creare un database, inserisci la seguente istruzione nella scheda Editor 1 e poi fai clic su Esegui:

    CREATE DATABASE guestbook;

    Il database viene creato quando viene visualizzato il messaggio Statement executed successfully nel riquadro Risultati.

Connettiti al database guestbook

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

    Vai a Cluster

  2. Fai clic sul nome del tuo cluster, my-cluster, nella colonna Nome risorsa.

  3. Nel riquadro di navigazione, fai clic su AlloyDB Studio.

  4. Nella pagina Accedi ad AlloyDB Studio, segui questi passaggi:

    1. Seleziona il database guestbook.

    2. Seleziona l'utente postgres.

    3. Inserisci la password che hai creato in Creare un cluster e la relativa istanza principale.

    4. Fai clic su Authenticate (Autentica). Il riquadro Explorer mostra un elenco degli oggetti nel database guestbook.

Verifica la connessione al database

  1. Segui i passaggi descritti in Connettersi al database guestbook.

  2. Per inserire dati di esempio nel database guestbook, inserisci quanto segue nella scheda Editor 1:

    CREATE TABLE entries (guestName VARCHAR(255),
                      content VARCHAR(255),
                      entryID SERIAL PRIMARY KEY);
INSERT INTO entries (guestName, content) values ('Alex', 'I got here!');
INSERT INTO entries (guestName, content) values ('Kai', 'Me too!');

  3. Fai clic su Esegui. Il messaggio Statement executed successfully nel riquadro Risultati indica che i dati sono stati inseriti nel database.

  4. Per rimuovere il testo dalla scheda Editor 1 in modo da poter eseguire un altro comando, fai clic su Cancella.

  5. Per selezionare tutte le voci del database, inserisci la seguente query nella scheda Editor 1:

    SELECT * FROM entries;

  6. Fai clic su Esegui. Nel riquadro Risultati viene visualizzato un output simile al seguente:

        guestname     | content     | entryid
    --------------+-------------+---------
    Alex          | I got here! | 1
    Kai           | Me too!     | 2

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

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

    Vai a Cluster

  2. Fai clic sul nome del tuo cluster, my-cluster, nella colonna Nome risorsa.

  3. Fai clic su Elimina cluster.

  4. In Elimina cluster my-cluster, inserisci my-cluster per confermare che vuoi eliminare il cluster.

  5. Fai clic su Elimina.

  6. Se hai creato una connessione privata quando hai creato un cluster, vai alla console Google Cloud Pagina Networking e fai clic su Elimina rete VPC.

Passaggi successivi