Importare un file SQL

Per ricostruire un database da uno script di testo normale di comandi SQL, puoi importare un file SQL archiviato in un bucket Cloud Storage in un cluster AlloyDB per PostgreSQL.

Nota: se esegui la migrazione di un intero database da un server di database supportato (on-premise, in AWS o AlloyDB) a un nuovo cluster AlloyDB, puoi utilizzare Database Migration Service anziché esportare e poi importare i file. Se stai importando perché vuoi creare un nuovo cluster dal file importato, valuta la possibilità di eseguire il ripristino da un backup in un cluster diverso.

Puoi annullare l'importazione dei dati nei cluster AlloyDB. Per saperne di più, consulta Annulla un'operazione di importazione.

Quando importi i file di dump SQL, assicurati che la versione di PostgreSQL da cui è stato creato il dump sia compatibile con la versione di PostgreSQL della tua istanza AlloyDB. L'importazione di un file di dump da una versione successiva a una precedente potrebbe non riuscire a causa di una sintassi SQL incompatibile.

Prima di iniziare

Prima di iniziare un'operazione di importazione:

• Assicurati che il tuo database abbia una quota di spazio di archiviazione adeguata.
• Le operazioni di importazione utilizzano le risorse del database, ma non interferiscono con le normali operazioni del database, a meno che il provisioning del cluster non sia insufficiente.

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 avere uno dei seguenti ruoli:

• Il ruolo AlloyDB Admin
• Un ruolo personalizzato, che include le seguenti autorizzazioni:
  • alloydb.clusters.get
  • alloydb.clusters.import

Inoltre, il account di servizio del cluster AlloyDB deve avere uno dei seguenti ruoli:

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

Per assistenza con i ruoli IAM, consulta Identity and Access Management.

Nota: Le modifiche apportate alle autorizzazioni e ai ruoli IAM potrebbero richiedere alcuni minuti per avere effetto. Per scoprire di più, consulta Propagazione della modifica di accesso.

Importa un file SQL nei cluster AlloyDB

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

Console

1. Nella console Google Cloud , 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 Formato file, seleziona SQL.

5. In Seleziona file di origine, scegli se caricare i file dal computer o selezionare un file da una posizione di Cloud Storage.

   1. Per caricare un file dal computer:

      1. Seleziona Carica file dal tuo computer.
      2. Fai clic su Sfoglia accanto a Seleziona file locale per selezionare un file SQL dalla tua macchina locale.
      3. Fai clic su Sfoglia accanto a Seleziona la località di Cloud Storage per selezionare una località di Cloud Storage in cui archiviare il file locale caricato.
      4. Fai clic su Carica per caricare il file.

   2. Per selezionare un file SQL presente in un bucket Cloud Storage, segui questi passaggi:

      1. Seleziona Seleziona il file da Google Cloud Storage.
      2. Fai clic su Sfoglia accanto a bucket-name/file-name per selezionare un file SQL da un bucket Cloud Storage.

6. Seleziona il database in cui vuoi importare i dati dal menu a discesa Database.

   Se il file di dump SQL include un metacomando \connect (o \c), esegue l'override del database di destinazione selezionato nella console Google Cloud .

7. (Facoltativo) Per specificare un utente per l'operazione di importazione, fai clic su Mostra opzioni utente e inserisci il nome utente nel campo Utente.

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

Nota: puoi importare un file .gz compresso o un file .sql non compresso.

gcloud

1. Crea un bucket Cloud Storage.

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

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

   [e-mail]

   Per assistenza con l'impostazione delle autorizzazioni IAM, consulta Utilizzo delle 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

   Nota: puoi importare un file compresso (.gz) o non compresso (.sql).

   Sostituisci quanto segue:

   • CLUSTER_NAME: il nome del cluster.
   • REGION: la regione in cui è stato eseguito il deployment del cluster AlloyDB.
   • DATABASE_NAME: il nome di un database all'interno del cluster.
   • BUCKET_NAME: il nome del bucket Cloud Storage.
   • PATH_TO_SQL_FILE: il percorso del file SQL.
   • USERNAME: l'utente per l'operazione di importazione.

   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 gcloud alloydb clusters import.

5. Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, 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 Caricamento di oggetti.

3. Utilizza gcloud storage buckets add-iam-policy-binding per concedere il ruolo IAM storage.objectViewer al account di servizio del cluster AlloyDB per il bucket. Il formato del account di servizio è il seguente:

   [e-mail]

   Per assistenza con l'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.

4. Importa il file SQL.

   Nota: puoi importare un file compresso (.gz) o non compresso (.sql).

   Utilizza il seguente metodo HTTP e URL:

   POST https://alloydb.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 è stato eseguito il deployment del 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)

   Il comando seguente presuppone che tu abbia eseguito l'accesso a Google Cloud CLI con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che esegue automaticamente l'accesso a gcloud CLI. Puoi controllare l'account attivo eseguendo gcloud auth list.

   Salva il corpo della richiesta in un file denominato request.json ed esegui questo 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)

   Il comando seguente presuppone che tu abbia eseguito l'accesso a Google Cloud CLI con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che esegue automaticamente l'accesso a gcloud CLI. Puoi controllare l'account attivo eseguendo gcloud auth list.

   Salva il corpo della richiesta in un file denominato request.json ed esegui questo 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
   

   Ricevi 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à dell'utente.

5. Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, rimuovile.

   Per l'elenco completo dei parametri della richiesta, consulta clusters.import.

Controlla lo stato di un'operazione di importazione

Per controllare lo stato di un'operazione di importazione, segui questi passaggi:

gcloud

Esegui questo comando utilizzando gcloud alloydb operations describe:

gcloud alloydb operations describe OPERATION_ID --region=REGION

Puoi anche elencare i dettagli di un'operazione specifica o annullarla. 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 saperne di più, consulta get.

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

• REGION: la regione in cui è stato eseguito il deployment del cluster AlloyDB.
• PROJECT_ID: l'ID progetto
• OPERATION_ID: l'ID dell'operazione di importazione. Per saperne di più, consulta Prima di iniziare.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Il comando seguente presuppone che tu abbia eseguito l'accesso a gcloud CLI con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che esegue automaticamente l'accesso a gcloud CLI. Puoi controllare l'account attivo eseguendo gcloud auth list.

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)

Il comando seguente presuppone che tu abbia eseguito l'accesso a gcloud CLI con il tuo account utente eseguendo gcloud init o gcloud auth login. Puoi controllare l'account attivo eseguendo gcloud auth list.

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

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

Passaggi successivi

• Scopri come importare un file CSV.
• Scopri come annullare un'operazione di importazione.