Aus einer Dumpdatei importieren

Bevor Sie Daten importieren, müssen Sie Folgendes tun:

  1. Erstellen Sie einen Datenbankcluster, in den die Daten importiert werden sollen.

  2. Laden Sie die Dumpdatei in einen Storage-Bucket hoch. Eine Anleitung finden Sie unter Objekte in Storage-Buckets hochladen.

  3. Gewähren Sie dem Importdienstkonto des Datenbankdienstes Lesezugriff auf die Dumpdatei. Weitere Informationen finden Sie unter Speicherzugriff gewähren und erhalten. Sie können dem Importdienstkonto beispielsweise die Rolle project-bucket-object-viewer zuweisen.

    Das Database Service-System erstellt dieses Dienstkonto automatisch, wenn der Datenbankcluster erstellt wird. Der Status des Datenbankclusters enthält sowohl den Namen als auch den Namespace des Importdienstkontos.

    Führen Sie den folgenden Befehl aus, um den Namen und den Namespace des Importdienstkontos abzurufen:

    kubectl --kubeconfig=MGMT_API_KUBECONFIG \
  get dbcluster.postgresql -n PROJECT_ID DATABASE_CLUSTER_NAME \
  -o jsonpath='{.status.serviceAccounts.import}'

    Dieser Befehl gibt ein JSON-Objekt mit den Details zu Name und Namespace zurück: {"name":"postgresql-import-DATABASE_CLUSTER_NAME","namespace":"SERVICE_ACCOUNT_NAMESPACE"}

WARNUNG: Die Datenbank-Dumpdatei muss mit pg_dump in einem Archivformat erstellt werden, das mit pg_restore kompatibel ist. Dumps im Nur-SQL-Format (Standard, wenn keine Formatoption angegeben ist) werden nicht unterstützt.

Sie können eine Dumpdatei entweder über die GDC-Konsole oder die Distributed Cloud CLI in einen Datenbankcluster importieren:

Console

  1. Öffnen Sie in der GDC-Konsole die Seite Datenbankcluster-Übersicht, um den Cluster mit der Datenbank aufzurufen, die Sie importieren.

  2. Klicken Sie auf Importieren. Der Bereich Daten in Konten importieren wird geöffnet.

  3. Geben Sie im Bereich Daten in Konten importieren im Abschnitt Quelle den Speicherort der zuvor hochgeladenen SQL-Datendumpdatei an.

  4. Geben Sie im Feld Ziel eine vorhandene Zieldatenbank für den Import an.

  5. Klicken Sie auf Importieren. In einem Banner in der GDC-Konsole wird der Status des Imports angezeigt.

gdcloud

  1. Bevor Sie die Distributed Cloud CLI verwenden, müssen Sie sie installieren und initialisieren. Authentifizieren Sie sich dann bei Ihrer Organisation.

  2. Führen Sie den folgenden Befehl aus, um eine Dumpdatei in eine Datenbank zu importieren:

    gdcloud database import sql DATABASE_CLUSTER BUCKET_NAME/sample.dmp \
    --project=PROJECT_NAME

    Ersetzen Sie Folgendes:

    • DATABASE_CLUSTER durch den Namen des Datenbankclusters, in den Daten importiert werden sollen.
    • BUCKET_NAME/SAMPLE.dmp durch den Speicherort der Dumpdatei.
    • PROJECT_NAME durch den Namen des Projekts, in dem sich der Datenbankcluster befindet.

  3. Führen Sie den folgenden Befehl aus, um den Status des Imports zu prüfen:

    gdcloud database operations list --project=PROJECT_NAME --cluster=DATABASE_CLUSTER

API

apiVersion: postgresql.dbadmin.gdc.goog/v1
kind: Import
metadata:
  name: IMPORT_NAME
  namespace: USER_PROJECT
spec:
  dbclusterRef: DBCLUSTER_NAME
  dumpStorage:
    s3Options:
      bucket: BUCKET_NAME
      key: DUMP_FILE_PATH
    type: S3

Ersetzen Sie die folgenden Variablen:

  • IMPORT_NAME: der Name des Importvorgangs.
  • USER_PROJECT: Der Name des Nutzerprojekts, in dem der zu importierende Datenbankcluster erstellt wird.
  • DBCLUSTER_NAME: Der Name des Datenbankclusters.
  • BUCKET_NAME: der Name des Objektspeicher-Buckets, in dem die Importdateien gespeichert sind.
  • DUMP_FILE_PATH: der Name des Objektspeicherpfads zu den gespeicherten Dateien.