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 vengono archiviati in cluster che contengono istanze. In questa guida rapida, configurerai un cluster, ti connetterai alla relativa istanza e inserirai ed eseguirai query su 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 Google Cloud account. 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 Google Cloud progetto di AlloyDB.

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

1. Scegli come connetterti ad AlloyDB.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare un database AlloyDB e connetterti a quest'ultimo, chiedi all'amministratore di concederti i seguenti ruoli IAM per il 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 un database AlloyDB e connetterti a quest'ultimo. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un database AlloyDB e connetterti a quest'ultimo 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 Google Cloud console, 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 singola zona in questa guida rapida per ridurre al minimo i costi. Per saperne di più, consulta la pagina 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. In caso contrario, fai clic su Configura connessione e segui questi passaggi:

      1. In Alloca un intervallo IP, fai clic su Utilizza l'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. La creazione del cluster da parte di AlloyDB potrebbe richiedere alcuni minuti. Una volta creato, il cluster viene visualizzato nella pagina Panoramica del cluster principale.

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 Google Cloud console, vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic sul nome del 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 Autentica. Nel riquadro Spazio di esplorazione viene visualizzato 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;
   

   Quando nel riquadro Risultati viene visualizzato il messaggio Statement executed successfully (Istruzione eseguita correttamente), significa che il database è stato creato.

Connettiti al database guestbook

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

   Vai a Cluster

2. Fai clic sul nome del 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 Autentica. Nel riquadro Spazio di esplorazione viene visualizzato 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 (Istruzione eseguita correttamente) 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 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
   

Libera spazio

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

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

   Vai a Cluster

2. Fai clic sul nome del 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 Google Cloud pagina Rete della console e fai clic su Elimina rete VPC.

Passaggi successivi

• Scopri altri modi per connetterti ad AlloyDB.

• Abilita l'accesso al progetto in AlloyDB.

• Concedi l'accesso ad altri utenti.

• Abilita l'accesso privato ai servizi.

• Scegli un tipo di macchina AlloyDB.

• Crea un cluster AlloyDB e la relativa istanza principale.

• Scopri di più sui consigli per il dimensionamento.

• Connetti un client psql a un'istanza.