Esegui e connettiti ad AlloyDB Omni

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

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.

Avvia AlloyDB Omni

Per avviare un container AlloyDB Omni arrestato, esegui il comando docker container start o il comando podman container start:

docker container start CONTAINER_NAME

podman container start CONTAINER_NAME

Controlla lo stato di AlloyDB Omni

Per controllare lo stato di tutti i container in esecuzione, esegui il comando docker container ls o il comando podman container ls:

docker container ls

podman container ls

Se il contenitore AlloyDB Omni è in esecuzione, il suo nome verrà visualizzato nella colonna NAMES della tabella di output. La riga corrispondente riepiloga lo stato del container.

Se il nome del tuo container non viene visualizzato nella colonna NAMES, significa che AlloyDB Omni non è in esecuzione.

Arresta AlloyDB Omni

Per arrestare un container AlloyDB Omni, esegui il comando docker container stop o il comando podman container stop:

  docker container stop CONTAINER_NAME

  podman container stop CONTAINER_NAME

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.

Per informazioni sulla connessione a un cluster di database AlloyDB Omni in esecuzione su un cluster Kubernetes, consulta Connessione ad AlloyDB Omni in esecuzione su Kubernetes.

Connettiti utilizzando psql in container

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

  docker exec -it CONTAINER_NAME psql -U postgres

  podman exec -it CONTAINER_NAME psql -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, esponi il networking dal container Docker di AlloyDB Omni alla macchina host aggiungendo --network=host o -p 5432:5432 al comando docker run o podman run quando avvii AlloyDB Omni.

Per selezionare un numero di porta personalizzato, utilizza -p [HOST_PORT]:5432 quando avvii AlloyDB Omni. Poi, utilizza qualsiasi client o libreria di codice compatibile con PostgreSQL per connetterti alla porta 5432 o al numero di porta personalizzato che hai specificato.

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

• Gestire e monitorare AlloyDB Omni