Leistung einer AlloyDB-Instanz mit pgbench analysieren

In dieser Anleitung integrieren Sie eine AlloyDB-Instanz und eine Compute Engine-VM-Instanz in einem VPC-Netzwerk (Virtual Private Cloud). Anschließend prüfen Sie die Integration, indem Sie pgbench auf der Compute Engine-VM-Instanz installieren und dieses Benchmark-Tool verwenden, um Leistungstests für die AlloyDB-Instanz durchzuführen.

Hinweis: Sie können pgbench verwenden, um grundlegende Leistungstests mit AlloyDB auszuführen. Informationen zu OLTP-Benchmarks (Online Transaction Processing) finden Sie jedoch in den Tools und der Methodik, die im AlloyDB Transactional (OLTP) Benchmarking Guide beschrieben sind.

Ziele

In dieser Anleitung erfahren Sie mehr über die folgenden Themen:

• Erstellen eines VPC-Netzwerk für Ihre AlloyDB-Instanz und Ihre Compute Engine-VM-Instanz, damit die Kommunikation zwischen der Instanz und der VM sicher erfolgen kann
• Erstellen einer AlloyDB-Instanz und einer Compute Engine-VM-Instanz sowie Zuweisen und Konfigurieren Ihres VPC-Netzwerk für beide Instanzen
• Installieren von pgbench auf der Compute Engine-VM-Instanz, Ausführen des Tools für die AlloyDB-Instanz und Verwenden des Tools zum Durchführen von Leistungstests für die AlloyDB-Instanz

Kosten

In dieser Anleitung werden kostenpflichtige Komponenten von Google Cloudverwendet, darunter VPC-Netzwerk, AlloyDB und Compute Engine. Sie können mithilfe des Preisrechners eine Kostenschätzung für Ihre voraussichtliche Nutzung erstellen.

Hinweis

1. Wählen Sie in der Google Cloud Console auf der Seite für die Projektauswahl ein Projekt von aus oder erstellen Sie ein Google Cloud es.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Rufen Sie die Seite zur Projektauswahl auf.

2. Die Abrechnung für Ihr Google Cloud Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.

3. Aktivieren Sie die VPC-Netzwerk-, AlloyDB- und Compute Engine APIs.

   APIs aktivieren

4. Achten Sie darauf, dass Ihrem Nutzerkonto die Rolle „AlloyDB-Administrator“ zugewiesen ist.

   Zur IAM-Seite

VPC-Netzwerk erstellen

In diesem Abschnitt erstellen Sie ein VPC-Netzwerk für Ihre AlloyDB-Instanz und Ihre Compute Engine-VM-Instanz, damit die Kommunikation zwischen der Instanz und der VM sicher erfolgen kann.

1. Rufen Sie in der Google Cloud Console die Seite VPC-Netzwerke auf.

   Zur VPC-Netzwerkseite

2. Klicken Sie auf VPC-Netzwerk erstellen. Die Seite VPC-Netzwerk erstellen wird angezeigt.

3. Geben Sie my-vpc-network für den Namen Ihres VPC-Netzwerk ein.

4. Wählen Sie im Abschnitt Modus für Subnetzerstellung die Option Benutzerdefiniert aus.

5. Klicken Sie auf Subnetz hinzufügen.

6. Geben Sie my-subnet für den Namen Ihres Subnetzes ein.

7. Wählen Sie eine Region aus und geben Sie einen IP-Adressbereich für Ihr Subnetz ein.

8. Klicken Sie auf FERTIG.

9. Klicken Sie auf ERSTELLEN.

Hinweis: Es kann einige Sekunden dauern, bis Ihr VPC-Netzwerk erstellt wurde. Weitere Informationen zu VPC-Netzwerken finden Sie unter VPC-Netzwerk – Übersicht.

AlloyDB-Instanz erstellen

In diesem Abschnitt erstellen Sie eine AlloyDB-Instanz und weisen ihr Ihr VPC-Netzwerk zu und konfigurieren es.

1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

   Zu den Clustern

2. Klicken Sie auf Cluster erstellen.

3. Konfigurieren Sie Ihren Cluster so:

   1. Geben Sie im Abschnitt Allgemeine Informationen im Feld Cluster-ID my-cluster ein.

   2. Geben Sie im Feld Passwort ein beliebiges Passwort ein. Notieren Sie sich dieses Passwort, da Sie es später in dieser Anleitung noch einmal verwenden.

   3. Wählen Sie im Abschnitt Standort im Feld Region die Option us-central1 (Iowa) aus.

   4. Behalten Sie im Feld Datenbankversion den Standardwert bei.

   5. Wählen Sie im Menü Netzwerk die Option my-vpc-network aus. Sie haben dieses VPC-Netzwerk unter VPC-Netzwerk erstellen erstellt.

   6. Da der private Dienstzugriff für Ihr VPC-Netzwerk noch nicht initialisiert wurde, klicken Sie auf Verbindung einrichten.

      Hinweis: Eine private Dienstverbindung ermöglicht Ihrer AlloyDB-Instanz und der Compute Engine-VM, die Sie erstellen, ausschließlich über interne IP-Adressen zu kommunizieren.

   7. Gehen Sie im Bereich Private Dienstverbindung erstellen so vor:

      1. Wählen Sie die Option Automatisch zugewiesenen IP-Bereich verwenden aus, um einen automatisch zugewiesenen IP-Bereich in Ihrem Netzwerk auszuwählen. Google Cloud

      2. Klicken Sie auf Weiter.

      3. Klicken Sie auf Verbindung erstellen.

      Hinweis: Es kann einige Sekunden dauern, bis Ihre private Dienstverbindung erstellt wurde. Danach wird der Bereich Private Dienstverbindung erstellen ausgeblendet und die Statusmeldung Private Dienstverbindung für Netzwerk [VPC-network-name] wurde erfolgreich erstellt wird angezeigt.

4. Konfigurieren Sie Ihre primäre Instanz so:

   1. Geben Sie im Feld Instanz-ID eine ID für Ihre primäre Instanz ein.

   2. Wählen Sie unter Zonale Verfügbarkeit eine der folgenden Optionen aus:

      1. Wenn Sie eine hochverfügbare Produktionsinstanz mit automatischem Failover erstellen möchten, wählen Sie Mehrere Zonen (Hochverfügbarkeit) aus.

      2. Wenn Sie eine einfache Instanz erstellen möchten, die nicht hochverfügbar sein muss, wählen Sie Einzelne Zone aus.

   3. Wählen Sie einen Maschinentyp aus.

5. Klicken Sie auf Cluster erstellen , um den Cluster und die primäre Instanz gleichzeitig zu erstellen.

   **Hinweis**: Es kann einige Minuten dauern, bis Ihre AlloyDB-Instanz erstellt wurde.

6. Notieren Sie sich die private IP-Adresse Ihrer AlloyDB-Instanz, die auf der Seite AlloyDB-Instanzen angezeigt wird. Sie benötigen diese Adresse, um die Integration zwischen der AlloyDB-Instanz und der Compute Engine-VM-Instanz zu prüfen.

Eine Compute Engine-VM-Instanz erstellen

In diesem Abschnitt erstellen Sie eine Compute Engine-VM-Instanz und weisen ihr Ihr VPC-Netzwerk zu und konfigurieren es.

1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

   Zur Seite „VM-Instanzen"

2. Klicken Sie auf Instanz erstellen.

3. Geben Sie im Feld Name auf der Seite Instanz erstellen eine eindeutige ID für die Compute Engine-VM-Instanz ein, die Sie erstellen. Geben Sie für diese Anleitung my-compute-engine-vm-instance in das Feld ein.

4. Wählen Sie im Bereich Zugriffsbereiche auf der Seite die Option Uneingeschränkten Zugriff auf alle Cloud APIs zulassen aus.

5. Maximieren Sie Erweiterte Optionen und führen Sie die folgenden Schritte aus:

   1. Klicken Sie auf den Untertab Netzwerk.

   2. Klicken Sie auf Netzwerkschnittstelle hinzufügen.

   3. Wählen Sie im Menü Netzwerk die Option my-vpc-network aus. Sie haben dieses VPC-Netzwerk unter VPC-Netzwerk erstellen erstellt.

   4. Klicken Sie auf Fertig. Im Bereich Netzwerkschnittstellen auf der Seite werden zwei VPC-Netzwerke angezeigt: default und my-vpc-network.

6. Klicken Sie auf Löschen , um das VPC-Netzwerk default zu löschen.

   Wenn Sie das VPC-Netzwerk default löschen, wird Ihre Compute Engine-VM-Instanz gezwungen, das VPC-Netzwerk zu verwenden, das Sie in dieser Anleitung erstellt haben.

7. Klicken Sie auf Erstellen.

   Es kann einige Sekunden dauern, bis Ihre Compute Engine-VM-Instanz erstellt wurde. Danach wird die Instanz auf der Seite VM-Instanzen angezeigt und der Status dieser Instanz ist Wird ausgeführt (angezeigt durch das Häkchen).

Integration prüfen

In diesem Abschnitt installieren Sie pgbench auf der Compute Engine-VM-Instanz, führen es für die AlloyDB-Instanz aus und verwenden es, um Leistungstests für die AlloyDB-Instanz durchzuführen.

1. Stellen Sie eine Verbindung zu Ihrer Compute Engine-VM-Instanz her. Klicken Sie dazu rechts neben Ihrer VM-Instanz auf das Menü SSH und wählen Sie dann Im Browserfenster öffnen aus.

2. Installieren Sie das Paket „Contributed Extensions and Additions to PostgreSQL“ auf Ihrer Compute Engine-VM-Instanz.

   sudo apt-get -y install postgresql-contrib

3. Initialisieren Sie eine Datenbank für pgbench in Ihrer AlloyDB for PostgreSQL-Instanz. Verwenden Sie beispielsweise die Standarddatenbank postgres:

   pgbench -i --host=INSTANCE_PRIVATE_IP --port=PORT_NUMBER --username=USERNAME

   Ersetzen Sie Folgendes:

   • INSTANCE_PRIVATE_IP: Die private IP-Adresse Ihrer AlloyDB-Instanz. Sie haben sich diese IP-Adresse notiert, als Sie die Instanz erstellt haben.
   • PORT_NUMBER: Die Portnummer, die für Ihre AlloyDB-Instanz reserviert ist. Für diese Anleitung ist die Portnummer 5432.
   • USERNAME: Der Administratornutzername für Ihre AlloyDB-Instanz. Für diese Anleitung ist der Nutzername postgres.

4. Geben Sie bei der Eingabeaufforderung Password das Passwort für Ihre AlloyDB-Instanz ein. Als Sie die Instanz erstellt haben, haben Sie entweder ein Passwort dafür angegeben oder AlloyDB ein Passwort für Sie generieren lassen.

5. Führen Sie pgbench ohne Argumente aus, um grundlegende Funktionen zu prüfen.

   pgbench --host=INSTANCE_PRIVATE_IP --port=PORT_NUMBER --username=USERNAME

6. Geben Sie bei der Eingabeaufforderung Password das Passwort für Ihre AlloyDB-Instanz ein.

   Die Ausgabe sollte in etwa so aussehen:

   starting vacuum...end.
   transaction type: <builtin: TPC-B (sort of)>
   scaling factor: 1
   query mode: simple
   number of clients: 1
   number of threads: 1
   number of transactions per client: 10
   number of transactions actually processed: 10/10
   latency average = 3.794 ms
   tps = 263.560171 (including connections establishing)
   tps = 345.375423 (excluding connections establishing)

7. Verwenden Sie einige Optionen, um einen nützlichen Test zu erstellen. Einige wichtige Optionen sind -c (die Anzahl der Clients) und --transactions (die Anzahl der Transaktionen pro Client).

   Führen Sie für diese Anleitung einen Leistungstest mit 10 Clients durch, die auf Ihre AlloyDB for PostgreSQL-Datenbank zugreifen, und 100 Transaktionen für jeden Client.

   pgbench --host=INSTANCE_PRIVATE_IP --port=PORT_NUMBER --username=USERNAME -c 10 --transactions=100

8. Geben Sie bei der Eingabeaufforderung Password das Passwort für Ihre AlloyDB-Instanz ein.

   Die Ausgabe sollte in etwa so aussehen:

   starting vacuum...end.
   transaction type:  TPC-B (sort of)>
   scaling factor: 1
   query mode: simple
   number of clients: 10
   number of threads: 1
   number of transactions per client: 100
   number of transactions actually processed: 1000/1000
   latency average = 36.421 ms
   tps = 274.563444 (including connections establishing)
   tps = 275.733225 (excluding connections establishing)

Bereinigen

Nachdem Sie diese Anleitung abgeschlossen haben, können Sie die Ressourcen bereinigen, die Sie erstellt haben. Damit verhindern Sie, dass Ihr Kontingent unnötig in Anspruch genommen wird und dass Ihnen die Ressourcen in Zukunft in Rechnung gestellt werden.

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

1. Löschen Sie mit der Google Cloud Console Ihr Projekt, Ihre AlloyDB-Instanz, Ihre Compute Engine-VM-Instanz und Ihr VPC-Netzwerk.

In den folgenden Abschnitten wird erläutert, wie Sie diese Ressourcen löschen oder deaktivieren.

Projekt löschen

Am einfachsten vermeiden Sie weitere Kosten durch Löschen des für diese Anleitung erstellten Projekts.

Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für diese Anleitung ein bereits bestehendes Projekt verwendet haben, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, wenn Sie Projekte wiederverwenden.

1. Rufen Sie in der Google Cloud Console die Seite Ressourcen verwalten auf.

   Zur Seite „Ressourcen verwalten"

2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie auf Löschen.

3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Herunterfahren , um das Projekt zu löschen.

AlloyDB-Instanz löschen

1. Rufen Sie in der Google Cloud Console die Seite AlloyDB-Cluster auf.

   Zur Seite „AlloyDB-Cluster"

2. Klicken Sie auf den Namen Ihrer AlloyDB-Instanz. Klicken Sie für diese Anleitung auf my-instance.

3. Klicken Sie auf LÖSCHEN.

4. Geben Sie im Dialogfeld den Namen Ihrer AlloyDB-Instanz in das Textfeld ein und klicken Sie dann auf LÖSCHEN.

Compute Engine-VM-Instanz löschen

1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

   Zur Seite „VM-Instanzen"

2. Klicken Sie auf den Namen Ihrer Compute Engine-VM-Instanz. Klicken Sie für diese Anleitung auf my-compute-engine-vm-instance.

3. Klicken Sie auf das Symbol Löschen. Dieses Symbol sieht wie ein Papierkorb aus.

4. Klicken Sie im Dialogfeld auf LÖSCHEN.

   **Hinweis**: Es kann einige Sekunden dauern, bis Ihre Compute Engine-VM-Instanz gelöscht wurde.

VPC-Netzwerk löschen

1. Rufen Sie in der Google Cloud Console die Seite VPC-Netzwerke auf.

   Zur VPC-Netzwerkseite

2. Klicken Sie auf den Namen Ihres VPC-Netzwerk. Klicken Sie für diese Anleitung auf my-vpc-network.

3. Klicken Sie auf VPC-NETZWERK LÖSCHEN.

4. Klicken Sie im Dialogfeld auf LÖSCHEN.