Datenbankerweiterungen konfigurieren

Auf dieser Seite wird beschrieben, wie Sie PostgreSQL-Erweiterungen in AlloyDB aktivieren und deaktivieren.

Eine Liste der von AlloyDB unterstützten Erweiterungen finden Sie unter Unterstützte Datenbankerweiterungen.

Erweiterung aktivieren

Im Allgemeinen aktivieren Sie eine Erweiterung, indem Sie eine Verbindung zu einer Datenbank in der primären Instanz eines AlloyDB-Clusters herstellen und einen LOAD- oder CREATE EXTENSION-Befehl eingeben.

Bei einigen Erweiterungen müssen Sie jedoch ein oder mehrere Datenbank-Flags festlegen, bevor Sie die Erweiterung mit dem Befehl LOAD oder CREATE EXTENSION aktivieren können. Sie legen diese Flags für die AlloyDB-Instanz fest, für die Sie die Erweiterung verwenden möchten. Das kann die primäre Instanz oder die Instanz des Lesepools sein.

Prozedur

  1. Legen Sie bei Bedarf die entsprechenden Datenbankflags für die Instanz fest, auf der Sie die Erweiterung verwenden möchten. Das kann die primäre Instanz oder eine Lesepoolinstanz sein.

    In der Liste der unterstützten Erweiterungen sehen Sie, für welche Erweiterungen dieser Schritt erforderlich ist und welche Datenbank-Flags Sie festlegen müssen.

  2. Stellen Sie eine Verbindung von einem psql-Client zur primären Instanz des Clusters her, wie unter psql-Client mit einer Instanz verbinden beschrieben.

  3. Stellen Sie über die Eingabeaufforderung psql eine Verbindung zur Datenbank her und erstellen Sie die Erweiterung: 
    \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
  4. Wiederholen Sie den vorherigen Schritt, um eine Verbindung zu anderen Datenbanken herzustellen und die Erweiterung in jeder von ihnen zu erstellen.

Erweiterung aktualisieren

Bei AlloyDB-Wartungsupdates werden zwar automatisch die neuesten Erweiterungs-Binärdateien auf der zugrunde liegenden Software Ihrer Instanz installiert, aber der Datenbankkatalog der Erweiterung wird nicht automatisch aktualisiert. Sie sind dafür verantwortlich, Ihre Erweiterungen manuell zu aktualisieren, damit sie die neuesten unterstützten Versionen verwenden.

Um herauszufinden, welche Erweiterungen aktualisiert werden müssen, vergleichen Sie die installierte Version mit der neuesten unterstützten Version in der Referenztabelle für unterstützte Erweiterungen.

Stellen Sie eine Verbindung zu Ihrer Datenbank her und führen Sie den folgenden Befehl aus, um die installierten Versionen aufzurufen:

SELECT * FROM pg_extension;

Verwenden Sie den Befehl ALTER EXTENSION, um eine Erweiterung auf die neueste auf Ihrer Instanz verfügbare Version zu aktualisieren.

Stellen Sie mit einem Client Ihrer Wahl, z. B. AlloyDB Studio oder einem psql-Client, eine Verbindung zur primären Instanz des Clusters her und führen Sie den folgenden Befehl für jede Erweiterung aus, die Sie aktualisieren möchten:

ALTER EXTENSION EXTENSION_NAME UPDATE;

Wenn Sie auf eine bestimmte Version aktualisieren müssen, verwenden Sie die folgende Syntax:

ALTER EXTENSION EXTENSION_NAME UPDATE TO 'VERSION_NUMBER';

Erweiterung deaktivieren

Sie deaktivieren eine Erweiterung, indem Sie die Schritte zum Aktivieren rückgängig machen.

  1. Stellen Sie eine Verbindung von einem psql-Client zur primären Instanz des Clusters her, wie unter psql-Client mit einer Instanz verbinden beschrieben.

  2. Stellen Sie über die Eingabeaufforderung psql eine Verbindung zur Datenbank her, in der die Erweiterung aktiviert ist, und löschen Sie die Erweiterung: 
    \c DB_NAME
DROP EXTENSION EXTENSION_NAME;
  3. Wiederholen Sie den vorherigen Schritt, um eine Verbindung zu anderen Datenbanken herzustellen, in denen die Erweiterung aktiviert ist, und löschen Sie die Erweiterung in jeder von ihnen.

  4. Wenn für die Erweiterung Datenbank-Flags für die Instanzen festgelegt werden mussten, in denen sie verwendet wurde, entfernen Sie die Flags aus jeder der Instanzen, in denen sie verwendet wurde. Folgen Sie dazu der Anleitung unter Datenbank-Flags einer Instanz konfigurieren.

    In der Liste der unterstützten Erweiterungen sehen Sie, für welche Erweiterungen Datenbank-Flags festgelegt werden müssen und welche Flags erforderlich sind.