Esegui e connettiti ad AlloyDB Omni

Seleziona una versione della documentazione:

Questa pagina descrive come eseguire AlloyDB Omni e connetterti ad AlloyDB Omni dopo averlo installato sul tuo computer.

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.

Avviare AlloyDB Omni

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

Docker 

docker container start CONTAINER_NAME

Sostituisci CONTAINER_NAME con il nome che hai assegnato al container AlloyDB Omni durante l'installazione.

Podman 

podman container start CONTAINER_NAME

Sostituisci CONTAINER_NAME con il nome che hai assegnato al container AlloyDB Omni durante l'installazione.

Controllare lo stato di AlloyDB Omni

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

Docker 

docker container ls

Podman 

podman container ls

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

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

Arrestare AlloyDB Omni

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

Docker 

  docker container stop CONTAINER_NAME

Sostituisci CONTAINER_NAME con il nome che hai assegnato al container AlloyDB Omni durante l'installazione.

Podman 

  podman container stop CONTAINER_NAME

Sostituisci CONTAINER_NAME con il nome che hai assegnato al container AlloyDB Omni durante l'installazione.

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.

Per informazioni su come connetterti a un cluster di database AlloyDB Omni in esecuzione su un cluster Kubernetes, consulta Connettersi ad AlloyDB Omni in esecuzione su Kubernetes.

Connettersi utilizzando psql in container

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

Docker 

  docker exec -it CONTAINER_NAME psql -U postgres

Sostituisci CONTAINER_NAME con il nome che hai assegnato al container AlloyDB Omni durante l'installazione.

Podman 

  podman exec -it CONTAINER_NAME psql -U postgres

Sostituisci CONTAINER_NAME con il nome che hai assegnato al container AlloyDB Omni durante l'installazione.

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 modifiche.

Per connetterti al server di database AlloyDB Omni, esponi la rete dal container Docker 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 eseguito la connessione al server di database, puoi definire, eseguire query e modificare i database utilizzando query DML e SQL tramite 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