Connettiti a un client psql a un'istanza

Questa pagina descrive come collegare lo strumento client psql a un'istanza AlloyDB.

La procedura per connettere psql a un'istanza AlloyDB prevede le seguenti attività:

  1. Crea una VM Compute Engine che possa connettersi alle istanze AlloyDB utilizzando l'accesso privato ai servizi.
  2. Installa il client psql sulla VM Compute Engine.
  3. Ottieni l'indirizzo IP dell'istanza AlloyDB a cui vuoi connetterti.
  4. Esegui il client psql.

Le prime due di queste attività sono operazioni una tantum. Dopo aver creato una VM Compute Engine e aver installato il client psql, puoi continuare a utilizzare la VM per connettere psql alle istanze AlloyDB svolgendo le attività rimanenti.

Prima di iniziare

  • Il progetto Google Cloud che utilizzi deve essere stato abilitato per accedere ad AlloyDB.
  • Una rete VPC nel progetto Google Cloud che stai utilizzando deve essere già configurata per l'accesso privato ai servizi ad AlloyDB.
  • Devi disporre di uno di questi ruoli IAM nel progetto Google Cloud che utilizzi:
    • roles/alloydb.admin (il ruolo IAM predefinito AlloyDB Admin)
    • roles/owner (il ruolo IAM di base Proprietario)
    • roles/editor (il ruolo IAM di base Editor)

    Se non disponi di nessuno di questi ruoli, contatta l'amministratore dell'organizzazione per richiedere l'accesso.

  • Se l'host client dispone di un firewall, deve consentire le connessioni in uscita alla porta 5432 sugli indirizzi IP delle istanze AlloyDB.

Crea una VM di Compute Engine

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

    Vai a Istanze VM

  2. Seleziona il progetto contenente l'istanza AlloyDB a cui vuoi collegarti.
  3. Fai clic su Crea istanza.
  4. Fai clic sulla sezione Configurazione macchina.
  5. Inserisci un nome per l'istanza.
  6. Configura la regione e la zona in cui vuoi creare l'istanza.
  7. Seleziona una serie di macchine e il tipo di macchina corrispondente.
  8. Mantieni i valori predefiniti nella sezione Sistema operativo e spazio di archiviazione.
  9. Fai clic sulla sezione Networking e imposta Interfacce di rete sulla rete VPC configurata per l'accesso privato ai servizi ad AlloyDB.
    Se Interfacce di rete non è impostato sulla rete VPC configurata per l'accesso privato ai servizi, espandi l'opzione e imposta Rete sulla rete VPC.
  10. Mantieni i valori predefiniti nella sezione Osservabilità.
  11. Fai clic sulla sezione Sicurezza.
  12. In Identità e accesso API, imposta Ambiti di accesso su Consenti l'accesso completo a tutte le API Cloud.
  13. Mantieni i valori predefiniti nella sezione Avanzate.
  14. Fai clic su Crea.

Dopo aver creato la VM, connettiti alla VM Compute Engine che hai creato utilizzando SSH.

Installa lo strumento client psql

  1. Connettiti alla VM Compute Engine che hai creato utilizzando SSH.

    Console

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

      Vai a Istanze VM

    2. Nell'elenco delle istanze della macchina virtuale, fai clic su SSH nella riga dell'istanza che hai creato.

    gcloud

    Utilizza il comando gcloud compute ssh per connetterti all'istanza che hai creato.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto che contiene l'istanza
    • ZONE: il nome della zona in cui si trova l'istanza
    • VM_NAME: il nome dell'istanza
  2. Installa il client psql dal gestore dei pacchetti: 
    sudo apt-get update
sudo apt-get install postgresql-client

Ottenere l'indirizzo IP dell'istanza AlloyDB

Per ottenere l'indirizzo IP dell'istanza AlloyDB a cui vuoi collegarti, visualizza le impostazioni dell'istanza.

Esegui il client psql

  1. Connettiti alla VM che hai creato utilizzando SSH.

    Console

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

      Vai a Istanze VM

    2. Nell'elenco delle istanze della macchina virtuale, fai clic su SSH nella riga dell'istanza che hai creato.

    gcloud

    Utilizza il comando gcloud compute ssh per connetterti all'istanza che hai creato.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto che contiene l'istanza
    • ZONE: il nome della zona in cui si trova l'istanza
    • VM_NAME: il nome dell'istanza
  2. Esegui lo strumento client psql: 
    psql -h IP_ADDRESS -U USERNAME

    Ti verrà chiesto di inserire la password dell'utente USERNAME.

    Se ti connetti per la prima volta, utilizza il valore predefinito postgres per USERNAME e la password che hai utilizzato durante la creazione del cluster per PASSWORD.