AlloyDB Omni mit RPM ausführen und eine Verbindung herstellen

Wählen Sie eine Dokumentationsversion aus:

Auf dieser Seite wird beschrieben, wie Sie AlloyDB Omni ausführen und eine Verbindung dazu herstellen, nachdem Sie es auf Ihrem eigenen Computer installiert haben.

Hinweis

Installieren Sie AlloyDB Omni auf Ihrem System.

AlloyDB Omni ausführen

Verwenden Sie die Informationen in den folgenden Abschnitten, um AlloyDB Omni zu starten, den Status zu prüfen und zu beenden.

Optional: SELinux-Richtlinien aktualisieren

Wenn SELinux auf Ihrem System aktiviert ist und Sie bestimmte GUC-Parameter (Grand Unified Configuration) in der Datei postgresql.conf ändern, müssen Sie Ihre SELinux-Richtlinien aktualisieren, bevor Sie den AlloyDB Omni-Dienst starten. Durch das Aktualisieren dieser Richtlinien werden Zugriffsverweigerungen auf Ressourcen verhindert, die dazu führen können, dass der Datenbankserver nicht verfügbar ist oder Vorgänge wie Sicherungen unterbrochen werden.

Zum Ausführen der Befehle semanage und restorecon ist das Paket policycoreutils-python-utils erforderlich.

In der folgenden Tabelle sind die GUC-Parameter aufgeführt, für die SELinux-Richtlinienaktualisierungen erforderlich sind, wenn Sie sie von ihren Standardwerten ändern:

GUC-Parameter Ressourcentyp Auswirkungen, wenn die SELinux-Richtlinie nicht aktualisiert wird Lösung
port Port Der Datenbankserver kann nicht gestartet werden und ist nicht verfügbar. Weisen Sie dem benutzerdefinierten TCP-Port das Label postgresql_port_t zu.
external_pid_file Datei Der Datenbankserver bleibt verfügbar, aber SELinux verweigert den Zugriff, um die externe PID-Datei außerhalb von /var/run/postgresql/ zu erstellen. Weisen Sie dem benutzerdefinierten PID-Dateiverzeichnis das Label postgresql_db_t zu.
unix_socket_directories Datei Der Datenbankserver kann die Socket-Datei nicht erstellen und ist nicht mehr verfügbar. Weisen Sie dem benutzerdefinierten Unix-Socket-Verzeichnis das Label postgresql_db_t zu.
log_directory Datei Der Datenbankserver kann keine Logs schreiben und ist nicht mehr verfügbar. Weisen Sie dem benutzerdefinierten Logverzeichnis das Label postgresql_db_t zu.
archive_command Datei Der Datenbankserver bleibt verfügbar, aber SELinux verweigert den Schreibzugriff auf das Zielverzeichnis, was die Archivierung und Sicherung von Write-Ahead-Logs (WAL) beeinträchtigen kann. Weisen Sie dem benutzerdefinierten Archivverzeichnis das Label postgresql_db_t zu.

SELinux-Richtlinie für einen benutzerdefinierten Port aktualisieren

Wenn Sie den Parameter port in der Datei postgresql.conf ändern, führen Sie die folgenden Befehle aus, damit AlloyDB Omni an den benutzerdefinierten TCP-Port gebunden werden kann:

  1. Fügen Sie dem benutzerdefinierten Port das Label postgresql_port_t hinzu:

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

    Ersetzen Sie PORT_NUMBER durch die benutzerdefinierte TCP-Portnummer, z. B. 5433.

  2. Prüfen Sie, ob die Portrichtlinie aktualisiert wurde:

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

SELinux-Richtlinie für ein benutzerdefiniertes Verzeichnis aktualisieren

Wenn Sie den Parameter external_pid_file, unix_socket_directories, log_directory oder archive_command in der Datei postgresql.conf so ändern, dass ein benutzerdefiniertes Verzeichnis verwendet wird, führen Sie die folgenden Befehle aus, um den postgresql_db_t-Kontext auf dieses Verzeichnis anzuwenden:

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

Ersetzen Sie DIRECTORY_PATH durch den vollständigen Pfad zum benutzerdefinierten PID-Dateiverzeichnis, Unix-Socket-Verzeichnis, Logverzeichnis oder WAL-Archivverzeichnis.

AlloyDB Omni starten

  sudo systemctl start alloydbomni18

Optional: Automatischen Dienstneustart aktivieren

So aktivieren Sie den automatischen Neustart des AlloyDB Omni-Dienstes:

  1. Fügen Sie der /etc/systemd/system/alloydbomni18.service.d/override.conf-Datei die folgende Konfiguration hinzu.

      [Service]
    Restart=on-failure

  2. Laden Sie die systemd-Manager-Konfiguration neu und starten Sie den alloydbomni18-Dienst neu, damit die Änderungen wirksam werden.

    sudo systemctl daemon-reload
sudo systemctl restart alloydbomni18

Status von AlloyDB Omni prüfen

   sudo systemctl status alloydbomni18

AlloyDB Omni beenden

  sudo systemctl stop alloydbomni18

Verbindung zu AlloyDB Omni herstellen

Das AlloyDB Omni-RPM-Paket enthält auch den psql-Client, mit dem Sie eine interaktive SQL-Shell-Sitzung mit dem Datenbankserver öffnen können.

Sie können auch mit der PostgreSQL-kompatiblen Software Ihrer Wahl eine Verbindung zu AlloyDB Omni herstellen.

Verbindung über gebündeltes psql herstellen

  /usr/lib/postgresql/18/bin/psql -h localhost -U postgres

Mit diesem Befehl werden Sie als Nutzer mit der Rolle postgres mit dem Server verbunden und es wird eine postgres=#-Eingabeaufforderung angezeigt. Sie können jetzt psql-Befehle und SQL-Abfragen ausführen.

Führen Sie den Befehl \q aus, um psql zu beenden.

Verbindung über eigene Anwendungen herstellen

Jede Clientanwendung, die mit PostgreSQL funktioniert, kann auch mit AlloyDB Omni verwendet werden, ohne dass Änderungen erforderlich sind.

Sie können jeden PostgreSQL-kompatiblen Client oder jede Codebibliothek verwenden, um eine Verbindung zu AlloyDB Omni herzustellen.

Nachdem Sie eine Verbindung zum Datenbankserver hergestellt haben, können Sie Ihre Datenbanken definieren, abfragen und ändern, indem Sie DML- und SQL-Abfragen über Standard-PostgreSQL-Kommunikationsprotokolle senden.

Da AlloyDB Omni in Ihrer eigenen Umgebung ausgeführt wird, können Sie steuern, wie Sie eine Verbindung zu AlloyDB Omni herstellen. Sie können den Netzwerkzugriff auf AlloyDB Omni entsprechend den Anforderungen Ihrer Anwendung zulassen oder einschränken, genau wie bei einem normalen PostgreSQL-Server.

Nächste Schritte