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

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Verbindungsprofil aktualisieren

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

  • Anzeigename
  • (Nur Zielprofil) Kennung der Cloud SQL for PostgreSQL-Zielinstanz, Datenbanknutzername und Passwort

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

In diesem Beispiel wird das optionale Flag --no-async verwendet, damit alle Vorgänge synchron ausgeführt werden. Das bedeutet, dass die Ausführung einiger Befehle eine Weile dauern kann. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie den Befehl gcloud database-migration operations describe verwenden, um zu prüfen, ob der Vorgang erfolgreich war.

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.
  • Nur für Zielverbindungsprofile: CLOUDSQL_INSTANCE_ID durch die Instanz-ID Ihrer Cloud SQL-Zielinstanz. Informationen zum Aufrufen von Cloud SQL-Instanzdetails finden Sie in der Cloud SQL-Dokumentation unter Instanzinformationen aufrufen.
Weitere Informationen zu diesen Werten finden Sie unter Verbindungsprofile – Übersicht.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud database-migration connection-profiles update postgresql \
  CONNECTION_PROFILE_ID \
  --no-async \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

Windows (PowerShell)

gcloud database-migration connection-profiles update postgresql `
  CONNECTION_PROFILE_ID `
  --no-async `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

Windows (cmd.exe)

gcloud database-migration connection-profiles update postgresql ^
  CONNECTION_PROFILE_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

Sie sollten eine Antwort ähnlich der folgenden erhalten:

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Updated connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

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

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

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.