AlloyDB Express-Cluster erstellen und verwalten

In diesem Dokument wird beschrieben, wie Sie AlloyDB Express-Cluster und -Instanzen erstellen, eine Verbindung dazu herstellen, sie bearbeiten, ansehen, löschen und aktualisieren.

Weitere Informationen zu den Unterschieden zwischen den Funktionen von AlloyDB Express und AlloyDB finden Sie in der Übersicht über AlloyDB Express. Wenn Sie stattdessen einen AlloyDB-Cluster erstellen möchten, lesen Sie den Hilfeartikel Cluster und zugehörige primäre Instanz erstellen.

Hinweis

Bevor Sie AlloyDB Express-Cluster erstellen oder verwalten, müssen Sie die folgenden Voraussetzungen erfüllen:

  • Aktivieren Sie die AlloyDB API und andere erforderliche APIs in Ihrem Google Cloud -Projekt, damit Ihr Projekt für den Zugriff auf AlloyDB aktiviert ist.
  • Wenn Sie den Remote-MCP-Server von AlloyDB verwenden, konfigurieren Sie Ihren MCP-Client so, dass er entweder eine Verbindung zum globalen MCP-Serverendpunkt (https://alloydb.googleapis.com/mcp) oder zu einem regionalen Endpunkt (https://alloydb.REGION_ID.rep.googleapis.com/mcp) herstellt. Regionale Endpunkte befinden sich derzeit in der Vorabversion.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von AlloyDB Express-Clustern und -Instanzen benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

AlloyDB Express-Cluster und -Instanz erstellen

Sie können einen AlloyDB Express-Cluster und die zugehörige primäre Instanz über die Google Cloud Console, die Google Cloud CLI, die AlloyDB REST API oder den AlloyDB Remote-MCP-Server erstellen.

Ein AlloyDB Express-Cluster unterstützt PostgreSQL 18 und enthält eine einzelne zonale primäre Instanz, die mit 1 vCPU (4 GB RAM) beginnt und den Speicher automatisch auf bis zu 20 GB skaliert. Wenn Sie später ein Upgrade einer 1-vCPU-Instanz auf AlloyDB durchführen möchten, ohne die Größe auf 2 vCPUs zu ändern, erstellen Sie Ihren Cluster in einer Region, die auch die C4A-Maschinenserie unterstützt.

Die Standardeinstellungen für die Konnektivität hängen vom verwendeten Tool ab:

  • Google Cloud Console: Aktiviert standardmäßig sowohl das öffentliche DNS auf der primären Instanz als auch Private Service Connect im Cluster. Sie können Private Service Connect-Nutzerprojekte vom TypGoogle Cloud später konfigurieren, indem Sie die Verbindungseinstellungen der Instanz bearbeiten.

  • gcloud CLI, REST API und AlloyDB-Remote-MCP-Server: Aktiviert standardmäßig nur Private Service Connect im Cluster. Wenn Sie die primäre Instanz erstellen, aktivieren Sie das öffentliche DNS, wenn Sie eine Verbindung über das öffentliche DNS herstellen möchten, und setzen Sie die Nutzerprojekte vonGoogle Cloud auf die Zulassungsliste, in denen Sie Private Service Connect-Endpunkte für die Instanz erstellen möchten.

Console

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

    Zu „Jetzt starten“

    Wenn Ihr Google Cloud -Projekt bereits Cluster enthält und Sie stattdessen auf der Seite Cluster beginnen, klicken Sie in der Symbolleiste auf Cluster erstellen, um die Seite Konfiguration auswählen zu öffnen. Auf beiden Seiten werden voreingestellte Clusterkonfigurationskarten angezeigt (AlloyDB Express, Produktion (einzelne Zone) und Produktion (mehrere Zonen)).

  2. Klicken Sie auf der Karte AlloyDB Express auf Cluster erstellen, um den Bereich AlloyDB Express-Cluster erstellen zu öffnen.

  3. Konfigurieren Sie im Bereich AlloyDB Express-Cluster erstellen Ihren Cluster:

    • Geben Sie unter Cluster-ID eine ID für den Cluster ein oder behalten Sie die Standard-ID bei.
    • Geben Sie unter Passwort ein Passwort für den Standardnutzer postgres ein oder klicken Sie auf Generieren, um ein Passwort zu generieren. Sie können das Passwort später auf der Seite Nutzer ändern.
    • Wählen Sie unter Region eine unterstützte Region für Ihren Cluster aus. Wenn Sie später ein Upgrade einer Instanz mit 1 vCPU auf AlloyDB durchführen möchten, ohne die Größe auf 2 vCPUs zu ändern, wählen Sie eine Region aus, die die C4A-Maschinenserie unterstützt.

  4. Klicken Sie auf Cluster erstellen.

    In der Google Cloud Console werden Ihr AlloyDB Express-Cluster und die zugehörige primäre Instanz mit 1 vCPU erstellt. Private Service Connect und öffentliches DNS sind standardmäßig aktiviert. Anschließend wird AlloyDB Studio geöffnet, damit Sie Ihre Datenbank abfragen können.

    Sie können die Verbindungseinstellungen während der Clustererstellung in derGoogle Cloud -Konsole nicht ändern. Sie können jedoch später die autorisierten externen Netzwerke oder die Private Service Connect-Einstellungen aktualisieren, indem Sie die Verbindungseinstellungen der Instanz bearbeiten.

gcloud

Wenn Sie die gcloud CLI verwenden möchten, können Sie die Google Cloud CLI installieren und initialisieren oder Cloud Shell verwenden.

  1. Führen Sie den Befehl gcloud beta alloydb clusters create mit dem Flag --enable-express aus, um einen AlloyDB Express-Cluster zu erstellen:

    gcloud beta alloydb clusters create CLUSTER_ID \
    --region=REGION_ID \
    --password=PASSWORD \
    --enable-express \
    --project=PROJECT_ID

    Ersetzen Sie Folgendes:

    • CLUSTER_ID: die ID des Clusters, den Sie erstellen möchten. Die ID muss mit einem Kleinbuchstaben beginnen und darf Kleinbuchstaben, Ziffern und Bindestriche enthalten.
    • REGION_ID: die unterstützte Region, in der Sie den Cluster erstellen möchten. Wenn Sie später ein Upgrade einer Instanz mit 1 vCPU auf AlloyDB durchführen möchten, ohne die Größe auf 2 vCPUs zu ändern, wählen Sie eine Region aus, die auch die C4A-Maschinenserie unterstützt.
    • PASSWORD: das ursprüngliche Passwort für den Standarddatenbanknutzer postgres.
    • PROJECT_ID: die ID desGoogle Cloud -Projekts, in dem Sie den Cluster erstellen möchten.

  2. Führen Sie den Befehl gcloud beta alloydb instances create aus und wählen Sie die Verbindungs-Flags aus, um die primäre Instanz in Ihrem AlloyDB Express-Cluster zu erstellen:

    • Nur öffentliches DNS: Geben Sie --enable-public-dns an und lassen Sie --allowed-psc-projects weg.
    • Nur Private Service Connect: Lassen Sie --enable-public-dns weg und geben Sie --allowed-psc-projects=ALLOWED_PROJECT_ID an, um Private Service Connect-Verbindungen von Ihrem Nutzerprojekt Google Cloud zuzulassen.
    • Sowohl öffentliches DNS als auch Private Service Connect: Geben Sie sowohl --enable-public-dns als auch --allowed-psc-projects=ALLOWED_PROJECT_ID an.
    gcloud beta alloydb instances create INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --instance-type=PRIMARY \
    --cpu-count=1 \
    --enable-public-dns \
    --allowed-psc-projects=ALLOWED_PROJECT_ID \
    --project=PROJECT_ID

    Ersetzen Sie Folgendes:

    • INSTANCE_ID: die ID der primären Instanz, die Sie erstellen möchten.
    • ALLOWED_PROJECT_ID (optional): Eine durch Kommas getrennte Liste von Google Cloud -Projekt-IDs oder Projektnummern, die Private Service Connect-Endpunkte für diese Instanz erstellen dürfen. Lassen Sie --allowed-psc-projects weg, wenn Sie nur öffentliches DNS konfigurieren.

REST

  1. Wenn Sie einen AlloyDB Express-Cluster erstellen möchten, senden Sie eine POST-Anfrage an den Endpunkt projects.locations.clusters.create, wobei expressConfig.enabled auf true gesetzt ist.

    Ersetzen Sie folgende Werte in den Anfragedaten:

    • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
    • REGION_ID: die unterstützte Region, in der Sie den Cluster erstellen möchten. Wenn Sie später ein Upgrade einer Instanz mit 1 vCPU auf AlloyDB durchführen möchten, ohne die Größe auf 2 vCPUs zu ändern, wählen Sie eine Region aus, die auch die C4A-Maschinenserie unterstützt.
    • CLUSTER_ID: die ID des Clusters, den Sie erstellen möchten.
    • INITIAL_USERNAME: der Nutzername für den ersten Datenbanknutzer (z. B. postgres).
    • INITIAL_USER_PASSWORD: das Passwort für den ursprünglichen Datenbanknutzer.

    HTTP-Methode und URL:

    POST https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters?clusterId=CLUSTER_ID

    JSON-Text der Anfrage:

    {
  "databaseVersion": "POSTGRES_18",
  "expressConfig": {
    "enabled": true
  },
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  }
}

  2. Nachdem der Cluster erstellt wurde, erstellen Sie die primäre Instanz, indem Sie eine POST-Anfrage an den Endpunkt projects.locations.clusters.instances.create senden, wobei machineConfig.cpuCount auf 1 festgelegt ist. Wenn Sie einen anderen Wert als 1 angeben, schlägt die Erstellung fehl. Wählen Sie im Anfragetext die Verbindungsfelder aus:

    • Nur öffentliches DNS: Legen Sie "networkConfig": {"publicDnsEnabled": true} fest und lassen Sie "pscInstanceConfig" weg.
    • Nur Private Service Connect: Lassen Sie "publicDnsEnabled" weg (Standardeinstellung ist false) und legen Sie "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]} fest.
    • Sowohl öffentliches DNS als auch Private Service Connect: Schließen Sie sowohl "networkConfig": {"publicDnsEnabled": true} als auch "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]} ein.

    Ersetzen Sie folgende Werte in den Anfragedaten:

    • INSTANCE_ID: die ID der primären Instanz, die Sie erstellen möchten.
    • ALLOWED_PROJECT_ID (optional): DieGoogle Cloud Projekt-IDs oder Projektnummern, die Private Service Connect-Endpunkte für diese Instanz erstellen dürfen.

    HTTP-Methode und URL:

    POST https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances?instanceId=INSTANCE_ID

    JSON-Text der Anfrage:

    {
  "instanceType": "PRIMARY",
  "availabilityType": "ZONAL",
  "machineConfig": {
    "cpuCount": 1
  },
  "networkConfig": {
    "publicDnsEnabled": true
  },
  "pscInstanceConfig": {
    "allowedConsumerProjects": [
      "ALLOWED_PROJECT_ID"
    ]
  }
}

MCP

Sie können einen MCP-Client verwenden oder den Remote-MCP-Server von AlloyDB direkt aufrufen, um einen AlloyDB Express-Cluster und die zugehörige primäre Instanz zu erstellen.

In einem MCP-Client können Sie mit einem einzigen Prompt sowohl den AlloyDB Express-Cluster als auch die zugehörige primäre Instanz erstellen. Ihr MCP-Client ruft automatisch create_cluster auf, fragt get_operation ab und ruft create_instance auf:

Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID with a primary instance named INSTANCE_ID.

So führen Sie die einzelnen Schritte separat aus oder rufen die MCP-Tools direkt auf:

  1. Wenn Sie einen AlloyDB Express-Cluster erstellen möchten, geben Sie einen Prompt in Ihren MCP-Client ein oder rufen Sie das MCP-Tool create_cluster auf, wobei express_config.enabled auf true gesetzt ist.

    Ersetzen Sie folgende Werte in den Anfragedaten:

    In Ihrem MCP-Client können Sie einen Prompt ähnlich dem folgenden eingeben:

    Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID.

    Toolaufrufparameter:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_cluster",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID",
      "cluster_id": "CLUSTER_ID",
      "express_config": {
        "enabled": true
      }
    }
  }
}

    Damit Private Service Connect von einem VPC-Netzwerk aus erreichbar ist, müssen Sie beim Erstellen oder Aktualisieren der primären Instanz die NutzerprojekteGoogle Cloud in "psc_instance_config" auf die Zulassungsliste setzen.

  2. Das create_cluster-Tool gibt einen Vorgang mit langer Ausführungszeit zurück. Fragen Sie den Status des Vorgangs mit dem MCP-Tool get_operation ab, bis done den Wert true hat und der Cluster den Status READY hat.

  3. Wenn Sie die primäre Instanz in Ihrem AlloyDB Express-Cluster erstellen möchten, geben Sie einen Prompt in Ihrem MCP-Client ein oder rufen Sie das MCP-Tool create_instance auf. Wähle deine Verbindungseinstellungen aus:

    • Nur öffentliches DNS: Legen Sie "public_dns_enabled": true fest und lassen Sie "psc_instance_config" weg.

    • Nur Private Service Connect: Lassen Sie "public_dns_enabled" weg (Standardeinstellung ist false) und legen Sie "psc_instance_config" mit "allowed_consumer_projects" fest (oder "psc_auto_connections" mit Angabe von "consumer_project" und "consumer_network").

    • Sowohl öffentliches DNS als auch Private Service Connect: Legen Sie sowohl "public_dns_enabled": true als auch "psc_instance_config" fest.

    Ersetzen Sie folgende Werte in den Anfragedaten:

    • INSTANCE_ID: die ID der primären Instanz, die Sie erstellen möchten.

    • ALLOWED_PROJECT_ID: optional: dieGoogle Cloud Projekt-IDs oder Projektnummern, die Private Service Connect-Endpunkte für diese Instanz erstellen dürfen.

    In Ihrem MCP-Client können Sie einen Prompt ähnlich dem folgenden eingeben:

    Please create a primary instance named INSTANCE_ID in my AlloyDB Express cluster CLUSTER_ID.

    Toolaufrufparameter:

    {
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_instance",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID",
      "instance_id": "INSTANCE_ID",
      "type": "PRIMARY",
      "public_dns_enabled": true,
      "psc_instance_config": {
        "allowed_consumer_projects": [
          "ALLOWED_PROJECT_ID"
        ]
      }
    }
  }
}

  4. Fragen Sie den Vorgang zur Instanzerstellung mit dem MCP-Tool get_operation ab, bis done den Wert true hat und die Instanz den Status READY hat.

Verbindung zu einer AlloyDB Express-Instanz herstellen

AlloyDB Express unterstützt die folgenden Optionen für die eingehende Datenbankverbindung:

  • Öffentliches DNS (Standard): Stellt einen öffentlich routingfähigen DNS-Namen (networkInfo.publicDnsName) bereit, damit Sie eine Verbindung von Clients außerhalb eines VPC-Netzwerk herstellen können.
  • Private Service Connect: Ermöglicht es Ihnen, über Private Service Connect-Endpunkte innerhalb Ihres VPC-Netzwerk eine private Verbindung zu Ihrer Instanz herzustellen, ohne Ihre Datenbank dem öffentlichen Internet zugänglich zu machen.

Verbindung über öffentliches DNS herstellen

Wenn Sie eine Verbindung über ein öffentliches DNS von außerhalb eines VPC-Netzwerk herstellen, können Sie eine der folgenden Optionen wählen:

Direkt über einen PostgreSQL-Client verbinden

Standardmäßig werden alle direkten Client-IP-Adressen vom öffentlichen DNS-Endpunkt abgelehnt. Sie müssen Ihre Client-CIDR-Blöcke auf die Zulassungsliste setzen, bevor Sie eine direkte Verbindung zu psql herstellen.

  1. Konfigurieren Sie autorisierte externe Netzwerke auf Ihrer primären Instanz.

    Sie können autorisierte externe Netzwerke nicht einzeln hinzufügen oder entfernen. Mit jeder Aktualisierung wird die vorhandene Liste überschrieben. Geben Sie eine durch Kommas getrennte Liste aller CIDR-Blöcke an, die Sie zulassen möchten.

    Console

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

      Zu den Clustern

    2. Klicken Sie in der Spalte Ressourcenname auf den Namen Ihres AlloyDB Express-Clusters.

    3. Gehen Sie auf der Seite Übersicht zu Instanzen in Ihrem Cluster, suchen Sie Ihre primäre Instanz und klicken Sie auf Instanzaktionen > Bearbeiten (oder rufen Sie im Navigationsmenü Konnektivität auf und klicken Sie auf Bearbeiten).

    4. Achten Sie darauf, dass unter Konnektivität die öffentliche Konnektivität aktiviert ist.

    5. Geben Sie unter Autorisierte externe Netzwerke eine durch Kommas getrennte Liste von IPv4-CIDR-Bereichen ein (z. B. 203.0.113.0/24) oder klicken Sie auf Meine IP verwenden, um die IPv4-Adresse /32 Ihres aktuellen Computers hinzuzufügen.

    6. Klicken Sie auf Instanz aktualisieren.

    gcloud

    Wenn Sie die gcloud CLI verwenden möchten, können Sie die Google Cloud CLI installieren und initialisieren oder Cloud Shell verwenden.

    Führen Sie den Befehl gcloud alloydb instances update mit dem Flag --authorized-external-networks aus:

    gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2 \
    --project=PROJECT_ID

    Ersetzen Sie Folgendes:

    • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.
    • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.
    • REGION_ID: Die Region, in der sich Ihr Cluster befindet.
    • CIDR_RANGE1, CIDR_RANGE2: eine durch Kommas getrennte Liste von IPv4-Adressbereichen in CIDR-Notation (z. B. 203.0.113.0/24).
    • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.

    REST

    Senden Sie eine PATCH-Anfrage an den Endpunkt projects.locations.clusters.instances.patch mit updateMask=networkConfig.authorizedExternalNetworks.

    Ersetzen Sie folgende Werte in den Anfragedaten:

    • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
    • REGION_ID: Die Region, in der sich Ihr Cluster befindet.
    • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.
    • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.
    • CIDR_RANGE1, CIDR_RANGE2: IPv4-Adressbereiche in CIDR-Notation (z. B. 203.0.113.0/24).

    HTTP-Methode und URL:

    PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=networkConfig.authorizedExternalNetworks

    JSON-Text der Anfrage:

    {
  "networkConfig": {
    "authorizedExternalNetworks": [
      {
        "cidrRange": "CIDR_RANGE1"
      },
      {
        "cidrRange": "CIDR_RANGE2"
      }
    ]
  }
}

    MCP

    Geben Sie einen Prompt in Ihren MCP-Client ein oder rufen Sie das MCP-Tool update_instance mit dem Feld authorized_external_networks auf.

    Ersetzen Sie folgende Werte in den Anfragedaten:

    • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.

    • REGION_ID: Die Region, in der sich Ihr Cluster befindet.

    • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.

    • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.

    • CIDR_RANGE1, CIDR_RANGE2: IPv4-Adressbereiche in CIDR-Notation, z. B. 203.0.113.0/24.

    In Ihrem MCP-Client können Sie einen Prompt ähnlich dem folgenden eingeben:

    Please update the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID to allow external connections from CIDR_RANGE1.

    Toolaufrufparameter:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_instance",
    "arguments": {
      "instance": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID",
      "authorized_external_networks": [
        "CIDR_RANGE1",
        "CIDR_RANGE2"
      ]
    }
  }
}

  2. Rufen Sie den öffentlichen DNS-Namen Ihrer Instanz ab:

    Console

    1. Rufen Sie in der Google Cloud Console die Seite Cluster auf und klicken Sie auf den Namen Ihres AlloyDB Express-Clusters.
    2. Rufen Sie Konnektivität auf (oder rufen Sie die Karte der primären Instanz auf der Seite Übersicht auf) und kopieren Sie den öffentlichen DNS-Namen der Instanz.

    gcloud

    Führen Sie den Befehl gcloud beta alloydb instances describe aus, um den Wert networkInfo.publicDnsName abzurufen:

    gcloud beta alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --format="value(networkInfo.publicDnsName)" \
    --project=PROJECT_ID

    Die Ausgabe hat das folgende Format:

    IDENTIFIER.IDENTIFIER.REGION_ID.alloydb.s.cloud.goog

    In dieser Ausgabe ist IDENTIFIER eine vom System generierte alphanumerische Kennung.

    REST

    Senden Sie eine GET-Anfrage an den Endpunkt projects.locations.clusters.instances.get und lesen Sie das Feld networkInfo.publicDnsName aus der Antwort:

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

    MCP

    Geben Sie einen Prompt in Ihren MCP-Client ein oder rufen Sie das MCP-Tool get_instance auf und lesen Sie das Feld networkInfo.publicDnsName aus der Antwort.

    In Ihrem MCP-Client können Sie einen Prompt ähnlich dem folgenden eingeben:

    Please get the public DNS name of the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID.

    Toolaufrufparameter:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID"
    }
  }
}

  3. Stellen Sie eine Verbindung zu Ihrer Datenbank her. Verwenden Sie dazu einen Standard-PostgreSQL-Verbindungs-URI und den öffentlichen DNS-Namen Ihrer Instanz:

    psql postgresql://USERNAME@PUBLIC_DNS_NAME/DATABASE_NAME

    Ersetzen Sie Folgendes:

    • USERNAME: der PostgreSQL-Datenbanknutzername (z. B. postgres).
    • PUBLIC_DNS_NAME: Der öffentliche DNS-Name Ihrer AlloyDB Express-Instanz (z. B. 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d.a.us-central1.alloydb.s.cloud.goog).
    • DATABASE_NAME: der Name der Datenbank, zu der eine Verbindung hergestellt werden soll (die Standarddatenbank ist postgres).

  4. Geben Sie bei entsprechender Aufforderung das Passwort für den Datenbanknutzer ein.

Verbindung über die gcloud CLI oder den Auth-Proxy herstellen

Wenn Sie eine Verbindung über öffentliches DNS herstellen möchten, ohne autorisierte externe Netzwerke zu konfigurieren, können Sie entweder den Befehl gcloud beta alloydb connect oder den eigenständigen Auth-Proxy-Client (alloydb-auth-proxy) mit dem Flag --public-ip verwenden. Obwohl AlloyDB Express einen öffentlichen DNS-Namen anstelle einer öffentlichen IP-Adresse anzeigt, stellt die Steuerungsebene eine zugrunde liegende öffentliche Verbindung für die Instanz bereit, die der Auth-Proxy automatisch auflöst, wenn Sie --public-ip angeben.

Wenn Sie eine lokale Auth-Proxy-Instanz starten und eine psql-Sitzung mit der gcloud CLI öffnen möchten, führen Sie den Befehl gcloud beta alloydb connect mit dem Flag --public-ip aus:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --public-ip \
    --user=USERNAME \
    --database=DATABASE_NAME \
    --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.
  • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.
  • REGION_ID: Die Region, in der sich der Cluster befindet.
  • USERNAME: der Datenbanknutzername (Standardwert ist postgres).
  • DATABASE_NAME: der Datenbankname (Standardwert ist postgres).
  • PROJECT_ID: die ID Ihres Projekts in Google Cloud .

Weitere Informationen zum Herstellen einer Verbindung mit der gcloud CLI, einschließlich der IAM-Datenbankauthentifizierung (--auto-iam-authn), finden Sie unter Verbindung mit der gcloud CLI herstellen.

Alternativ können Sie den eigenständigen Auth-Proxy-Client mit dem Flag --public-ip herunterladen und ausführen:

./alloydb-auth-proxy \
    "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID" \
    --public-ip

Informationen zum Herunterladen, Konfigurieren und Verbinden über den eigenständigen Auth-Proxy-Client finden Sie unter Verbindung mit dem AlloyDB Auth-Proxy herstellen.

Verbindung über Private Service Connect herstellen

Für private Konnektivität innerhalb Ihres VPC-Netzwerk, ohne Ihre Datenbank dem öffentlichen Internet zugänglich zu machen, können Sie Private Service Connect auf Ihrer AlloyDB Express-Instanz konfigurieren. Sie können eine Verbindung zu einem Private Service Connect-Endpunkt entweder direkt von einem Client in Ihrem VPC-Netzwerk oder über den Auth-Proxy herstellen. Weitere Informationen zum Herstellen einer Verbindung zu Private Service Connect finden Sie unter Verbindung zu einer Instanz über Private Service Connect herstellen.

Wenn Sie diese Anleitung für AlloyDB Express befolgen, erstellen Sie Ihren Cluster und Ihre zonale primäre Instanz mit 1 vCPU wie unter AlloyDB Express-Cluster und -Instanz erstellen beschrieben, wobei Private Service Connect aktiviert ist. AlloyDB Express unterstützt eingehende Private Service Connect-Verbindungen zu einer einzelnen zonalen primären Instanz.

AlloyDB Express-Instanz bearbeiten

Sie können die CPU-Anzahl (1 vCPU oder 2 vCPUs) oder die Datenbank-Flags einer primären AlloyDB Express-Instanz aktualisieren.

Console

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

    Zu den Clustern

  2. Klicken Sie in der Spalte Ressourcenname auf den Namen Ihres AlloyDB Express-Clusters.

  3. Suchen Sie auf der Seite Übersicht im Abschnitt Instanzen in Ihrem Cluster nach Ihrer primären Instanz und klicken Sie auf Primäre Instanz bearbeiten (oder klicken Sie auf Instanzaktionen > Bearbeiten).

  4. Aktualisieren Sie auf der Seite Primäre Instanz bearbeiten die Instanzeinstellungen:

    • Wählen Sie unter Maschine in der Liste Maschinentyp die Option 1 vCPU, 4 GB oder 2 vCPU, 8 GB aus.
    • Optional: Wenn Sie Datenbank-Flags konfigurieren möchten, maximieren Sie Flags (oder klicken Sie auf Erweiterte Optionen anzeigen und maximieren Sie Flags) und klicken Sie auf Flag hinzufügen. Wählen Sie ein Flag aus der Liste Neues Datenbank-Flag aus, geben Sie einen Wert an und klicken Sie auf Fertig.

  5. Klicken Sie auf Instanz aktualisieren.

gcloud

Wenn Sie die gcloud CLI verwenden möchten, können Sie die Google Cloud CLI installieren und initialisieren oder Cloud Shell verwenden.

Wenn Sie die Instanz skalieren möchten, indem Sie die CPU-Anzahl (1 oder 2) ändern, oder wenn Sie die Datenbank-Flags aktualisieren möchten, führen Sie den Befehl gcloud alloydb instances update aus:

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --cpu-count=CPU_COUNT \
    --database-flags=FLAGS \
    --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.
  • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.
  • REGION_ID: Die Region, in der sich Ihr Cluster befindet.
  • CPU_COUNT: die Anzahl der vCPUs für die Instanz (1 für 1 vCPU, 4 GB RAM oder 2 für 2 vCPUs, 8 GB RAM).
  • FLAGS (optional): Eine durch Kommas getrennte Liste von Datenbank-Flags und Werten im Format FLAG_NAME=VALUE. Wenn Sie nur die CPU-Anzahl aktualisieren, lassen Sie das Flag --database-flags weg. Weitere Informationen zu unterstützten Flags finden Sie unter Unterstützte Datenbank-Flags.
  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • --enable-public-dns oder --no-enable-public-dns: Aktiviert oder deaktiviert öffentliches DNS für die Instanz. Dieses Flag ist nur in gcloud beta (gcloud beta alloydb instances update) verfügbar.
  • --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]: Aktualisiert die durch Kommas getrennte Liste der Nutzer- Google Cloud -Projekt-IDs oder Projektnummern, die Private Service Connect-Endpunkte für die Instanz erstellen dürfen.

REST

Wenn Sie die CPU-Anzahl oder die Datenbank-Flags einer primären AlloyDB Express-Instanz aktualisieren möchten, senden Sie eine PATCH-Anfrage an den Endpunkt projects.locations.clusters.instances.patch und geben Sie die zu aktualisierenden Felder im Suchparameter updateMask an.

Ersetzen Sie folgende Werte in den Anfragedaten:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • REGION_ID: Die Region, in der sich Ihr Cluster befindet.
  • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.
  • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.
  • CPU_COUNT: die Anzahl der vCPUs für die Instanz (1 oder 2).
  • FLAG_NAME und FLAG_VALUE (optional): Name und Wert des Datenbank-Flags, das festgelegt werden soll. Wenn Sie nur die CPU-Anzahl aktualisieren, legen Sie updateMask=machineConfig.cpuCount fest und lassen Sie databaseFlags im Anfragetext weg.

HTTP-Methode und URL:

PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=machineConfig.cpuCount,databaseFlags

JSON-Text der Anfrage:

{
  "machineConfig": {
    "cpuCount": CPU_COUNT
  },
  "databaseFlags": {
    "FLAG_NAME": "FLAG_VALUE"
  }
}

MCP

Wenn Sie die CPU-Anzahl oder die Datenbank-Flags einer primären AlloyDB Express-Instanz aktualisieren möchten, geben Sie einen Prompt in Ihrem MCP-Client ein oder rufen Sie das MCP-Tool update_instance auf.

Ersetzen Sie folgende Werte in den Anfragedaten:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.

  • REGION_ID: Die Region, in der sich Ihr Cluster befindet.

  • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.

  • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.

  • CPU_COUNT: die Anzahl der vCPUs für die Instanz (1 oder 2).

  • FLAG_NAME und FLAG_VALUE: optional: der Name und der Wert des Datenbank-Flags, das festgelegt werden soll. Wenn Sie nur die CPU-Anzahl aktualisieren, lassen Sie database_flags in arguments weg.

In Ihrem MCP-Client können Sie einen Prompt ähnlich dem folgenden eingeben:

Please update the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID to CPU_COUNT vCPUs.

Toolaufrufparameter:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_instance",
    "arguments": {
      "instance": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID",
      "cpu_count": CPU_COUNT,
      "database_flags": {
        "FLAG_NAME": "FLAG_VALUE"
      }
    }
  }
}

Details zu AlloyDB Express-Clustern und -Instanzen ansehen

Sie können eine Liste Ihrer AlloyDB Express-Cluster aufrufen, Details zu einem bestimmten AlloyDB Express-Cluster oder einer bestimmten Instanz ansehen und die Rechen- und Speichernutzung Ihres Clusters prüfen.

Weitere Informationen finden Sie unter Liste der Cluster ansehen, Clusterdetails ansehen und Instanzdetails ansehen.

Console

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

    Zu den Clustern

    In der Spalte Ressourcenname wird bei AlloyDB Express-Clustern neben dem Clusternamen das Tag Express angezeigt.

  2. Wenn Sie detaillierte Informationen zu einem Cluster und seiner primären Instanz aufrufen möchten, klicken Sie in der Spalte Ressourcenname auf den Clusternamen.

  3. Auf der Seite Übersicht finden Sie die Clusterdetails unter Clusterdetails (einschließlich des Tags Express neben Cluster-ID und Gesamter belegter Speicher des Limits von 20 GB) und die Details der primären Instanz unter Instanzen in Ihrem Cluster.

gcloud

Wenn Sie die gcloud CLI verwenden möchten, können Sie die Google Cloud CLI installieren und initialisieren oder Cloud Shell verwenden.

  • Führen Sie den Befehl gcloud alloydb clusters list aus, um eine Liste der Cluster in Ihrem Projekt aufzurufen:

    gcloud alloydb clusters list --project=PROJECT_ID

  • Führen Sie zum Aufrufen der Details eines bestimmten Clusters den Befehl gcloud alloydb clusters describe aus:

    gcloud alloydb clusters describe CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

  • Führen Sie den Befehl gcloud alloydb instances describe aus, um Details zu einer bestimmten Instanz aufzurufen:

    gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.
  • REGION_ID: Die Region, in der sich Ihr Cluster befindet.
  • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.

REST

Ersetzen Sie folgende Werte in den Anfragedaten:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • REGION_ID: Die Region, in der sich Ihr Cluster befindet.
  • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.

  • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.

  • Wenn Sie eine Liste der Cluster in einer Region aufrufen möchten, senden Sie eine GET-Anfrage an den Endpunkt projects.locations.clusters.list:

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters

  • Wenn Sie Details zu einem Cluster aufrufen möchten, senden Sie eine GET-Anfrage an den Endpunkt projects.locations.clusters.get:

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID

  • Wenn Sie Details zu einer Instanz aufrufen möchten, senden Sie eine GET-Anfrage an den Endpunkt projects.locations.clusters.instances.get:

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

MCP

Ersetzen Sie folgende Werte in den Anfragedaten:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.

  • REGION_ID: Die Region, in der sich Ihr Cluster befindet.

  • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.

  • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.

  • Wenn Sie eine Liste der Cluster in einer Region aufrufen möchten, geben Sie einen Prompt in Ihrem MCP-Client ein oder rufen Sie das MCP-Tool list_clusters auf.

    In Ihrem MCP-Client können Sie einen Prompt ähnlich dem folgenden eingeben:

    Please list the AlloyDB clusters in REGION_ID in project PROJECT_ID.

    Toolaufrufparameter:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_clusters",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID"
    }
  }
}

  • Wenn Sie Details zu einem Cluster aufrufen möchten, geben Sie einen Prompt in Ihren MCP-Client ein oder rufen Sie das MCP-Tool get_cluster auf.

    In Ihrem MCP-Client können Sie einen Prompt ähnlich dem folgenden eingeben:

    Please show the details of the AlloyDB cluster CLUSTER_ID in REGION_ID.

    Toolaufrufparameter:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_cluster",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID"
    }
  }
}

  • Wenn Sie Details zu einer Instanz aufrufen möchten, geben Sie einen Prompt in Ihrem MCP-Client ein oder rufen Sie das MCP-Tool get_instance auf.

    In Ihrem MCP-Client können Sie einen Prompt ähnlich dem folgenden eingeben:

    Please show the details of the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID.

    Toolaufrufparameter:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID"
    }
  }
}

Computing- und Speichernutzung ansehen

Wenn Sie den Speicher und die Rechenleistung prüfen möchten, die von Ihrem AlloyDB Express-Cluster und Ihrer primären Instanz verwendet werden, verwenden Sie die Google Cloud Console oder Cloud Monitoring:

  • Öffnen Sie in der Google Cloud Console die Seite Übersicht Ihres Clusters:

    • Verwendeter Speicher: Sehen Sie sich unter Clusterdetails den Verwendeten Gesamtspeicher an, um zu sehen, wie viel Speicherplatz Ihr Cluster vom Limit von 20 GB belegt.
    • Computing und Verbindungen: Sehen Sie sich die Diagramme CPU-Auslastung und Aktive Verbindungen auf der Seite Übersicht an oder klicken Sie im Navigationsmenü auf Systemstatistiken, um detaillierte CPU-, Arbeitsspeicher- und Speichermesswerte aufzurufen.

  • Fragen Sie im Cloud Monitoring Metrics Explorer die folgenden Messwerte für die überwachten Ressourcentypen alloydb.googleapis.com/Cluster und alloydb.googleapis.com/Instance ab:

    • Genutzter Speicherplatz: alloydb.googleapis.com/cluster/storage/usage
    • CPU-Auslastung: alloydb.googleapis.com/instance/cpu/average_utilization und alloydb.googleapis.com/instance/cpu/maximum_utilization
    • Aktive Verbindungen: alloydb.googleapis.com/database/postgresql/backends

AlloyDB Express-Cluster oder -Instanz löschen

Sie können eine primäre AlloyDB Express-Instanz oder einen AlloyDB Express-Cluster löschen, wenn Sie sie nicht mehr benötigen.

Weitere Informationen finden Sie unter Instanz löschen und Cluster löschen.

Console

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

    Zu den Clustern

  2. Klicken Sie in der Spalte Ressourcenname auf den Namen Ihres AlloyDB Express-Clusters.

  3. Löschen Sie auf der Seite Übersicht die primäre Instanz oder den Cluster:

    • Wenn Sie die primäre Instanz löschen möchten, rufen Sie den Abschnitt Instanzen in Ihrem Cluster auf, klicken Sie auf Instanzaktionen > Löschen, geben Sie die Instanz-ID im Dialogfeld ein und klicken Sie auf Löschen.
    • Wenn Sie den Cluster löschen möchten, löschen Sie zuerst die primäre Instanz im Cluster. Klicken Sie dann auf Cluster löschen, geben Sie im Dialogfeld Cluster löschen Ihre Cluster-ID ein und klicken Sie auf Löschen.

gcloud

Wenn Sie die gcloud CLI verwenden möchten, können Sie die Google Cloud CLI installieren und initialisieren oder Cloud Shell verwenden.

  • Führen Sie den Befehl gcloud alloydb instances delete aus, um eine Instanz zu löschen:

    gcloud alloydb instances delete INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

  • Führen Sie den Befehl gcloud alloydb clusters delete aus, um einen Cluster zu löschen. Wenn der Cluster noch die primäre Instanz enthält, fügen Sie das Flag --force hinzu, um die primäre Instanz und den Cluster zusammen zu löschen:

    gcloud alloydb clusters delete CLUSTER_ID \
    --region=REGION_ID \
    --force \
    --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.
  • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.
  • REGION_ID: Die Region, in der sich Ihr Cluster befindet.
  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.

REST

Ersetzen Sie folgende Werte in den Anfragedaten:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • REGION_ID: Die Region, in der sich Ihr Cluster befindet.
  • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.

  • INSTANCE_ID: die ID Ihrer primären AlloyDB Express-Instanz.

  • Senden Sie zum Löschen einer Instanz eine DELETE-Anfrage an den Endpunkt projects.locations.clusters.instances.delete:

    DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

  • Wenn Sie einen Cluster (einschließlich seiner primären Instanz, wenn Sie force=true angeben) löschen möchten, senden Sie eine DELETE-Anfrage an den Endpunkt projects.locations.clusters.delete:

    DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID?force=true

AlloyDB Express-Cluster auf AlloyDB upgraden

Sie können ein direktes Upgrade Ihres AlloyDB Express-Clusters auf einen AlloyDB-Cluster durchführen.

Beim Upgrade bleiben Ihre Datenbankdaten, Schemas, Erweiterungen, Nutzeranmeldedaten, Netzwerkkonfiguration (einschließlich Ihres öffentlichen DNS-Namens und der Private Service Connect-Endpunkte) und die Anzahl der vCPUs der primären Instanz erhalten.

In der folgenden Liste werden die Ressourcen und Einstellungen beschrieben, die sich während des Upgrades ändern:

  • CPU-Anzahl, Arbeitsspeicherverhältnis und Rechenkapazität: Ihre Instanz behält die aktuelle vCPU-Anzahl (1 vCPU oder 2 vCPUs) und wird vom AlloyDB Express-vCPU-zu-Arbeitsspeicher-Verhältnis von 1:4 (4 GB oder 8 GB RAM) auf das AlloyDB-vCPU-zu-Arbeitsspeicher-Verhältnis von 1:8 (8 GB RAM für 1 vCPU oder 16 GB RAM für 2 vCPUs) aktualisiert. Nach dem Upgrade können Sie die Rechenleistung auf bis zu 288 vCPUs skalieren.
    • Wenn Sie eine Instanz mit 1 vCPU aktualisieren, sind Sie auf Regionen beschränkt, die die C4A-Maschinenserie unterstützen. Informationen zu unterstützten Regionen finden Sie unter Regionale Verfügbarkeit für C4A.
    • Wenn sich Ihre AlloyDB Express-Instanz nicht in einer Region befindet, die C4A-Maschinentypen unterstützt, müssen Sie Ihre primäre Instanz zuerst auf eine Konfiguration mit 2 vCPUs aktualisieren, bevor Sie das Upgrade durchführen. Wenn Sie in der Google Cloud Konsole für eine Instanz mit 1 vCPU in einer nicht unterstützten Region auf Upgrade klicken, werden Sie in einer Meldung aufgefordert, die Größe der Instanz zuerst auf 2 vCPUs anzupassen.
  • Bereitgestellte Rechenleistung und Abrechnung: Durch das Upgrade wird die Rechenleistung mit Skalierung auf null deaktiviert und Ihre Instanz wird als immer aktive AlloyDB-Instanz ausgeführt, die zu AlloyDB-Preisen abgerechnet wird.
  • Speicherkapazität: Durch das Upgrade wird das Speicherlimit von 20 GB aufgehoben. Der Speicher kann bis zu einem Standardkontingent von 16 TiB pro Cluster skaliert werden. Sie können eine Erhöhung des Speicherkontingents auf bis zu 128 TiB anfordern.
  • Unternehmensfunktionen: Das Upgrade schaltet die regionale Hochverfügbarkeit (HA) frei, die durch das Service Level Agreement (SLA) für eine Verfügbarkeit von 99,99 % abgedeckt ist. Außerdem werden Lesepoolinstanzen, regionsübergreifende Replikation, kontinuierliche Sicherung und Wiederherstellung sowie automatische und On-Demand-Sicherungen freigeschaltet.

So aktualisieren Sie Ihren AlloyDB Express-Cluster auf einen AlloyDB-Cluster:

Console

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

    Zu den Clustern

  2. Klicken Sie in der Spalte Ressourcenname auf den Namen Ihres AlloyDB Express-Clusters.

  3. Suchen Sie auf der Seite Übersicht unter Clusterdetails nach der Cluster-ID und klicken Sie dann auf Upgrade.

    Wenn Ihre primäre Instanz eine Instanz mit 1 vCPU in einer Region ist, die die C4A-Maschinenserie nicht unterstützt, wird eine Meldung angezeigt:

    Upgrading to AlloyDB requires a 2 vCPU instance in the REGION_ID region. Resize your instance to 2 vCPUs first.

    Klicken Sie auf Instanz bearbeiten, um die Größe der Instanz auf 2 vCPUs anzupassen. Klicken Sie nach dem Ändern der Größe der Instanz noch einmal auf Upgrade.

  4. Geben Sie im Bereich Upgrade von AlloyDB Express durchführen Ihre Cluster-ID ein, um das Upgrade zu bestätigen, und klicken Sie dann auf Bestätigen.

gcloud

Wenn Sie die gcloud CLI verwenden möchten, können Sie die Google Cloud CLI installieren und initialisieren oder Cloud Shell verwenden.

Wenn Sie ein Upgrade Ihres AlloyDB Express-Clusters auf einen AlloyDB-Cluster durchführen möchten, führen Sie den Befehl gcloud beta alloydb clusters update mit dem Flag --no-enable-express aus:

gcloud beta alloydb clusters update CLUSTER_ID \
    --region=REGION_ID \
    --no-enable-express \
    --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.
  • REGION_ID: Die Region, in der sich Ihr Cluster befindet.
  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.

Wenn Ihre primäre Instanz eine Instanz mit 1 vCPU in einer Region ist, die die C4A-Maschinenserie nicht unterstützt, schlägt der Befehl mit dem folgenden Fehler fehl:

Upgrading to AlloyDB is not supported for 1-vCPU instances in location "REGION_ID". Please update the instance to use 2 vCPUs and try the upgrade again.

Um diesen Fehler zu beheben, aktualisieren Sie Ihre primäre Instanz auf 2 vCPUs (--cpu-count=2) und führen Sie dann den Upgrade-Befehl noch einmal aus.

REST

Wenn Sie ein Upgrade Ihres AlloyDB Express-Clusters auf einen AlloyDB-Cluster durchführen möchten, senden Sie eine PATCH-Anfrage an den Endpunkt projects.locations.clusters.patch mit updateMask=expressConfig.enabled und setzen Sie expressConfig.enabled auf false.

Ersetzen Sie folgende Werte in den Anfragedaten:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • REGION_ID: Die Region, in der sich Ihr Cluster befindet.
  • CLUSTER_ID: die ID Ihres AlloyDB Express-Clusters.

HTTP-Methode und URL:

PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID?updateMask=expressConfig.enabled

JSON-Text der Anfrage:

{
  "expressConfig": {
    "enabled": false
  }
}

Wenn Ihre primäre Instanz eine Instanz mit 1 vCPU in einer Region ist, die die C4A-Maschinenserie nicht unterstützt, schlägt die Anfrage mit dem folgenden Fehler fehl:

Upgrading to AlloyDB is not supported for 1-vCPU instances in location "REGION_ID". Please update the instance to use 2 vCPUs and try the upgrade again.

Um diesen Fehler zu beheben, aktualisieren Sie Ihre primäre Instanz auf 2 vCPUs ("machineConfig": {"cpuCount": 2}) und senden Sie die Upgradeanfrage dann noch einmal.

Nächste Schritte