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.

Hinweise

• Für das von Ihnen verwendete Google Cloud-Projekt muss der Zugriff auf AlloyDB aktiviert sein.
• Sie benötigen eine der folgenden IAM-Rollen im verwendeten Google Cloud-Projekt:
  • roles/alloydb.admin (die vordefinierte IAM-Rolle „AlloyDB Admin“)
  • roles/owner (die einfache IAM-Rolle „Inhaber“)
  • roles/editor (einfache IAM-Rolle „Bearbeiter“)

  Wenn Sie keine dieser Rollen haben, wenden Sie sich an den Administrator Ihrer Organisation, um Zugriff anzufordern.

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 mindestens ein Datenbankflag festlegen, bevor Sie die Erweiterung mit dem Befehl LOAD oder CREATE EXTENSION aktivieren können. Sie legen diese Flags in der AlloyDB-Instanz fest, in der Sie die Erweiterung verwenden möchten, unabhängig davon, ob es sich um die primäre Instanz oder die Lesereplikatinstanz handelt.

Prozedur

1. Legen Sie gegebenenfalls die entsprechenden Datenbankflaggen für die Instanz fest, in der Sie die Erweiterung verwenden möchten, entweder für die primäre Instanz oder für eine Leserpoolinstanz.

   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 Verbindung eines psql-Clients mit einer Instanz herstellen beschrieben.

   Hinweis: Sie müssen eine Verbindung zur primären Instanz herstellen, auch wenn Sie die Erweiterung auf einer Instanz des Lesepools aktivieren.
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;

   Hinweis: Verwenden Sie den Befehl „LOAD“, um die Erweiterung auto_explain zu erstellen.
4. Wiederholen Sie bei Bedarf den vorherigen Schritt, um eine Verbindung zu anderen Datenbanken herzustellen und die Erweiterung in jeder Datenbank zu erstellen.

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 Verbindung eines psql-Clients mit einer Instanz herstellen beschrieben.

   Hinweis:Sie müssen eine Verbindung zur primären Instanz herstellen, auch wenn Sie eine Erweiterung deaktivieren, die nur auf Lesepoolinstanzen verwendet wird.
2. Stellen Sie über die Eingabeaufforderung psql eine Verbindung zur Datenbank her, in der die Erweiterung aktiviert ist, und legen Sie die Erweiterung ab:

   \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 fügen Sie die Erweiterung in jede Datenbank ein.

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