Creare e connettersi a un database

Questa pagina ti guida nella procedura di creazione e connessione al tuo primo database su AlloyDB per PostgreSQL.

Le istruzioni fornite alla fine di questa guida rapida ti guidano nella pulizia di questo nuovo database. La pagina si conclude con i passaggi successivi per scoprire di più su come utilizzare 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. Verify 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. Verify 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 le modifiche.

    2. Nel passaggio Abilita API, fai clic su Abilita per abilitare 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 progetto Google Cloud diverso.

gcloud

  1. Crea un Google Cloud progetto 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. Verifica che la fatturazione sia attivata 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 di AlloyDB, abilita l'API Service Networking nel progetto. Google Cloud 

    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 progetto diverso, Google Cloud verifica che le API Compute Engine e Service Networking in quel progetto siano abilitate in modo da poter configurare il VPC condiviso e l'accesso privato ai servizi in quel progetto.

    gcloud services list

Creare un cluster e la relativa istanza principale

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

    Vai a Cluster

  2. Fai clic su Crea cluster.

  3. In Configura il cluster, segui questi passaggi:

    1. Nel campo ID cluster, inserisci my-cluster.

    2. Inserisci una password. Prendi nota di questa password perché la utilizzerai in questa guida rapida.

    3. Mantieni la versione del database predefinita.

    4. Nel menu a discesa Regione di Località, seleziona la regione us-central1 (Iowa).

  4. In Configura l'istanza principale, segui questi passaggi:

    1. Nel campo ID istanza, inserisci my-cluster-primary.

    2. In Disponibilità a livello di zona, fai clic su Zona singola.

    3. Nel menu a discesa Tipo di macchina, seleziona il tipo di macchina 2 vCPU, 16 GB.

    4. Nel menu a discesa Rete di Connettività, seleziona la rete default.

      Se hai una connessione di accesso privato, continua con il passaggio di creazione di un cluster. In caso contrario, fai clic su Configura connessione e segui questi passaggi:

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

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

    5. Mantieni le impostazioni predefinite in Sicurezza di rete.

  5. Fai clic su Crea cluster. Potrebbero essere necessari diversi minuti prima che AlloyDB crei il cluster e lo visualizzi nella pagina Panoramica del cluster primario.

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. Scegli un metodo di autenticazione del database.

    2. Seleziona il database postgres.

    3. 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 è stato creato quando nel riquadro Risultati viene visualizzato il messaggio Statement executed successfully.

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 Creazione di un cluster e della relativa istanza principale.

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

Verificare la connessione al database

  1. Segui i passaggi descritti in Connettiti 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 vengono 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 nel 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