Einrichten der pglogical-Erweiterung - Amazon Aurora

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Einrichten der pglogical-Erweiterung

Wenn Sie die pglogical-Erweiterung auf Ihrem DB-Cluster von Aurora PostgreSQL einrichten möchten, fügen Sie zunächst pglogical zu den gemeinsam genutzten Bibliotheken in der benutzerdefinierten DB-Cluster-Parametergruppe für Ihren DB-Cluster von Aurora PostgreSQL hinzu. Sie müssen außerdem den Wert des rds.logical_replication-Parameters auf 1 festlegen, um die logische Dekodierung zu aktivieren. Abschließend erstellen Sie die Erweiterung in der Datenbank. Für diese Aufgabe können Sie die AWS-Managementkonsole oder die AWS CLI verwenden.

Sie müssen über Berechtigungen als rds_superuser-Rolle verfügen, um diese Aufgaben ausführen zu können.

Bei den folgenden Schritten wird davon ausgegangen, dass Ihr DB-Cluster von Aurora PostgreSQL einer benutzerdefinierten DB-Cluster -Parametergruppe zugeordnet ist. Weitere Informationen über das Erstellen einer benutzerdefinierten DB-Cluster-Parametergruppe finden Sie unter Parametergruppen für Amazon Aurora.

So richten Sie die pglogical-Erweiterung ein

  1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon-RDS-Konsole unter https://console.aws.amazon.com/rds/.

  2. Wählen Sie im Navigationsbereich Ihre Writer-Instance des DB-Clusters von Aurora PostgreSQL aus.

  3. Öffnen Sie die Registerkarte Configuration (Konfiguration) für Ihre Writer-Instance des DB-Clusters von Aurora PostgreSQL. Suchen Sie in den Instance-Details den Link Parameter group (Parametergruppe).

  4. Wählen Sie den Link aus, um die benutzerdefinierten Parameter zu öffnen, die Ihrem DB-Cluster von Aurora PostgreSQL zugeordnet sind.

  5. Geben Sie in das Suchfeld Parameters (Parameter) shared_pre ein, um den shared_preload_libraries-Parameter zu finden.

  6. Wählen Sie Edit parameters (Parameter bearbeiten) aus, um auf die Eigenschaftswerte zuzugreifen.

  7. Fügen Sie pglogical der Liste im Feld Values (Werte) hinzu. Verwenden Sie ein Komma, um Elemente in der Werteliste zu trennen.

    Bild des shared_preload_libraries-Parameters mit hinzugefügter pglogical-Erweiterung.

  8. Suchen Sie den rds.logical_replication-Parameter und legen Sie ihn auf 1 fest, um die logische Replikation zu aktivieren.

  9. Starten Sie die Writer-Instance Ihres DB-Clusters von Aurora PostgreSQL neu, damit Ihre Änderungen wirksam werden.

  10. Wenn die Instance verfügbar ist, können Sie über psql (oder pgAdmin) eine Verbindung mit der Writer-Instance Ihres DB-Clusters von Aurora PostgreSQL herstellen. 

    psql --host=111122223333.aws-region.rds.amazonaws.com --port=5432 --username=postgres --password --dbname=labdb

  11. Führen Sie den folgenden Befehl aus, um zu überprüfen, dass pglogical initialisiert ist.

    SHOW shared_preload_libraries;
shared_preload_libraries 
--------------------------
rdsutils,pglogical
(1 row)

  12. Überprüfen Sie die Einstellung, die die logische Dekodierung ermöglicht, wie folgt.

    SHOW wal_level;
wal_level
-----------
 logical
(1 row)

  13. Erstellen Sie die Erweiterung wie folgt.

    CREATE EXTENSION pglogical;
EXTENSION CREATED

  14. Wählen Sie Änderungen speichern aus.

  15. Öffnen Sie die Amazon-RDS-Konsole unter https://console.aws.amazon.com/rds/.

  16. Wählen Sie aus der Liste der Datenbanken Ihre Writer-Instance des DB-Clusters von Aurora PostgreSQL und dann im Menü „Actions“ (Aktionen) die Option Reboot (Neustart) aus.

So richten Sie die pglogical-Erweiterung ein

Wenn Sie pglogical mit der AWS CLI einrichten möchten, rufen Sie die Operation modify-db-parameter-group auf, um bestimmte Parameter in Ihrer benutzerdefinierten Parametergruppe zu ändern, wie in den folgenden Schritten gezeigt.

  1. Verwenden Sie den folgenden AWS CLI-Befehl, um dem shared_preload_libraries-Parameter pglogical hinzuzufügen.

    aws rds modify-db-parameter-group \
   --db-parameter-group-name custom-param-group-name \
   --parameters "ParameterName=shared_preload_libraries,ParameterValue=pglogical,ApplyMethod=pending-reboot" \
   --region aws-region

  2. Verwenden Sie den folgenden AWS CLI-Befehl, um rds.logical_replication auf 1 festzulegen und die logische Dekodierungsfunktion für die Writer-Instance des DB-Clusters von Aurora PostgreSQL zu aktivieren. 

    aws rds modify-db-parameter-group \
   --db-parameter-group-name custom-param-group-name \
   --parameters "ParameterName=rds.logical_replication,ParameterValue=1,ApplyMethod=pending-reboot" \
   --region aws-region

  3. Verwenden Sie den folgenden AWS CLI-Befehl, um die Writer-Instance Ihres DB-Clusters von Aurora PostgreSQL neu zu starten, sodass die pglogical-Bibliothek initialisiert wird.

    aws rds reboot-db-instance \
    --db-instance-identifier writer-instance \
    --region aws-region

  4. Wenn die Instance verfügbar ist, stellen Sie über psql eine Verbindung mit der Writer-Instance Ihres DB-Clusters von Aurora PostgreSQL her. 

    psql --host=111122223333.aws-region.rds.amazonaws.com --port=5432 --username=postgres --password --dbname=labdb

  5. Erstellen Sie die Erweiterung wie folgt.

    CREATE EXTENSION pglogical;
EXTENSION CREATED

  6. Starten Sie die Writer-Instance Ihres DB-Clusters von Aurora PostgreSQL mit dem folgenden AWS CLI-Befehl neu.

    aws rds reboot-db-instance \
    --db-instance-identifier writer-instance \
    --region aws-region