Lesepools erstellen und verwalten

Auf dieser Seite wird beschrieben, wie Sie Lesepools für Ihre großen Lese-Arbeitslasten erstellen und verwalten.

Hinweise

  1. Lesepools enthalten Kopien einer primären Instanz. Falls noch nicht geschehen, erstellen Sie eine primäre Instanz der Cloud SQL Enterprise Plus-Version. Lesepools unterstützen zwar öffentliche IP-Verbindungen, für diesen Leitfaden erstellen Sie jedoch eine primäre Instanz mit privater IP-Verbindung (Zugriff auf private Dienste). Weitere Informationen zu primären Instanzen und zur Replikation finden Sie unter Replikation in Cloud SQL.
  2. Nachdem die primäre Instanz erstellt wurde, wählen Sie ein Passwort für den Root-Nutzer aus und führen Sie den folgenden Befehl aus, um das Passwort für die primäre Instanz festzulegen. Speichern Sie dieses Passwort, um es später beim Herstellen einer Verbindung zum Lesepool zu verwenden.
    3.     gcloud --project=PROJECT \
    sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME --prompt-for-password

    Ersetzen Sie die folgenden Werte:

    • PROJECT: Der Name des Projekts, in dem sich die primäre Instanz und der Lesepool befinden sollen.
    • PRIMARY_INSTANCE_NAME: Der Name der primären Instanz.

Lesepool erstellen

gcloud

Informationen zur Installation und zu den ersten Schritten mit der gcloud CLI finden Sie unter gcloud CLI installieren. Informationen zum Starten von Cloud Shell finden Sie unter Cloud Shell verwenden.

Verwenden Sie den folgenden gcloud sql instances create-Befehl, um einen Lesepool mit mehreren Lesepoolknoten zu erstellen:

      gcloud sql instances create READ_POOL_NAME \
      --tier=TIER --edition=ENTERPRISE_PLUS \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT \
      --master-instance-name=PRIMARY_INSTANCE_NAME

Ersetzen Sie die folgenden Werte:

  • READ_POOL_NAME: Der Name, den Sie für den Lesepool verwenden möchten.
  • TIER: Der Maschinentyp, den Sie für jeden Knoten im Lesepool verwenden möchten, z. B. db-perf-optimized-N-4.
  • NODE_COUNT: Die Anzahl der Knoten im Lesepool, die Sie im Lesepool haben möchten. Wählen Sie eine beliebige Zahl zwischen 1 und 20 aus.
  • PRIMARY_INSTANCE_NAME: Der Name der primären Instanz, die dem Lesepool zugeordnet ist, z. B. my-primary-instance.

Terraform

Verwenden Sie zum Erstellen eines Lesepools eine Terraform-Ressource. Legen Sie dann das Attribut instance_type auf "READ_POOL_INSTANCE" und das Attribut node_count auf die Anzahl der Knoten fest, die Sie verwenden möchten.

Das folgende Beispiel enthält Ressourcen für die primäre Instanz und den Lesepool. 


resource "google_sql_database_instance" "primary" {
  name             = "postgres-primary"
  database_version = "POSTGRES_17"
  region           = "europe-west4"

  instance_type = "CLOUD_SQL_INSTANCE"

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    backup_configuration {
      enabled = true
    }

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

resource "google_sql_database_instance" "replica" {
  name             = "postgres-replica"
  database_version = "POSTGRES_17"
  region           = "europe-west4"

  master_instance_name = google_sql_database_instance.primary.name
  instance_type        = "READ_POOL_INSTANCE"
  node_count           = 2

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

Änderungen anwenden

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Google Cloud -Projekt anzuwenden.

Cloud Shell vorbereiten

  1. Rufen Sie Cloud Shell auf.

  2. Legen Sie das Standardprojekt Google Cloud fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

    Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).

  1. Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.

    Kopieren Sie den Beispielcode in das neu erstellte main.tf.

    Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.

  3. Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
  4. Speichern Sie die Änderungen.
  5. Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich. 
    terraform init

    Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden: 

    terraform init -upgrade

Änderungen anwenden

  1. Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen: 
    terraform plan

    Korrigieren Sie die Konfiguration nach Bedarf.

  2. Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein: 
    terraform apply

    Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.

  3. Öffnen Sie Ihr Google Cloud Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Google Cloud Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

Änderungen löschen

So löschen Sie das Projekt:

  1. Um den Löschschutz zu deaktivieren, setzen Sie in der Terraform-Konfigurationsdatei das Argument deletion_protection auf false. 
    deletion_protection =  "false"
  2. Wenden Sie die aktualisierte Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein: 
    terraform apply

  1. Entfernen Sie Ressourcen, die zuvor mit Ihrer Terraform-Konfiguration angewendet wurden, indem Sie den folgenden Befehl ausführen und yes an der Eingabeaufforderung eingeben:

    terraform destroy

REST Version 1

Mit der Methode insert der Instanzressource erstellen Sie einen Lesepool mit mehreren Lesepoolknoten. Das Attribut databaseVersion muss mit der primären Instanz übereinstimmen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT: Der Name des Projekts, in dem sich die primäre Instanz und der Lesepool befinden sollen.
  • REGION: die Region für den Lesepool, z. B. us-east1. Die Region muss mit der primären Instanz übereinstimmen.
  • TIER: Der Maschinentyp, den Sie für jeden Knoten im Lesepool verwenden möchten, z. B. db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: Der Name der primären Instanz.
  • READ_POOL_NAME: Der Name, den Sie für den Lesepool verwenden möchten, z. B. my-read-pool.
  • DATABASE_VERSION: Die Datenbankversion, die Sie verwenden möchten. Beispiel: POSTGRES_16.
  • NODE_COUNT: Die Anzahl der Knoten im Lesepool, die Sie im Lesepool haben möchten. Wählen Sie eine beliebige Zahl zwischen 1 und 20 aus.
  • FULL_NETWORK_NAME: Der vollständige Netzwerkpfad, in dem sich der Lesepool befinden soll, z. B. projects/vpc-host-project/global/networks/my-network-name.

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT/instances

JSON-Text anfordern:

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

REST v1beta4

Mit der Methode insert der Instanzressource erstellen Sie einen Lesepool mit mehreren Lesepoolknoten. Das Attribut databaseVersion muss mit der primären Instanz übereinstimmen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT: Der Name des Projekts, in dem sich die primäre Instanz und der Lesepool befinden sollen.
  • REGION: die Region für den Lesepool, z. B. us-east1. Die Region muss mit der primären Instanz übereinstimmen.
  • TIER: Der Maschinentyp, den Sie für jeden Knoten im Lesepool verwenden möchten, z. B. db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: Der Name der primären Instanz.
  • READ_POOL_NAME: Der Name, den Sie für den Lesepool verwenden möchten, z. B. my-read-pool.
  • DATABASE_VERSION: Die Datenbankversion, die Sie verwenden möchten. Beispiel: POSTGRES_16.
  • NODE_COUNT: Die Anzahl der Knoten im Lesepool, die Sie im Lesepool haben möchten. Wählen Sie eine beliebige Zahl zwischen 1 und 20 aus.
  • FULL_NETWORK_NAME: Der vollständige Netzwerkpfad, in dem sich der Lesepool befinden soll, z. B. projects/vpc-host-project/global/networks/my-network-name.

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances

JSON-Text anfordern:

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

Lesereplikat in einen Lesepool konvertieren

Sie können ein vorhandenes Lesereplikat der Cloud SQL Enterprise Plus-Version in einen Lesepool umwandeln, indem Sie die Anzahl der Knoten im Pool angeben. Während dieser Umwandlung wird die Replikat-IP zur IP des Lesepools (dem Leseendpunkt), sodass vorhandene Clients ohne Neukonfiguration eine Verbindung zum Pool herstellen können.

Die neu erstellten Lesepoolknoten haben denselben Maschinentyp und dieselbe Konfiguration wie das ursprüngliche Lesereplikat. Wenn Sie diesen Maschinentyp oder diese Konfiguration ändern möchten, ist ein separater Vorgang erforderlich. Dieser Vorgang wird nur für zonale Lesereplikate unterstützt. Wenn Sie ein Lesereplikat mit hoher Verfügbarkeit in einen Leserpool konvertieren möchten, müssen Sie es zuerst in ein zonales Lesereplikat konvertieren.

Weitere Informationen finden Sie unter Konfiguration des Lesepools bearbeiten.

gcloud

Informationen zur Installation und zu den ersten Schritten mit der gcloud CLI finden Sie unter gcloud CLI installieren. Informationen zum Starten von Cloud Shell finden Sie unter Cloud Shell verwenden.

Verwenden Sie den folgenden gcloud sql instances patch-Befehl, um ein Lesereplikat für die Verwendung mit einem Lesepool zu konvertieren:

      gcloud sql instances patch READ_REPLICA_NAME \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT

Ersetzen Sie die folgenden Werte:

  • READ_REPLICA_NAME: der Name des Lesereplikats, das Sie konvertieren möchten.
  • NODE_COUNT: Die Anzahl der Knoten im Lesepool, die Sie im Lesepool haben möchten. Wählen Sie eine beliebige Zahl zwischen 1 und 20 aus.

Terraform

Verwenden Sie eine Terraform-Ressource, um ein Lesereplikat in einen Lesepool zu konvertieren. Das Manifest ähnelt dem, das Sie in Lesereplikat erstellen verwendet haben. Gehen Sie dann so vor:

  • Ändern Sie das Attribut instance_type von "READ_REPLICA_INSTANCE" in "READ_POOL_INSTANCE" und das Attribut node_count in die Anzahl der Knoten, die Sie verwenden möchten.
  • Wenn Sie es zuvor festgelegt haben, entfernen Sie das Attribut settings.availability_type.

REST Version 1

Mit der Methode patch der Instanzressource können Sie ein Lesereplikat in einen Lesepool konvertieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • READ_REPLICA_NAME: der Name des Lesereplikats, das Sie konvertieren möchten, z. B. my-read-replica.
  • NODE_COUNT: Die Anzahl der Knoten im Lesepool, die Sie im Lesepool haben möchten. Wählen Sie eine beliebige Zahl zwischen 1 und 20 aus.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_REPLICA_NAME

JSON-Text anfordern:

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

REST v1beta4

Mit der Methode patch der Instanzressource können Sie ein Lesereplikat in einen Lesepool konvertieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • READ_REPLICA_NAME: der Name des Lesereplikats, das Sie konvertieren möchten, z. B. my-read-replica.
  • NODE_COUNT: Die Anzahl der Knoten im Lesepool, die Sie im Lesepool haben möchten. Wählen Sie eine beliebige Zahl zwischen 1 und 20 aus.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME

JSON-Text anfordern:

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

Lesepool in ein Lesereplikat konvertieren

gcloud

Informationen zur Installation und zu den ersten Schritten mit der gcloud CLI finden Sie unter gcloud CLI installieren. Informationen zum Starten von Cloud Shell finden Sie unter Cloud Shell verwenden.

Verwenden Sie den folgenden gcloud sql instances patch-Befehl, um ein Lesereplikat für die Verwendung mit einem Lesepool zu konvertieren:

      gcloud sql instances patch READ_POOL_NAME \
      --instance-type=READ_REPLICA_INSTANCE --availability-type=ZONAL

Ersetzen Sie die folgenden Werte:

  • READ_POOL_NAME: der Name des Lesepools, den Sie konvertieren möchten.

Terraform

Verwenden Sie eine Terraform-Ressource, um einen Lesepool in ein Lesereplikat zu konvertieren. Das Manifest ähnelt dem, das Sie unter Lesepool erstellen verwendet haben. Ändern Sie dann das Attribut instance_type von "READ_POOL_INSTANCE" in "READ_REPLICA_INSTANCE", löschen Sie das Attribut node_count und legen Sie das Attribut settings.availability_type auf ZONAL fest.

REST Version 1

Mit der Methode patch der Instanzressource können Sie einen Lesepool in ein Lesereplikat konvertieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • READ_POOL_NAME: Der Name des Lesepools, z. B. my-read-pool.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

JSON-Text anfordern:

{
  "instanceType": "READ_REPLICA_INSTANCE",
  "settings": {
    "availabilityType": "ZONAL"
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

REST v1beta4

Mit der Methode patch der Instanzressource können Sie einen Lesepool in ein Lesereplikat konvertieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • READ_POOL_NAME: Der Name des Lesepools, z. B. my-read-pool.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

JSON-Text anfordern:

{
  "instanceType": "READ_REPLICA_INSTANCE",
  "settings": {
    "availabilityType": "ZONAL"
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

Lesepoolinformationen ansehen

gcloud

Informationen zur Installation und zu den ersten Schritten mit der gcloud CLI finden Sie unter gcloud CLI installieren. Informationen zum Starten von Cloud Shell finden Sie unter Cloud Shell verwenden.

Verwenden Sie den folgenden gcloud sql instances describe-Befehl, um den Lesepool zu beschreiben:

      gcloud sql instances describe READ_POOL_NAME

Ersetzen Sie die folgenden Werte:

  • READ_POOL_NAME: der Name des Lesepools, den Sie beschreiben möchten.

Eine Beispielantwort mit IP-Adresse und Knoteninformationen könnte so aussehen:

      ...
      connectionName: my-project:us-central1:read-pool
      ipAddresses:
      - ipAddress: 10.3.0.108
        type: PRIVATE
      nodeCount: 2
      nodes:
      - dnsName: c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-f
        ipAddresses:
        - ipAddress: 10.3.0.112
          type: PRIVATE
        name: read-pool-node-01
        state: RUNNABLE
      - dnsName: 8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-c
        ipAddresses:
        - ipAddress: 10.3.0.113
          type: PRIVATE
        name: read-pool-node-02
        state: RUNNABLE

REST Version 1

Verwenden Sie die Methode get, um die Details des Lesepools aufzurufen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT: der Name des Projekts, in dem sich der Lesepool befindet.
  • READ_POOL_NAME: Der Name des Lesepools, z. B. my-read-pool.

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

REST v1beta4

Verwenden Sie die Methode get, um die Details des Lesepools aufzurufen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT: der Name des Projekts, in dem sich der Lesepool befindet.
  • READ_POOL_NAME: Der Name des Lesepools, z. B. my-read-pool.

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  [...],
  "connectionName": "my-project:us-central1:read-pool",
  "ipAddresses": [
    {
      "type": "PRIVATE",
      "ipAddress": "10.3.0.108"
    }
  ],
  "nodeCount": 2,
  "nodes": [
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.112"
        }
      ],                                                                                                                 
      "name": "read-pool-node-01",
      "gceZone": "us-central1-f",
      "dnsName": "c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    },
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.113"
        }
      ],
      "name": "read-pool-node-02",
      "gceZone": "us-central1-c",
      "dnsName": "8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    }
  ]
}

Lesepoolknoten hinzufügen oder entfernen

Mit den folgenden Schritten wird ein Lesepool skaliert, indem die Anzahl der Knoten im Lesepool geändert wird. Es gelten einige Einschränkungen. Weitere Informationen finden Sie unter Einschränkungen für Lesevorgänge.

gcloud

Informationen zur Installation und zu den ersten Schritten mit der gcloud CLI finden Sie unter gcloud CLI installieren. Informationen zum Starten von Cloud Shell finden Sie unter Cloud Shell verwenden.

Verwenden Sie den folgenden gcloud sql instances patch-Befehl, um den Lesepool zu skalieren:

      gcloud sql instances patch READ_POOL_NAME \
      --node-count=NODE_COUNT

Ersetzen Sie die folgenden Werte:

  • READ_POOL_NAME: der Name des Lesepools.
  • NODE_COUNT: Die Anzahl der Knoten im Lesepool, die Sie im Lesepool haben möchten. Wählen Sie eine beliebige Zahl zwischen 1 und 20 aus.

Terraform

Wenn Sie die Anzahl der Knoten im Lesepool ändern möchten, aktualisieren Sie eine vorhandene Terraform-Ressource. Das Manifest ähnelt dem, das Sie unter Lesepool erstellen verwendet haben. Ändern Sie dann das Attribut node_count in die Anzahl der Knoten, die Sie verwenden möchten.

REST Version 1

Verwenden Sie die Methode patch, um einen Lesepool zu skalieren, indem Sie die Anzahl der Lesepoolknoten im Lesepool ändern.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT: der Name des Projekts, in dem sich der Lesepool befindet.
  • NODE_COUNT: Die Anzahl der Knoten im Lesepool, die Sie im Lesepool haben möchten. Wählen Sie eine beliebige Zahl zwischen 1 und 20 aus.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

JSON-Text anfordern:

{
  "nodeCount": NODE_COUNT
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

REST v1beta4

Verwenden Sie die Methode patch, um einen Lesepool zu skalieren, indem Sie die Anzahl der Lesepoolknoten im Lesepool ändern.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT: der Name des Projekts, in dem sich der Lesepool befindet.
  • NODE_COUNT: Die Anzahl der Knoten im Lesepool, die Sie im Lesepool haben möchten. Wählen Sie eine beliebige Zahl zwischen 1 und 20 aus.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

JSON-Text anfordern:

{
  "nodeCount": NODE_COUNT
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

Lesepoolkonfiguration bearbeiten

In den folgenden Schritten wird gezeigt, wie Sie die Konfiguration des Lesepools bearbeiten. Weitere Informationen finden Sie unter Instanzeinstellungen und Instanzen bearbeiten.

gcloud

Informationen zur Installation und zu den ersten Schritten mit der gcloud CLI finden Sie unter gcloud CLI installieren. Informationen zum Starten von Cloud Shell finden Sie unter Cloud Shell verwenden.

Verwenden Sie den folgenden gcloud sql instances patch-Befehl, um den Lesepool vertikal zu skalieren, z. B. durch Ändern des Maschinentyps:

      gcloud sql instances patch READ_POOL_NAME \
      --tier=TIER

Ersetzen Sie die folgenden Werte:

  • READ_POOL_NAME: der Name des Lesepools.
  • TIER: Der Maschinentyp, den Sie auf jeden Knoten im Lesepool anwenden möchten, z. B. db-perf-optimized-N-8.

Terraform

Wenn Sie die Konfiguration des Lesepools bearbeiten möchten, aktualisieren Sie eine vorhandene Terraform-Ressource. Das Manifest ähnelt dem, das Sie unter Lesepool erstellen verwendet haben. Aktualisieren Sie dann die Attribute, die Sie ändern möchten, im Feld settings. Ändern Sie beispielsweise das Attribut settings.tier in einen anderen Maschinentyp.

REST Version 1

Verwenden Sie die Methode patch, um die Knotenkonfiguration des Lesepools zu ändern. Die Einstellungen werden einheitlich auf alle Lesepoolknoten im Lesepool angewendet.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT: der Name des Projekts, in dem sich der Lesepool befindet.
  • TIER: Der Maschinentyp, den Sie für jeden Knoten im Lesepool verwenden möchten, z. B. db-perf-optimized-N-4.
  • READ_POOL_NAME: Der Name des Lesepools, z. B. my-read-pool.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

JSON-Text anfordern:

{
  "settings": {
    "tier": "TIER"
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

REST v1beta4

Verwenden Sie die Methode patch, um die Knotenkonfiguration des Lesepools zu ändern. Die Einstellungen werden einheitlich auf alle Lesepoolknoten im Lesepool angewendet.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT: der Name des Projekts, in dem sich der Lesepool befindet.
  • TIER: Der Maschinentyp, den Sie für jeden Knoten im Lesepool verwenden möchten, z. B. db-perf-optimized-N-4.
  • READ_POOL_NAME: Der Name des Lesepools, z. B. my-read-pool.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

JSON-Text anfordern:

{
  "settings": {
    "tier": "TIER"
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

Verbindung zu einem Lesepool herstellen

Es gibt viele Möglichkeiten, eine Verbindung zu einem Lesepool herzustellen. In den folgenden Schritten wird eine Möglichkeit beschrieben, nämlich die Verbindung zu einem Lesepool mit einer privaten IP-Adresse herzustellen, indem eine VM im selben VPC-Netzwerk als Verbindungsquelle erstellt wird.

Weitere Informationen zu anderen Möglichkeiten zum Konfigurieren der Verbindung zu einer Cloud SQL-Instanz finden Sie unter Cloud SQL-Verbindungen. Für die Verbindungsmethoden müssen Sie in der Regel zuerst die IP-Adresse oder den Verbindungsnamen der Instanz abrufen, wie unter Informationen zum Lesepool ansehen beschrieben. Lesepools unterstützen die meisten Verbindungsmethoden, die für andere Cloud SQL-Instanzen verfügbar sind, mit einigen Einschränkungen.

Wenn Sie eine Verbindung über den Cloud SQL Auth-Proxy oder die Cloud SQL-Connectors herstellen, müssen Sie auf die neueste Version aktualisieren. Für die Unterstützung von Lesepools sind mindestens die folgenden Versionen erforderlich:

  • Cloud SQL Auth-Proxy: v2.15.2
  • Cloud SQL Python-Connector: v1.18.0
  • Cloud SQL Go-Connector: v1.16.0
  • Cloud SQL Node Connector: v1.7.0
  • Cloud SQL-Java-Connector: v1.24.0

Konsole

So stellen Sie eine Verbindung zu einem Lesepool her:

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

    Sie werden zur Seite "Instanzübersicht" weitergeleitet. Klicken Sie auf den neuen Lesepool, um die Details einschließlich der privaten IP-Adresse aufzurufen. Kopieren Sie im Abschnitt Mit dieser Instanz verbinden den Verbindungsnamen der Instanz und speichern Sie ihn. Der connection name hat das Format projectID:region:instanceID. Sie benötigen diesen connection name später beim Starten des Cloud SQL Auth-Proxys.
  2. Erstellen Sie eine Compute Engine-VM.
  3. Öffnen Sie zwei SSH-Verbindungen zur Compute Engine-VM. Sie werden in den folgenden Schritten verwendet, um den Cloud SQL Auth-Proxy und den Datenbankclient auszuführen.
  4. Client installieren
  5. Installieren Sie den Cloud SQL Auth-Proxy.
  6. Starten Sie den Cloud SQL Auth-Proxy.
  7. Verbindung zur Cloud SQL-Instanz herstellen

Weitere Informationen finden Sie unter Verbindung zu einer Cloud SQL-Instanz mit privater IP-Adresse herstellen.

Lesepool löschen

gcloud

Informationen zur Installation und zu den ersten Schritten mit der gcloud CLI finden Sie unter gcloud CLI installieren. Informationen zum Starten von Cloud Shell finden Sie unter Cloud Shell verwenden.

Verwenden Sie den folgenden gcloud sql instances delete-Befehl, um einen Lesepool zu löschen:

      gcloud sql instances delete READ_POOL_NAME

Ersetzen Sie die folgenden Werte:

  • READ_POOL_NAME: der Name des Lesepools, den Sie löschen möchten.

REST Version 1

Verwenden Sie die Methode delete, um einen Lesepool zu löschen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT: der Name des Projekts, in dem sich der Lesepool befindet.
  • READ_POOL_NAME: Der Name des Lesepools, z. B. my-read-pool.

HTTP-Methode und URL:

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

REST v1beta4

Verwenden Sie die Methode delete, um einen Lesepool zu löschen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT: der Name des Projekts, in dem sich der Lesepool befindet.
  • READ_POOL_NAME: Der Name des Lesepools, z. B. my-read-pool.

HTTP-Methode und URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Nächste Schritte