Verbindungsprofile verwalten

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

Verbindungsprofil ansehen

Sie können sich die folgenden Informationen zu Ihren Verbindungsprofilen ansehen:

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

  • Erstellungs- und Änderungszeit des Verbindungsprofils

  • Eine Liste der Migrationsjobs, die dieses Verbindungsprofil verwenden.

So rufen Sie die Details zum Verbindungsprofil auf:

Konsole

  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 mit der 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 Übersicht über Verbindungsprofile.

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 Quellprofil) Name des Cloud Storage-Bucket
  • (Nur Zielprofil) Cloud SQL for SQL Server-Instanz-ID, Datenbanknutzername und ‑passwort des Ziels

So aktualisieren Sie ein Verbindungsprofil:

Konsole

  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 einige Befehle einige Zeit in Anspruch nehmen können. Sie können das Flag --no-async überspringen, um Befehle asynchron auszuführen. In diesem Fall müssen Sie mit dem Befehl gcloud database-migration operations describe 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 mit der Kennung der Region, in der Ihr Verbindungsprofil gespeichert ist.
  • Optional: CONNECTION_PROFILE_NAME mit einem von Menschen lesbaren Namen für Ihr Verbindungsprofil. Dieser Wert wird in der Google Cloud Console angezeigt.
  • Optional (nur für Quellverbindungsprofile): SOURCE_STORAGE_BUCKET_NAME mit dem Namen des Cloud Storage-Buckets, der den übergeordneten Datenbankordner enthält, in dem Sie die Ordner „full“, „diff“ und „logs“ (mit den Dateien für die vollständige Sicherung, die Differenzsicherung und die Transaktionsprotokolle) erstellen.
  • Optional, nur für Zielverbindungsprofile
    • CLOUDSQL_INSTANCE_ID durch die Instanz-ID Ihrer Cloud SQL for SQL Server-Zielinstanz. Informationen zum Aufrufen von Cloud SQL-Instanzdetails finden Sie in der Cloud SQL-Dokumentation unter Instanzinformationen aufrufen.
    • Details zum Migrationsnutzer: Geben Sie die Details für das spezielle Datenbanknutzerkonto in der Zielinstanz an. Weitere Informationen zu diesem Nutzerkonto finden Sie unter Cloud SQL for SQL Server-Zielinstanz erstellen und konfigurieren.
      • CLOUD_SQL_DB_USERNAME durch den Nutzernamen für die Migration.
      • CLOUD_SQL_DB_USER_PASSWORD durch das Passwort für das Migrationskonto.
Weitere Informationen zu diesen Werten finden Sie unter Übersicht über Verbindungsprofile.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud database-migration connection-profiles \
create sqlserver CONNECTION_PROFILE_ID \
  --no-async
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --gcs-bucket=SOURCE_STORAGE_BUCKET_NAME \
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID \
  --username=CLOUD_SQL_DB_USERNAME \
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows (PowerShell)

gcloud database-migration connection-profiles `
create sqlserver CONNECTION_PROFILE_ID `
  --no-async
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --gcs-bucket=SOURCE_STORAGE_BUCKET_NAME `
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID `
  --username=CLOUD_SQL_DB_USERNAME `
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
create sqlserver CONNECTION_PROFILE_ID ^
  --no-async
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --gcs-bucket=SOURCE_STORAGE_BUCKET_NAME ^
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID ^
  --username=CLOUD_SQL_DB_USERNAME ^
  --password=CLOUD_SQL_DB_USER_PASSWORD

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.

Created 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, löschen Sie zuerst alle Migrationsjobs, die mit dem Verbindungsprofil verknüpft sind.

So löschen Sie ein Verbindungsprofil:

Konsole

  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 bestätigen müssen. Sie können die Bestätigungsaufforderung mit dem optionalen Flag --quiet überspringen.

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

  • REGION mit der 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 Übersicht über Verbindungsprofile.

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 Aufforderung 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 interaktive Bestätigungsaufforderungen der Google Cloud CLI überspringen, indem Sie das optionale Flag --quiet verwenden.