Esegui e connettiti ad AlloyDB Omni utilizzando RPM

Seleziona una versione della documentazione:

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

Prima di iniziare

Installa AlloyDB Omni sul tuo sistema.

Esegui AlloyDB Omni

Utilizza le informazioni riportate nelle sezioni seguenti per avviare, controllare lo stato e arrestare AlloyDB Omni.

(Facoltativo) Aggiorna le policy SELinux

Se SELinux è abilitato sul tuo sistema e modifichi determinati parametri GUC (Grand Unified Configuration) nel file postgresql.conf, devi aggiornare le policy SELinux prima di avviare il servizio AlloyDB Omni. L'aggiornamento di queste policy impedisce i rifiuti di accesso alle risorse che possono rendere il server del database non disponibile o interrompere operazioni come i backup.

Per eseguire i comandi semanage e restorecon è necessario il pacchetto policycoreutils-python-utils.

La tabella seguente elenca i parametri GUC che richiedono aggiornamenti delle policy SELinux quando li modifichi rispetto ai valori predefiniti:

Parametro GUC Tipo di risorsa Impatto se la policy SELinux non viene aggiornata Risoluzione
port Porta Il server del database non si avvia e diventa non disponibile. Assegna l'etichetta postgresql_port_t alla porta TCP personalizzata.
external_pid_file File Il server di database rimane disponibile, ma SELinux nega l'accesso per creare il file PID esterno al di fuori di /var/run/postgresql/. Assegna l'etichetta postgresql_db_t alla directory dei file PID personalizzata.
unix_socket_directories File Il server di database non riesce a creare il file socket e diventa non disponibile. Assegna l'etichetta postgresql_db_t alla directory personalizzata dei socket Unix.
log_directory File Il server di database non riesce a scrivere i log e diventa non disponibile. Assegna l'etichetta postgresql_db_t alla directory dei log personalizzati.
archive_command File Il server di database rimane disponibile, ma SELinux nega l'accesso in scrittura alla directory di destinazione, il che può interrompere l'archiviazione e i backup del write-ahead log (WAL). Assegna l'etichetta postgresql_db_t alla directory di archiviazione personalizzata.

Aggiorna la policy SELinux per una porta personalizzata

Se modifichi il parametro port nel file postgresql.conf, esegui i seguenti comandi per consentire ad AlloyDB Omni di eseguire il binding alla porta TCP personalizzata:

  1. Aggiungi l'etichetta postgresql_port_t alla porta personalizzata:

    sudo /usr/sbin/semanage port -a -t postgresql_port_t -p tcp PORT_NUMBER

    Sostituisci PORT_NUMBER con il numero di porta TCP personalizzato, ad esempio 5433.

  2. Verifica che la policy della porta sia aggiornata:

    sudo /usr/sbin/semanage port -l | grep postgresql_port_t

Aggiorna la policy SELinux per una directory personalizzata

Se modifichi il parametro external_pid_file, unix_socket_directories, log_directory o archive_command nel file postgresql.conf per utilizzare una directory personalizzata, esegui i seguenti comandi per applicare il contesto postgresql_db_t a quella directory:

sudo /usr/sbin/semanage fcontext -a -t postgresql_db_t "DIRECTORY_PATH(/.*)?"
sudo /sbin/restorecon -R -F DIRECTORY_PATH

Sostituisci DIRECTORY_PATH con il percorso completo della directory del file PID personalizzato, della directory del socket Unix, della directory dei log o della directory dell'archivio WAL.

Avvia AlloyDB Omni

  sudo systemctl start alloydbomni18

(Facoltativo) Abilita il riavvio automatico del servizio

Per attivare il riavvio automatico del servizio AlloyDB Omni, segui questi passaggi:

  1. Aggiungi la seguente configurazione al file /etc/systemd/system/alloydbomni18.service.d/override.conf.

      [Service]
    Restart=on-failure

  2. Ricarica la configurazione del gestore systemd e riavvia il servizio alloydbomni18 per applicare le modifiche.

    sudo systemctl daemon-reload
sudo systemctl restart alloydbomni18

Controlla lo stato di AlloyDB Omni

   sudo systemctl status alloydbomni18

Arresta AlloyDB Omni

  sudo systemctl stop alloydbomni18

Connettiti ad AlloyDB Omni

Il pacchetto RPM di AlloyDB Omni include anche il client psql che consente di aprire una sessione di shell SQL interattiva con il server di database.

Puoi anche connetterti ad AlloyDB Omni utilizzando il software compatibile con PostgreSQL che preferisci.

Connettiti utilizzando psql in bundle

  /usr/lib/postgresql/18/bin/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.

Connettiti utilizzando le tue applicazioni

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

Utilizza qualsiasi client o libreria di codice compatibile con PostgreSQL per connetterti ad AlloyDB Omni.

Dopo aver eseguito la connessione al server di database, puoi definire, eseguire query e modificare i database inviando query DML e query SQL tramite protocolli di comunicazione PostgreSQL standard.

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

Passaggi successivi