Esegui e connettiti ad AlloyDB Omni

Seleziona una versione della documentazione:

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

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 

docker container start CONTAINER_NAME

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

Podman 

podman container start CONTAINER_NAME

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

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 

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, 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 

  docker container stop CONTAINER_NAME

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

Podman 

  podman container stop CONTAINER_NAME

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

Connettiti ad AlloyDB Omni in esecuzione su un singolo server

Il container AlloyDB Omni include la 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 Connettiti ad AlloyDB Omni in esecuzione su Kubernetes.

Connettiti utilizzando il psql containerizzato

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

Docker 

  docker exec -it CONTAINER_NAME psql -U postgres

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

Podman 

  podman exec -it CONTAINER_NAME psql -U postgres

Sostituisci CONTAINER_NAME con il nome 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 i comandi psql e le query SQL.

Per uscire da psql, esegui il comando \q.

Connettiti utilizzando le tue applicazioni

Qualsiasi applicazione che funziona con PostgreSQL può funzionare anche con AlloyDB Omni, senza alcuna modifica.

Per connetterti al server di database AlloyDB Omni, esponi il networking dal container Docker di AlloyDB Omni alla tua 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. Quindi, 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 tuoi database utilizzando query DML e query SQL tramite protocolli di comunicazione PostgreSQL standard.

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

Passaggi successivi