Crea ed esegui query su un database AlloyDB utilizzando la Google Cloud console

Crea ed esegui query su un database AlloyDB utilizzando la Google Cloud console

In AlloyDB per PostgreSQL, i database sono archiviati in cluster che contengono istanze. In questa guida rapida, configurerai un cluster, ti connetterai alla sua istanza e inserirai ed eseguirai query sui dati di esempio. Per saperne di più sull'architettura, sui cluster e sulle istanze di AlloyDB, consulta la panoramica di AlloyDB.

Prima di iniziare

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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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.

1. Scegli come connetterti ad AlloyDB.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare e connetterti a un database AlloyDB, chiedi all'amministratore di concederti i seguenti ruoli IAM nel tuo progetto:

• Compute Network Admin (roles/compute.networkAdmin)
• AlloyDB Admin (roles/alloydb.admin)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare e connettersi a un database AlloyDB. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un database AlloyDB e connettersi a esso sono necessarie le seguenti autorizzazioni:

• compute.networks.list
• compute.networks.addPeering
• compute.addresses.create
• servicenetworking.services.addPeering
• alloydb.clusters.create
• alloydb.instances.create
• alloydb.instances.login

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Crea un cluster e la relativa istanza AlloyDB principale

Nota: per configurare rapidamente un cluster, un'istanza e una rete per l'ambiente di sviluppo utilizzando un'interfaccia web, segui i passaggi descritti in questo codelab.

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.

      Nota: anche se non consigliamo un'istanza a zona singola per la produzione, puoi utilizzare una zona singola in questa guida rapida per ridurre al minimo i costi. Per ulteriori informazioni, consulta la sezione Ridurre i costi utilizzando le istanze di base.

   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. Altrimenti, 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 in AlloyDB Studio

Nota: per connettere un client psql a un'istanza, segui i passaggi descritti in Connettere un client psql a un'istanza.

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.

Verifica 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

• Scopri altri modi per connetterti ad AlloyDB.

• Abilita l'accesso al progetto in AlloyDB.

• Concedere l'accesso ad altri utenti.

• Attiva l'accesso privato ai servizi.

• Scegli un tipo di macchina AlloyDB.

• Crea un cluster AlloyDB e la relativa istanza principale.

• Scopri di più sui suggerimenti relativi al dimensionamento.

• Connetti un client psql a un'istanza.