Esegui e connettiti ad AlloyDB Omni

Seleziona una versione della documentazione:

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

Prima di iniziare

La maggior parte dei comandi in questa pagina utilizza l'interfaccia a riga di comando AlloyDB Omni.

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

Eseguire 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 denominato alloydb-dataplane che viene configurato per l'avvio ogni volta che la macchina viene avviata.

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

Avviare AlloyDB Omni

sudo alloydb database-server start

Per eseguire una connessione di test, consulta Connettersi utilizzando psql in container.

Controllare lo stato di AlloyDB Omni

sudo alloydb database-server status

Arrestare AlloyDB Omni

sudo alloydb database-server stop

Disattivare l'avvio all'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

Connettersi 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 server di database.

Puoi anche connetterti ad AlloyDB Omni dall'esterno del container utilizzando il software compatibile con PostgreSQL di tua scelta.

Connettersi utilizzando psql in container

Per connetterti al server di database AlloyDB Omni utilizzando la propria copia di psql in container, esegui il seguente comando:

Server singolo 

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

Questo comando ti connette al server come ruolo utente postgres e visualizza un prompt dei comandi postgres=#. Ora puoi eseguire psql comandi 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 è in esecuzione.

Dopo aver eseguito la connessione al server di database, puoi definire, eseguire query e modificare i 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