Verbindungsprofile verwalten

Auf dieser Seite wird beschrieben, wie Sie Verbindungsprofile aufrufen, aktualisieren und löschen.

Verbindungsprofil ansehen

Sie können die folgenden Informationen zu Ihren Verbindungsprofilen aufrufen:

• Alle Konfigurationsdetails, die beim Erstellen des Profils angegeben wurden. Weitere Informationen finden Sie unter Verbindungsprofile – Übersicht.

• Zeitpunkt der Erstellung und der letzten Änderung des Verbindungsprofils.

• Eine Liste der Migrationsjobs, die dieses Verbindungsprofil verwenden.

So rufen Sie die Details eines Verbindungsprofils auf:

Console

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

   Zu „Verbindungsprofile“

2. Klicken Sie auf den Anzeigenamen des Verbindungsprofils, das Sie aufrufen möchten.

   Eine Übersichtsseite für das Verbindungsprofil wird angezeigt.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• REGION durch die Kennung der Region, in der Ihr Verbindungsprofil gespeichert ist.
• CONNECTION_PROFILE_ID durch die Kennung Ihres Verbindungsprofils.

  Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration connection-profiles list alle Profile in einer bestimmten Region auflisten und ihre Kennungen aufrufen.

Weitere Informationen zu diesen Werten finden Sie unter Verbindungsprofile – Übersicht.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud database-migration connection-profiles \
describe CONNECTION_PROFILE_ID \
  --region=REGION

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud database-migration connection-profiles `
describe CONNECTION_PROFILE_ID `
  --region=REGION

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud database-migration connection-profiles ^
describe CONNECTION_PROFILE_ID ^
  --region=REGION

Verbindungsprofil aktualisieren

Sie können die folgenden Details des Verbindungsprofils ändern:

• Anzeigename
• Für Quellverbindungsprofile: Hostname oder IP-Adresse, Port, Nutzername, Passwort, Datenbankname und SSL/TLS-Zertifikate
• Für Zielverbindungsprofile (nur vorhandener Cluster): Kennung des AlloyDB for PostgreSQL-Zielclusters

So aktualisieren Sie ein Verbindungsprofil:

Console

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

   Zu „Verbindungsprofile“

2. Klicken Sie auf den Anzeigenamen des Verbindungsprofils, das Sie ändern möchten.

   Eine Übersichtsseite für das Verbindungsprofil wird angezeigt.

3. Klicken Sie auf Bearbeiten und aktualisieren Sie Ihr Verbindungsprofil.
4. Klicken Sie auf Speichern.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• CONNECTION_PROFILE_ID durch die Kennung Ihres Verbindungsprofils.

  Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration connection-profiles list alle Profile in einer bestimmten Region auflisten und ihre Kennungen aufrufen.

• REGION durch die Kennung der Region, in der Ihr Verbindungsprofil gespeichert ist.
• Optional: CONNECTION_PROFILE_NAME durch einen menschenlesbaren Namen für Ihr Verbindungsprofil. Dieser Wert wird in der Google Cloud Console angezeigt.
• Für Quellverbindungsprofile: Sie können auch Flags wie --host, --port, --username und --password übergeben, um die Verbindungsdetails Ihrer Quelldatenbank zu aktualisieren. Eine vollständige Liste der unterstützten Flags finden Sie in der Referenz zu gcloud database-migration connection-profiles update.
• Für Zielverbindungsprofile (nur vorhandener Cluster): ALLOYDB_CLUSTER_ID durch die Cluster-ID Ihres AlloyDB for PostgreSQL-Zielclusters. Informationen zum Aufrufen von AlloyDB for PostgreSQL-Clusterdetails finden Sie in der AlloyDB for PostgreSQL-Dokumentation unter Clusterdetails ansehen.

Weitere Informationen zu diesen Werten finden Sie unter Verbindungsprofile – Übersicht.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud database-migration connection-profiles \
update CONNECTION_PROFILE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud database-migration connection-profiles `
update CONNECTION_PROFILE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud database-migration connection-profiles ^
update CONNECTION_PROFILE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Ergebnis

Die Aktion wird asynchron ausgeführt. Daher gibt dieser Befehl eine Vorgangsentität zurück, die einen Vorgang mit langer Ausführungszeit darstellt:

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: CONNECTION_PROFILE_ID
  verb: update
name: OPERATION_ID

Wenn Sie prüfen möchten, ob der Vorgang erfolgreich war, können Sie das zurückgegebene Vorgangsobjekt abfragen oder die Details des Verbindungsprofils prüfen:

• Verwenden Sie den Befehl gcloud database-migration connection-profiles describe, um die aktualisierten Details des Verbindungsprofils aufzurufen.
• Verwenden Sie den Befehl gcloud database-migration operations describe mit OPERATION_ID, um den Status des Vorgangs selbst zu sehen.

Verbindungsprofil löschen

Sie können ein Verbindungsprofil nur löschen, wenn es keine Migrationsjobs gibt, die dieses Profil verwenden. Wenn Sie ein Verbindungsprofil löschen möchten, das von einem Migrationsjob verwendet wird, müssen Sie zuerst alle Migrationsjobs löschen, die mit dem Verbindungsprofil verknüpft sind.

So löschen Sie ein Verbindungsprofil:

Console

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

   Zu „Verbindungsprofile“

2. Klicken Sie auf den Anzeigenamen des Verbindungsprofils, das Sie löschen möchten.

   Eine Übersichtsseite für das Verbindungsprofil wird angezeigt.

3. Klicken Sie auf Löschen.
4. Klicken Sie im Dialogfeld auf Löschen.

gcloud

Dieser Befehl gibt eine interaktive Bestätigungsaufforderung zurück, die Sie beantworten müssen, um den Vorgang abzuschließen. Sie können die Bestätigungsaufforderung mit dem optionalen Flag --quiet überspringen.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• REGION durch die Kennung der Region, in der Ihr Verbindungsprofil gespeichert ist.
• CONNECTION_PROFILE_ID durch die Kennung Ihres Verbindungsprofils.

  Wenn Sie die Kennung nicht kennen, können Sie mit dem Befehl gcloud database-migration connection-profiles list alle Profile in einer bestimmten Region auflisten und ihre Kennungen aufrufen.

Weitere Informationen zu diesen Werten finden Sie unter Verbindungsprofile – Übersicht.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud database-migration connection-profiles \
delete CONNECTION_PROFILE_ID \
  --region=REGION

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud database-migration connection-profiles `
delete CONNECTION_PROFILE_ID `
  --region=REGION

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud database-migration connection-profiles ^
delete CONNECTION_PROFILE_ID ^
  --region=REGION

Ergebnis

Der Befehl delete gibt eine interaktive Eingabeaufforderung zurück, in der Sie die Aktion bestätigen. Geben Sie Y ein, um das Verbindungsprofil zu entfernen:

You are about to delete connection_profile [CONNECTION_PROFILE_ID]

Do you want to continue (Y/n)?

Sie können die interaktiven Bestätigungsaufforderungen der Google Cloud CLI überspringen, indem Sie das optionale Flag --quiet verwenden.