Connettiti a Cloud SQL per PostgreSQL da Cloud Shell

Questa pagina mostra come creare e connetterti a un'istanza PostgreSQL ed eseguire operazioni SQL di base utilizzando la console Google Cloud 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

  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 Google Cloud necessarie.

    Console

    Nella console Google Cloud, vai alla pagina API.

    Vai alle API

    Abilita l'API Cloud SQL Admin.

    gcloud

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

    Apri Cloud Shell

    Esegui il comando gcloud services enable come segue utilizzando Cloud Shell per abilitare le API richieste per questo Quickstart:

    gcloud services enable sqladmin.googleapis.com

    Questo comando abilita le seguenti API:

    • API Cloud SQL Admin

Crea un'istanza Cloud SQL

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

  1. Nella console Google Cloud, 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.

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

Connettiti all'istanza

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

  1. (Facoltativo) Se stai eseguendo un'istanza locale di PostgreSQL, interrompila prima di connetterti all'istanza Cloud SQL. In caso contrario, potresti riscontrare errori come address already in use.
  2. Nella console Google Cloud, fai clic sull'icona di Cloud Shell (Icona Cloud Shell.) nell'angolo in alto a destra.

    Al termine dell'inizializzazione di Cloud Shell, viene visualizzato un messaggio, ad esempio il 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 Platform con le tue credenziali utente Google, utilizza il comando gcloud auth login.
  4. Al prompt di Cloud Shell, connettiti all'istanza Cloud SQL. Utilizza il comando gcloud sql connect 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 all'indirizzo IP pubblico della tua istanza Cloud SQL è consentito ricevere connessioni in entrata. Dopo questo messaggio, ti verrà chiesto di inserire la password.

  6. Inserisci la password di postgres.

    Viene visualizzato il messaggio psql.

Creare un database e carica i dati

  1. Crea un database SQL nell'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=>
    

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 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 facoltativi per la pulizia

Se non utilizzi le API attivate nell'ambito di questa guida rapida, puoi disattivarle.

  • API abilitate in questa guida rapida:
    • API Cloud SQL Admin
  1. Nella console Google Cloud, vai alla pagina API.

    Vai alle API

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

Passaggi successivi