SQL-Datei importieren

Auf dieser Seite wird beschrieben, wie Sie Daten aus einer SQL-Datei, die in einem Cloud Storage-Bucket gespeichert ist, in einen AlloyDB for PostgreSQL-Cluster importieren. SQL-Dateien sind Nur-Text-Dateien mit einer Abfolge von SQL-Befehlen.

Hinweis: Wenn Sie eine gesamte Datenbank von einem unterstützten Datenbankserver (lokal, in AWS oder in AlloyDB) zu einem neuen AlloyDB-Cluster migrieren, können Sie den Database Migration Service verwenden, anstatt Dateien zu exportieren und zu importieren. Wenn Sie aus der importierten Datei einen neuen Cluster erstellen möchten, können Sie stattdessen auch eine Sicherung in einem anderen Cluster wiederherstellen.

Sie können den Datenimport in AlloyDB-Cluster abbrechen. Weitere Informationen finden Sie unter Importvorgang abbrechen.

Achten Sie beim Importieren von SQL-Dumpdateien darauf, dass die PostgreSQL-Version, aus der der Dump erstellt wurde, mit der PostgreSQL-Version Ihrer AlloyDB-Instanz kompatibel ist. Das Importieren einer Dumpdatei aus einer höheren in eine niedrigere Version kann aufgrund inkompatibler SQL-Syntax fehlschlagen.

Hinweise

Vor dem Starten eines Importvorgangs:

• Sorgen Sie dafür, dass in Ihrer Datenbank ausreichend Speicherplatzkontingent vorhanden ist.
• Importvorgänge verwenden Datenbankressourcen, stören den normalen Datenbankbetrieb jedoch nicht, wenn der Cluster nicht unterdimensioniert ist.

Erforderliche Rollen und Berechtigungen für den Import in AlloyDB

Wenn Sie Daten aus Cloud Storage in AlloyDB importieren möchten, muss der Nutzer, der den Import initiiert, eine der folgenden Rollen haben:

• Die Rolle AlloyDB Admin
• Eine benutzerdefinierte Rolle mit den folgenden Berechtigungen:
  • alloydb.clusters.get
  • alloydb.clusters.import

Außerdem muss das Dienstkonto für den AlloyDB-Cluster eine der folgenden Rollen haben:

• storage.objectViewer IAM-Rolle.
• Eine benutzerdefinierte Rolle mit den folgenden Berechtigungen:
  • storage.objects.get

Informationen zu IAM-Rollen finden Sie unter Identity and Access Management.

Hinweis :Es kann einige Minuten dauern, bis die Änderungen in den IAM-Berechtigungen und -Rollen wirksam werden. Weitere Informationen finden Sie unter Zugriffsänderungsverteilung.

SQL-Datei in AlloyDB-Cluster importieren

So importieren Sie Daten aus einer SQL-Datei in einen AlloyDB-Cluster:

Console

1. Rufen Sie die Seite Cluster auf.

   Zu den Clustern

2. Klicken Sie auf einen Clusternamen, um die Seite Übersicht für diesen Cluster zu öffnen.

3. Klicken Sie auf Importieren.

4. Wählen Sie unter Dateiformat die Option SQL aus.

5. Wählen Sie unter Quelldatei auswählen aus, ob Sie Dateien von Ihrem Computer hochladen oder eine Datei aus einem Cloud Storage-Speicherort auswählen möchten.

   1. So laden Sie eine Datei von Ihrem Computer hoch:

      1. Wählen Sie Dateien von Ihrem Computer hochladen aus.
      2. Klicken Sie neben Lokale Datei auswählen auf Durchsuchen, um eine SQL-Datei auf Ihrem lokalen Computer auszuwählen.
      3. Klicken Sie neben Cloud Storage-Speicherort auswählen auf Durchsuchen, um einen Cloud Storage-Speicherort für die hochgeladene lokale Datei auszuwählen.
      4. Klicken Sie auf Hochladen, um die Datei hochzuladen.

   2. So wählen Sie eine SQL-Datei aus, die in einem Cloud Storage-Bucket vorhanden ist:

      1. Wählen Sie Datei aus Google Cloud Storage auswählen aus.
      2. Klicken Sie neben bucket-name/file-name auf Durchsuchen, um eine SQL-Datei aus einem Cloud Storage-Bucket auszuwählen.

6. Wählen Sie im Drop-down-Menü Datenbank die Datenbank aus, in die die Daten importiert werden sollen.

   Dadurch führt AlloyDB vor dem Import die Anweisung USE DATABASE aus. Wenn Ihre SQL-Dumpdatei eine USE DATABASE-Anweisung enthält, wird die in der Google Cloud -Konsole angegebene Datenbank überschrieben.

7. Optional. Wenn Sie einen Nutzer für den Importvorgang angeben möchten, klicken Sie auf Nutzeroptionen einblenden und geben Sie den Nutzernamen in das Feld Nutzer ein.

8. Klicken Sie auf Importieren, um den Importvorgang zu starten.

Hinweis :Sie können eine komprimierte .gz- oder eine unkomprimierte .sql-Datei importieren.

gcloud

1. Cloud Storage-Bucket erstellen

2. Laden Sie die SQL-Datei in Ihren Bucket hoch. Informationen zum Hochladen von Dateien in Buckets finden Sie unter Objekte hochladen.

3. Weisen Sie mit gcloud storage buckets add-iam-policy-binding dem AlloyDB-Clusterdienstkonto für den Bucket die storage.objectViewer IAM-Rolle zu:

   [e-mail]

   Ersetzen Sie die folgenden Werte:

   • CLUSTER_NAME ist der Name des Clusters.
   • REGION: Die Region, in der der AlloyDB-Cluster bereitgestellt wird.
   • BUCKET_NAME: der Name des Cloud Storage-Buckets.
   • FILE_NAME: der Name der CSV-Datei.
   • DATABASE_NAME: Der Name einer Datenbank im Cluster.
   • USER: der Nutzer für den Importvorgang.
   • TABLE_NAME: die Tabelle in der Datenbank.

   Weitere Informationen zum Festlegen von IAM-Berechtigungen finden Sie unter IAM-Berechtigungen verwenden.

4. Importieren Sie die Datei:

   gcloud alloydb clusters import CLUSTER_NAME --region=REGION --database=DATABASE_NAME --gcs-uri='gs://BUCKET_NAME/PATH_TO_SQL_FILE' --user=USERNAME --sql

   Hinweis :Sie können eine komprimierte (.gz) oder eine unkomprimierte (.sql) Datei importieren.

   Wenn durch den Befehl ein Fehler wie PERMISSION_DENIED zurückgegeben wird, prüfen Sie die Berechtigungen.

   Informationen zur Verwendung des Befehls import finden Sie auf der Referenzseite des Befehls alloydb import.

5. Wenn Sie die zuvor festgelegten IAM-Berechtigungen nicht beibehalten möchten, entfernen Sie diese mit gcloud storage buckets remove-iam-policy-binding.

REST Version 1

1. Cloud Storage-Bucket erstellen
2. Laden Sie die SQL-Datei in Ihren Bucket hoch. Informationen zum Hochladen von Dateien in Buckets finden Sie unter Objekte hochladen.

3. Gewähren Sie dem Dienstkonto Berechtigungen für den Cloud Storage-Bucket für den Importvorgang. Verwenden Sie das Dienstkontoformat, um das Dienstkonto für das Projekt zu identifizieren, in das Sie importieren. Das Format für das Dienstkonto ist:

   [e-mail]

4. Weisen Sie mit gcloud storage buckets add-iam-policy-binding die IAM-Rolle storage.objectViewer dem Dienstkonto des AlloyDB-Clusters für den Bucket zu. Weitere Informationen zum Festlegen von IAM-Berechtigungen finden Sie unter IAM-Berechtigungen verwenden.

5. Importieren Sie Ihre SQL-Datei.

   Hinweis :Sie können eine komprimierte (.gz) oder eine unkomprimierte (.sql) Datei importieren.

   Verwenden Sie die folgende HTTP-Methode und URL:

   POST https://alloydbadmin.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID:import

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID: Projekt-ID.
   • LOCATION_ID: Die Region, in der der AlloyDB-Cluster bereitgestellt wird.
   • CLUSTER_ID: die Cluster-ID.
   • BUCKET_NAME: der Name des Cloud Storage-Buckets.
   • PATH_TO_SQL_FILE: der Pfad zur SQL-Datei.
   • USER: der Nutzer, der für den Import verwendet werden soll.
   • DATABASE_NAME: Der Name einer Datenbank im AlloyDB-Cluster.

   JSON-Text der Anfrage:

   {
      "gcsUri": "gs://BUCKET_NAME/PATH_TO_SQL_FILE",
      "database": "DATABASE_NAME",
      "user": "USER",
      "sqlImportOptions": {}
   }
   

   Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

   curl (Linux, macOS oder Cloud Shell)

   Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der Google Cloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

      curl -X POST \
            -H "Authorization: Bearer $(gcloud auth print-access-token)" \
            -H "Content-Type: application/json; charset=utf-8" \
            -d @request.json \
            "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID:import"
   

   PowerShell (Windows)

   Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der Google Cloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
     -Method POST `
     -Headers $headers `
     -ContentType: "application/json; charset=utf-8" `
     -InFile request.json `
     -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID:import"| Select-Object -Expand Content
   

   Sie erhalten eine JSON-Antwort ähnlich der folgenden:

   Antwort

   {
    "name": "projects/project-id/locations/location-id/operations/operation-id",
    "metadata": {
     "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
     "createTime": "2025-01-04T13:12:32.363393723Z",
     "target": "projects/project-id/locations/location-id/clusters/cluster-id",
     "verb": "import",
     "requestedCancellation": false,
     "apiVersion": "v1"
    },
    "done": false
   }
   

   Wenn Sie einen anderen Nutzer für den Import verwenden möchten, geben Sie das Nutzerattribut an.

6. Wenn Sie die zuvor festgelegten IAM-Berechtigungen nicht beibehalten möchten, entfernen Sie diese jetzt.

   Die vollständige Liste der Parameter für die Anfrage finden Sie unter clusters:import.

Status eines Importvorgangs prüfen

So prüfen Sie den Status eines Importvorgangs:

gcloud

Führen Sie dazu den folgenden gcloud alloydb operations describe-Befehl aus:

gcloud alloydb operations describe OPERATION_ID --region=REGION

Sie können auch Details eines bestimmten Vorgangs auflisten lassen oder einen bestimmten Vorgang abbrechen. Weitere Informationen zu diesem Befehl finden Sie auf der Referenzseite zum gcloud alloydb operations-Befehl.

REST Version 1

Verwenden Sie die Methode GET und die folgende URL:

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID

Weitere Informationen finden Sie unter get.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• REGION: Die Region, in der der AlloyDB-Cluster bereitgestellt wird.
• PROJECT_ID: Projekt-ID.
• OPERATION_ID: die ID des Importvorgangs. Weitere Informationen finden Sie unter Vorbereitung.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

  curl -X GET \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID
 

PowerShell (Windows)

Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID | Select-Object -Expand Content

Sie erhalten eine JSON-Antwort ähnlich der folgenden:

Bei erfolgreicher Ausführung enthält der Antworttext eine Instanz von Operation.

Nächste Schritte

• CSV-Datei importieren
• Importvorgang abbrechen