Datenbankerweiterungen konfigurieren

Wenn Sie Ihren AlloyDB for PostgreSQL-Datenbanken zusätzliche Funktionen wie Vektorsuche, Geodatenindexierung oder Abfrageprüfung hinzufügen möchten, können Sie unterstützte PostgreSQL-Erweiterungen aktivieren, aktualisieren 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, unabhängig davon, ob es sich um die primäre Instanz oder eine Lesepoolinstanz handelt.

Prozedur

  1. Legen Sie bei Bedarf die entsprechenden Datenbank-Flags für die Instanz fest, auf der Sie die Erweiterung verwenden möchten, entweder die primäre Instanz oder eine Lesepoolinstanz.

    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 bei Bedarf 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 Binärdateien für Erweiterungen auf der zugrunde liegenden Software Ihrer Instanz installiert, der Datenbankkatalog der Erweiterung wird jedoch nicht automatisch aktualisiert. Sie sind dafür verantwortlich, Ihre Erweiterungen manuell zu aktualisieren, damit die neuesten unterstützten Versionen verwendet werden.

Wenn Sie herausfinden möchten, welche Erweiterungen aktualisiert werden müssen, vergleichen Sie Ihre installierte Version mit der neuesten unterstützten Version, die in der Referenztabelle für unterstützte Erweiterungen aufgeführt ist.

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 allen anderen Datenbanken herzustellen, in denen die Erweiterung aktiviert ist, und löschen Sie die Erweiterung in jeder dieser Datenbanken.

  4. Wenn für die Erweiterung Datenbank-Flags auf den Instanzen festgelegt werden mussten, auf denen sie verwendet wurde, entfernen Sie die Flags von jeder der Instanzen, auf 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 das sind.