Connettersi a Cloud SQL per PostgreSQL da Cloud Shell

Connettersi a Cloud SQL per PostgreSQL da Cloud Shell

MySQL   |  PostgreSQL   |  SQL Server

Questa pagina mostra come creare e connetterti a un'istanza PostgreSQL ed eseguire operazioni SQL di base utilizzando la Google Cloud console e un client. Le risorse create in questa guida rapida in genere costano meno di un dollaro, a condizione che tu completi i passaggi, inclusa la pulizia, in modo tempestivo.

Prima di iniziare

Nota: il nome che utilizzi per il progetto deve contenere da 4 a 30 caratteri. Quando digiti il nome, il modulo suggerisce un ID progetto, che puoi modificare. L'ID progetto deve contenere da 6 a 30 caratteri, con una lettera minuscola come primo carattere. Puoi utilizzare un trattino, una lettera minuscola o una cifra per i caratteri rimanenti, ma l'ultimo carattere non può essere un trattino.

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

Verify that billing is enabled for your Google Cloud project.

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

Verify that billing is enabled for your Google Cloud project.

1. Abilita le API Cloud necessarie.

   Console

   Nella Google Cloud console, vai alla pagina API.

   Vai alle API

   Abilita l'API Cloud SQL Admin.

   gcloud

   Fai clic sul pulsante seguente per aprire Cloud Shell, che fornisce l'accesso tramite riga di comando alle tue Google Cloud risorse direttamente dal browser. Cloud Shell può essere utilizzato per eseguire i comandi gcloud presentati in questa guida rapida.

   Apri Cloud Shell

   Esegui il gcloud services enable comando come segue utilizzando Cloud Shell per abilitare le API richieste per questa guida rapida:

   gcloud services enable sqladmin.googleapis.com

   Questo comando abilita le seguenti API:

   • API Cloud SQL Admin

2. Assicurati di avere il seguente ruolo o i seguenti ruoli nel progetto: Amministratore Cloud SQL (roles/cloudsql.admin)

   Controlla i ruoli

   1. Nella Google Cloud console vai alla pagina IAM.

      Vai a IAM
   2. Seleziona il progetto.

   3. Nella colonna Entità, trova tutte le righe che identificano te o un gruppo di cui fai parte. Per scoprire i gruppi di cui fai parte, contatta l' amministratore.

   4. Per tutte le righe che ti specificano o ti includono, controlla la colonna Ruolo per verificare se l'elenco dei ruoli include i ruoli richiesti.

   Concedi i ruoli

   1. Nella Google Cloud console vai alla pagina IAM.

      Vai a IAM
   2. Seleziona il progetto.
   3. Fai clic su Concedi l'accesso.

   4. Nel campo Nuove entità, inserisci il tuo identificatore dell'utente. In genere si tratta dell'indirizzo email di un Account Google.

   5. Fai clic su Seleziona un ruolo, quindi cerca il ruolo.
   6. Per concedere altri ruoli, fai clic su Aggiungi un altro ruolo e aggiungi ogni ruolo aggiuntivo.
   7. Fai clic su Salva.

Crea un'istanza Cloud SQL

In questa guida rapida utilizzi la Google Cloud console. Per utilizzare la gcloud CLI, cURL o PowerShell, vedi Creare istanze.

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

   Vai a Istanze Cloud SQL

2. Fai clic su Crea istanza.
3. Fai clic su Scegli PostgreSQL.
4. Nel campo ID istanza, inserisci myinstance.
5. Nel campo Password, inserisci una password per l'utente postgres.

6. Fai clic su Crea istanza.

   Viene visualizzato l'elenco delle istanze. Puoi fare clic subito sulla nuova istanza per visualizzarne i dettagli, ma non sarà disponibile per altre operazioni finché non viene inizializzata e avviata.

   Nota: in questo esempio, l'istanza viene creata utilizzando le impostazioni predefinite, incluso un indirizzo IP pubblico.

Connettiti all'istanza

In questa guida rapida utilizzeremo il client psql in Cloud Shell per connetterci all'istanza. Cloud Shell è un ambiente remoto in sandbox.

Nota: Cloud Shell non funziona con un indirizzo IP privato. Queste istruzioni sono valide solo per un'istanza con un indirizzo IP pubblico.

1. (Facoltativo) Se stai eseguendo un'istanza locale di PostgreSQL, arrestala prima di connetterti all'istanza Cloud SQL. In caso contrario, potresti riscontrare errori come address already in use.

2. Nella Google Cloud console, fai clic sull'icona di Cloud Shell () nell'angolo in alto a destra.

   Al termine dell'inizializzazione di Cloud Shell, viene visualizzato un messaggio simile al seguente:

   Welcome to Cloud Shell! Type "help" to get started.
   Your Cloud Platform project in this session is set to sample-project.
   Use "gcloud config set project [PROJECT_ID]" to change to a different project.
   username@sample-project:~ (sample-project)$
   

3. (Facoltativo) Se non hai autorizzato gcloud CLI ad accedere alla Google Cloud piattaforma con le credenziali utente Google, utilizza il gcloud auth login comando.

4. Al prompt di Cloud Shell, connettiti all'istanza Cloud SQL. Utilizza il gcloud sql connect comando come segue. Sostituisci il nome dell'istanza se è diverso.

   gcloud sql connect myinstance --user=postgres

5. Nella finestra di dialogo, fai clic su Autorizza per autorizzare Cloud Shell a effettuare chiamate API.

   Viene visualizzato il seguente messaggio:

   Allowlisting your IP for incoming connection for 5 minutes...done.
   

   Questo messaggio indica che l'indirizzo IP pubblico dell'istanza Cloud SQL è autorizzato a ricevere connessioni in entrata. Dopo questo messaggio, ti viene chiesto di inserire la password.

6. Inserisci la password di postgres.

   Viene visualizzato il prompt psql.

Creare un database e carica i dati

1. Crea un database SQL sull'istanza Cloud SQL:

   CREATE DATABASE guestbook;

2. Connettiti al database inserendo il seguente comando e specificando la password.

   \connect guestbook;

3. Inserisci dati di esempio nel database:

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

4. Recupera i dati:

   SELECT * FROM entries;

   Il risultato è:

     guestname   |   content   | entryid
   --------------+-------------+---------
    first guest  | I got here! |       1
    second guest | Me too!     |       2
   (2 rows)
   postgres=>
   

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 Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Seleziona l'istanza myinstance per aprire la pagina Dettagli istanza.
3. Nella barra delle icone nella parte superiore della pagina, fai clic su Elimina.
4. Nella finestra Elimina istanza, digita il nome dell'istanza e fai clic su Elimina.

Passaggi di pulizia facoltativi

Se non utilizzi le API abilitate nell'ambito di questa guida rapida, puoi disabilitarle.

• API abilitate in questa guida rapida:
  • API Cloud SQL Admin

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

   Vai alle API

2. Seleziona l'API Cloud SQL Admin e fai clic sul pulsante Disattiva API.

Passaggi successivi

• Scopri come creare istanze Cloud SQL.

• Scopri come creare utenti PostgreSQL e database per l'istanza Cloud SQL.

• Consulta le informazioni sui prezzi di Cloud SQL.

• In questa guida rapida ti sei connesso all'istanza utilizzando Cloud Shell. Scopri tutte le opzioni di connettività in Cloud SQL. La modalità di connessione dipende dalla configurazione di rete, ad esempio se l'istanza Cloud SQL ha un indirizzo IP pubblico o privato. Scopri come configurare l'istanza Cloud SQL con un indirizzo IP pubblico e un indirizzo IP privato.

• Scopri come connetterti a un'istanza Cloud SQL da altre applicazioni Google Cloud:

  • Da un'applicazione in esecuzione nell'ambiente standard di App Engine
  • Da un'applicazione in esecuzione su Compute Engine
  • Da un'applicazione in esecuzione su GKE
  • Da Cloud Run