Esegui e connettiti ad AlloyDB Omni

Seleziona una versione della documentazione:

Questa pagina descrive come eseguire e connettersi ad AlloyDB Omni dopo averlo installato sulla tua macchina.

Prima di iniziare

La maggior parte dei comandi in questa pagina utilizza la CLI AlloyDB Omni.

Per installare questo strumento a riga di comando sulla tua macchina, consulta Installare l'interfaccia a riga di comando AlloyDB Omni.

Esegui AlloyDB Omni

Le procedure che utilizzi per eseguire AlloyDB Omni dipendono dal fatto che tu stia eseguendo AlloyDB Omni in un container su un singolo server.

L'installazione di AlloyDB Omni configura un servizio di sistema chiamato alloydb-dataplane, configurato per essere avviato ogni volta che la macchina si avvia.

Per il controllo e il monitoraggio di base di AlloyDB Omni, utilizza il comando sudo alloydb, come mostrato nelle sezioni seguenti.

Avvia AlloyDB Omni

sudo alloydb database-server start

Per eseguire un test di connessione, vedi Connettersi utilizzando psql in contenitori.

Controlla lo stato di AlloyDB Omni

sudo alloydb database-server status

Arresta AlloyDB Omni

sudo alloydb database-server stop

Disattivare l'avvio

L'esecuzione del seguente comando impedisce l'avvio automatico di AlloyDB Omni all'avvio della macchina.

sudo systemctl disable alloydb-dataplane

Riattivare l'avvio all'avvio

  sudo systemctl enable alloydb-dataplane

Connettiti ad AlloyDB Omni in esecuzione su un singolo server

Il container AlloyDB Omni include una propria copia di psql che ti consente di aprire una sessione di shell SQL interattiva con il relativo server di database.

Puoi anche connetterti ad AlloyDB Omni dall'esterno del container utilizzando il software compatibile con PostgreSQL che preferisci.

Connettiti utilizzando psql in container

Per connetterti al server di database AlloyDB Omni utilizzando la propria copia containerizzata di psql, esegui questo comando:

A un solo server 

docker exec -it pg-service psql -h localhost -U postgres

Questo comando ti connette al server con il ruolo utente postgres e visualizza un prompt dei comandi postgres=#. Ora puoi eseguire comandi psql e query SQL.

Per uscire da psql, esegui il comando \q.

Connettersi utilizzando le proprie applicazioni

Qualsiasi applicazione che funziona con PostgreSQL può funzionare anche con AlloyDB Omni, senza bisogno di modifiche.

Per connetterti al server di database AlloyDB Omni, utilizza qualsiasi client o libreria di codice compatibile con PostgreSQL per connetterti alla porta 5432, la porta predefinita del server di database PostgreSQL, della macchina che esegue AlloyDB Omni.

Questo funziona perché il container AlloyDB Omni espone la propria porta 5432 alla stessa porta della macchina su cui viene eseguito.

Dopo aver effettuato la connessione al server di database, puoi definire, interrogare e modificare i tuoi database utilizzando query DML e SQL utilizzando i protocolli di comunicazione PostgreSQL standard.

Poiché AlloyDB Omni viene eseguito nel tuo ambiente, puoi controllare la modalità di connessione ad AlloyDB Omni. Ciò include la possibilità di consentire o limitare l'accesso alla rete a questo servizio in base alle esigenze della tua applicazione, proprio come faresti con un normale server PostgreSQL.

Passaggi successivi