Importare un file SQL

Questa pagina descrive come importare i dati da un file SQL archiviato in un bucket Cloud Storage in un cluster AlloyDB per PostgreSQL. I file SQL sono file di testo normale con una sequenza di comandi SQL.

Puoi annullare l'importazione dei dati nei cluster AlloyDB. Per ulteriori informazioni, consulta la sezione Annullare un'operazione di importazione.

Prima di iniziare

Prima di iniziare un'operazione di importazione:

  • Assicurati che il database abbia spazio libero sufficiente.
  • Le operazioni di importazione utilizzano le risorse del database, ma non interferendo con le normali operazioni del database, a meno che il cluster non sia sottodimensionato.

Ruoli e autorizzazioni richiesti per l'importazione in AlloyDB

Per importare i dati da Cloud Storage in AlloyDB, l'utente che avvia l'importazione deve disporre di uno dei seguenti ruoli:

Inoltre, l'account di servizio per il cluster AlloyDB deve avere uno dei seguenti ruoli:

  • Il ruolo IAM storage.objectViewer
  • Un ruolo personalizzato, che include le seguenti autorizzazioni:
    • storage.objects.get

Per assistenza sui ruoli IAM, consulta Identity and Access Management.

Importa un file SQL nei cluster AlloyDB

Per importare dati in un cluster AlloyDB utilizzando un file SQL, segui questi passaggi:

Console

  1. Vai alla pagina Cluster.

    Vai a Cluster

  2. Fai clic sul nome di un cluster per aprire la pagina Panoramica del cluster.

  3. Fai clic su Importa.

  4. In Scegli il file dal quale vuoi importare i dati, inserisci il percorso al bucket e al file SQL da utilizzare per l'importazione oppure vai a un file esistente.

  5. Seleziona il database in cui vuoi importare i dati.

    In questo modo, AlloyDB esegue l'istruzione USE DATABASE prima dell'importazione. Se il file dump SQL include un'istruzione USE DATABASE, sostituisce il database impostato nella console Google Cloud.

  6. (Facoltativo) Specifica un utente per l'operazione di importazione. Se il file di importazione contiene istruzioni che devono essere eseguite da un utente specifico, utilizza questo campo per specificare l'utente.

  7. Per avviare l'operazione di importazione, fai clic su Importa.

gcloud

  1. Crea un bucket Cloud Storage.

  2. Carica il file SQL nel bucket. Per assistenza sul caricamento di file nei bucket, consulta Caricare oggetti.

  3. Utilizza gcloud storage buckets add-iam-policy-binding per concedere il storage.objectViewer ruolo IAM all'account di servizio del cluster AlloyDB per il bucket:

    service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com

    Esegui le seguenti sostituzioni:

    • CLUSTER_NAME: il nome del cluster.
    • REGION: la regione in cui è dipiegato il cluster AlloyDB.
    • BUCKET_NAME: il nome del bucket Cloud Storage.
    • FILE_NAME: il nome del file CSV.
    • DATABASE_NAME: il nome di un database all'interno del cluster.
    • USER: l'utente per l'operazione di importazione.
    • TABLE_NAME: la tabella all'interno del database.

    Per assistenza sull'impostazione delle autorizzazioni IAM, consulta Utilizzare le autorizzazioni IAM.

  4. Importa il file:

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

    Se il comando restituisce un errore come PERMISSION_DENIED, controlla le autorizzazioni.

    Per informazioni sull'utilizzo del comando import, consulta la pagina di riferimento del comando alloydb import.

  5. Se non devi conservare le autorizzazioni IAM impostate precedentemente, rimuovile utilizzando gcloud storage buckets remove-iam-policy-binding.

REST v1

  1. Crea un bucket Cloud Storage.
  2. Carica il file SQL nel bucket. Per assistenza sul caricamento di file nei bucket, consulta Caricare oggetti.

  3. Concedi le autorizzazioni dell'account di servizio al bucket Cloud Storage per l'operazione di importazione. Utilizza il formato dell'account di servizio per identificare l'account di servizio per il progetto in cui stai eseguendo l'importazione. Il formato del service account è il seguente:

    service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com

  4. Utilizza gcloud storage buckets add-iam-policy-binding per concedere il storage.objectViewer ruolo IAM all'account di servizio del cluster AlloyDB per il bucket. Per assistenza sull'impostazione delle autorizzazioni IAM, consulta Utilizzare le autorizzazioni IAM.

  5. Importa il file SQL.

    Utilizza il seguente metodo e URL HTTP:

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

    Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

    • PROJECT_ID: l'ID progetto.
    • LOCATION_ID: la regione in cui è dipiegato il cluster AlloyDB.
    • CLUSTER_ID: l'ID cluster.
    • BUCKET_NAME: il nome del bucket Cloud Storage.
    • PATH_TO_SQL_FILE: il percorso del file SQL.
    • USER: l'utente da utilizzare per l'importazione.
    • DATABASE_NAME: il nome di un database all'interno del cluster AlloyDB.

    Corpo JSON della richiesta:

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

    Per inviare la richiesta, espandi una di queste opzioni:

    curl (Linux, macOS o Cloud Shell)

    Salva il corpo della richiesta in un file denominato request.json ed esegui il seguente comando:

       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)

    Salva il corpo della richiesta in un file denominato request.json esegui il seguente comando:

    $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

    Riceverai una risposta JSON simile alla seguente:

    Risposta

    {
 "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
}

    Per utilizzare un utente diverso per l'importazione, specifica la proprietà utente.

  6. Se non devi conservare le autorizzazioni IAM impostate in precedenza, rimuovile ora.

    Per l'elenco completo dei parametri per la richiesta, consulta clusters:import.

Controllare lo stato di un'operazione di importazione

Per controllare lo stato di un'operazione di importazione:

gcloud

Esegui quanto segue utilizzando il comando gcloud alloydb operations describe:

gcloud alloydb operations describe OPERATION_ID --region=REGION

Puoi anche elencare i dettagli di un'operazione specifica o annullarne una. Per ulteriori informazioni su questo comando, consulta la pagina di riferimento del comando gcloud alloydb operations.

REST v1

Utilizza il metodo GET e il seguente URL:

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

Per ulteriori informazioni, vedi get.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • REGION: la regione in cui è dipiegato il cluster AlloyDB.
  • PROJECT_ID: l'ID progetto.
  • OPERATION_ID: l'ID dell'operazione di importazione. Per maggiori informazioni, consulta Prima di iniziare.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

  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)

Esegui questo comando:

$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

Riceverai una risposta JSON simile alla seguente:

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Passaggi successivi