Quellverbindungsprofil erstellen

In Verbindungsprofilen werden Kennungen und Anmeldedaten für die Verbindung zu Ihren Quelldatenbanken erfasst. Jedes Verbindungsprofil enthält die Mindestmenge an Informationen, die Database Migration Service benötigt, um die Datenübertragung zwischen der Datenquelle und dem Ziel zu ermöglichen.

So erstellen Sie ein Quellverbindungsprofil:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Verbindungsprofile auf.
  2. Klicken Sie auf Profil erstellen.
  3. Wählen Sie auf der Seite Neues Verbindungsprofil erstellen in der Liste Profilrolle die Option Quelle aus.
  4. Wählen Sie in der Liste Datenbankmodul das Quelldatenbankmodul aus.
  5. Geben Sie im Feld Name des Verbindungsprofils einen menschenlesbaren Namen für das Verbindungsprofil ein. Dieser Wert wird in der Liste der Verbindungsprofile angezeigt.
  6. Behalten Sie die automatisch generierte Verbindungsprofil-ID bei.
  7. Geben Sie einen Hostnamen oder eine IP-Adresse ein.
    • Der hier verwendete Wert hängt von der Verbindungsmethode ab, die Sie für die Migration verwenden. Wenn die Quelldatenbank beispielsweise in Google Cloudgehostet wird oder ein Reverse-SSH-Tunnel verwendet wird, um den Zielcluster mit der Quelldatenbank zu verbinden, geben Sie die private (interne) IP-Adresse für die Quelldatenbank an. Weitere Informationen finden Sie unter Netzwerkverbindung – Übersicht.

    • Geben Sie für Migrationen, die über das öffentliche Internet mithilfe einer IP-Zulassungsliste verbunden werden, die öffentliche IP-Adresse der Quelldatenbank an.
  8. Geben Sie den Port ein, der für den Zugriff auf den Host verwendet wird. Der Standard-PostgreSQL-Port ist 5432.
  9. Geben Sie einen Nutzernamen und ein Passwort für die Quelldatenbank ein. Der Nutzer muss die erforderlichen Replikationsberechtigungen für Ihre Quelldatenbank haben. Weitere Informationen finden Sie unter Quelldatenbank konfigurieren.
  10. Wählen Sie im Abschnitt Region für Verbindungsprofil der Seite die Region aus, in der Sie das Verbindungsprofil speichern möchten.
  11. Optional: Wenn die Verbindung über ein öffentliches Netzwerk (mithilfe von IP-Zulassungslisten) hergestellt wird, empfehlen wir, die SSL/TLS-Verschlüsselung für die Verbindung zwischen den Quell- und Zieldatenbanken zu konfigurieren.

    Wählen Sie im Abschnitt Verbindung sichern eine der folgenden SSL/TLS-Konfigurationsoptionen aus:

    • Keine: Der AlloyDB for PostgreSQL-Zielcluster stellt ohne Verschlüsselung eine Verbindung zur Quelldatenbank her.
    • TLS-Authentifizierung: Wenn der AlloyDB for PostgreSQL-Zielcluster eine Verbindung zur Quelldatenbank herstellt, authentifiziert der Cluster die Quelle und stellt so sicher, dass der Cluster eine sichere Verbindung zum richtigen Host herstellt. Wenn Sie die TLS-Authentifizierung verwenden möchten, müssen Sie das x509-PEM-codierte Zertifikat der Zertifizierungsstelle angeben, die das Zertifikat des Quellservers signiert hat.
    • mTLS-Authentifizierung: Wenn der Zielcluster eine Verbindung zur Quelle herstellt, authentifiziert der Cluster die Quelle und die Quelle den Cluster. Wenn Sie die mTLS-Authentifizierung verwenden möchten, müssen Sie Folgendes angeben:
      • Das Zertifikat der CA, die das Zertifikat des Quelldatenbankservers signiert hat (das CA-Zertifikat)
      • Das Zertifikat, das vom Cluster zur Authentifizierung beim Quelldatenbankserver verwendet wird (das Clientzertifikat).
      • Der private Schlüssel, der mit dem Clientzertifikat verknüpft ist (der Clientschlüssel).
  12. Klicken Sie auf Erstellen.

    Die Seite Verbindungsprofile wird angezeigt und das neu erstellte Verbindungsprofil wird aufgeführt.

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:

  • SOURCE_CONN_ID durch die Kennung Ihres Quellverbindungsprofils.
  • REGION durch die Region, in der Sie das Verbindungsprofil speichern möchten.
  • SOURCE_IP_ADDRESS durch die IP-Adresse Ihrer Quelldatenbank.
  • SOURCE_PORT durch den Port Ihrer Quelldatenbank (Standard ist 5432).
  • SOURCE_USER durch den Nutzernamen des Migrationsnutzers in Ihrer Quelldatenbank.
  • SOURCE_PASSWORD durch das Passwort des Migrationsnutzers in Ihrer Quelldatenbank.
  • Optional: Wenn Sie zusätzliche Einstellungen für das Quellverbindungsprofil konfigurieren möchten, können Sie die folgenden Flags übergeben:
    • --display-name: Ein menschenlesbarer Name für das Verbindungsprofil.
    • --cloudsql-instance: Die ID Ihrer Cloud SQL for PostgreSQL-Quellinstanz, wenn Ihre Quelle Cloud SQL for PostgreSQL ist.
    • --ssl-type: Der SSL/TLS-Verschlüsselungstyp für die Verbindung zur Quelldatenbank (NONE, SERVER_ONLY für die TLS-Authentifizierung mit --ca-certificate oder SERVER_CLIENT für die mTLS-Authentifizierung mit --ca-certificate, --client-certificate und --private-key).

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud database-migration connection-profiles create postgresql \
  SOURCE_CONN_ID \
  --region=REGION \
  --role=SOURCE \
  --host=SOURCE_IP_ADDRESS \
  --port=SOURCE_PORT \
  --username=SOURCE_USER \
  --password=SOURCE_PASSWORD \
  --no-async

Windows (PowerShell)

gcloud database-migration connection-profiles create postgresql `
  SOURCE_CONN_ID `
  --region=REGION `
  --role=SOURCE `
  --host=SOURCE_IP_ADDRESS `
  --port=SOURCE_PORT `
  --username=SOURCE_USER `
  --password=SOURCE_PASSWORD `
  --no-async

Windows (cmd.exe)

gcloud database-migration connection-profiles create postgresql ^
  SOURCE_CONN_ID ^
  --region=REGION ^
  --role=SOURCE ^
  --host=SOURCE_IP_ADDRESS ^
  --port=SOURCE_PORT ^
  --username=SOURCE_USER ^
  --password=SOURCE_PASSWORD ^
  --no-async

Sie sollten eine Antwort ähnlich der folgenden erhalten:

Waiting for connection profile [SOURCE_CONN_ID]
to be created with [OPERATION_ID]

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

Created connection profile SOURCE_CONN_ID [OPERATION_ID]

Nächste Schritte