Esportazione e importazione mediante file di dump SQL

MySQL   |  PostgreSQL   |  SQL Server

Questa pagina descrive l'esportazione e l'importazione di dati nelle istanze Cloud SQL utilizzando file di dump SQL.

Nota:l'importazione da un file SQL è molto più lenta ed è più adatta a un sottoinsieme di dati o a poche tabelle di piccole dimensioni. L'importazione da un file SQL è soggetta a errori a causa di sintassi, dimensioni o formato del file. Se esegui l'esportazione per creare una nuova istanza dal file esportato, valuta la possibilità di eseguire il ripristino da un backup in un'altra istanza o clonare l'istanza.

L'esportazione da Cloud SQL a un file di dump SQL non è supportata per SQL Server.

Prima di iniziare

Importante: prima di avviare un'esportazione di grandi dimensioni, assicurati che almeno il 25% delle dimensioni del database sia libero (sull'istanza). In questo modo, si evitano problemi di crescita automatica aggressiva, che possono influire sulla disponibilità dell'istanza.

Le esportazioni utilizzano le risorse del database, ma non interferiscono con le normali operazioni del database, a meno che l'istanza non sia sottoprovisionata.

Per le best practice, consulta Best practice per l'importazione e l'esportazione dei dati.

Dopo aver completato un'operazione di importazione, verifica i risultati.

Esportare dati da Cloud SQL per SQL Server

L'esportazione da Cloud SQL a un file di dump SQL non è supportata per SQL Server.

Importare dati in Cloud SQL per SQL Server

Ruoli e autorizzazioni richiesti per l'importazione in Cloud SQL per SQL Server

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

• Il ruolo Amministratore Cloud SQL
• Un ruolo personalizzato, incluse le seguenti autorizzazioni:
  • cloudsql.instances.get
  • cloudsql.instances.import

Inoltre, il account di servizio dell'istanza Cloud SQL deve avere uno dei seguenti ruoli:

• Ruolo IAM storage.objectAdmin
• Un ruolo personalizzato, incluse le seguenti autorizzazioni:
  • storage.objects.get
  • storage.objects.list (solo per l'importazione a strisce)

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

Nota: l'applicazione delle modifiche apportate alle autorizzazioni e ai ruoli IAM potrebbe richiedere alcuni minuti. Per saperne di più, consulta Propagazione della modifica di accesso.

Importa un file di dump SQL in Cloud SQL per SQL Server

I file SQL sono file di testo normale con una sequenza di comandi SQL.

Nella procedura seguente, preparati a specificare un database esistente da cui importare i file SQL.

Nota:non puoi importare un database esportato da una versione successiva di SQL Server o importare da un livello di compatibilità superiore a uno inferiore. Ad esempio, se hai esportato una versione di SQL Server 2017, non puoi importarla in una versione di SQL Server 2014.

Console

1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
3. Fai clic su Importa.
4. Nella sezione Scegli il file da cui importare i dati, inserisci il percorso del bucket e del file di dump SQL da utilizzare per l'importazione oppure cerca un file esistente.

   Puoi importare un file compresso (.gz) o non compresso (.sql).

5. Per Formato, seleziona SQL.

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

   In questo modo, Cloud SQL esegue l'istruzione USE DATABASE prima dell'importazione.

   Se il file di dump SQL include un'istruzione USE DATABASE, questa sostituisce il database impostato nella console Google Cloud .

7. Se vuoi specificare un utente per eseguire l'importazione, seleziona l'utente.

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

8. Fai clic su Importa per avviare l'importazione.

gcloud

1. Crea un bucket Cloud Storage.

2. Carica il file nel bucket.

   Per assistenza con il caricamento di file nei bucket, consulta Caricamento di oggetti.

3. Descrivi l'istanza in cui stai importando:

   gcloud sql instances describe INSTANCE_NAME

4. Copia il campo serviceAccountEmailAddress.
5. Utilizza gcloud storage buckets add-iam-policy-binding per concedere il storage.objectAdmin ruolo IAM all'account di servizio per il bucket.

   gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
     --member=serviceAccount:SERVICE-ACCOUNT \
     --role=roles/storage.objectAdmin
     

   Per assistenza con la configurazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
6. Importa il database:

   gcloud sql import sql INSTANCE_NAME gs://BUCKET_NAME/IMPORT_FILE_NAME \
   --database=DATABASE_NAME

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

   Se il comando restituisce un errore come ERROR_RDBMS, controlla le autorizzazioni. Questo errore è spesso dovuto a problemi di autorizzazioni.

7. Se non devi conservare le autorizzazioni IAM che hai impostato in precedenza, rimuovile utilizzando gcloud storage buckets remove-iam-policy-binding.

REST v1

1. Crea un bucket Cloud Storage.

2. Carica il file nel bucket.

   Per assistenza con il caricamento di file nei bucket, consulta Caricamento di oggetti.

3. Fornisci alla tua istanza i legacyBucketWriter e objectViewer ruoli IAM per il tuo bucket. Per assistenza con la configurazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
4. Importa il file di dump:

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

   • project-id: l'ID progetto
   • instance-id: l'ID istanza
   • bucket_name: Il nome del bucket Cloud Storage
   • path_to_sql_file: il percorso del file SQL
   • database_name: il nome di un database all'interno dell'istanza Cloud SQL

   Metodo HTTP e URL:

   POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import

   Corpo JSON della richiesta:

   {
    "importContext":
      {
         "fileType": "SQL",
         "uri": "gs://bucket_name/path_to_sql_file",
         "database": "database_name"
       }
   }
   
   

   Per inviare la richiesta, espandi una di queste opzioni:

   curl (Linux, macOS o Cloud Shell)

   Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import"

   PowerShell (Windows)

   Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

   $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://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import" | Select-Object -Expand Content

   Dovresti ricevere una risposta JSON simile alla seguente:

   Risposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

   Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:import.
5. Se non hai bisogno di conservare le autorizzazioni IAM che hai impostato in precedenza, rimuovile ora.

REST v1beta4

1. Crea un bucket Cloud Storage.

2. Carica il file nel bucket.

   Per assistenza con il caricamento di file nei bucket, consulta Caricamento di oggetti.

3. Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per assistenza con la configurazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
4. Importa il file di dump:

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

   • project-id: l'ID progetto
   • instance-id: l'ID istanza
   • bucket_name: Il nome del bucket Cloud Storage
   • path_to_sql_file: il percorso del file SQL
   • database_name: il nome di un database all'interno dell'istanza Cloud SQL

   Metodo HTTP e URL:

   POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import

   Corpo JSON della richiesta:

   {
    "importContext":
      {
         "fileType": "SQL",
         "uri": "gs://bucket_name/path_to_sql_file",
         "database": "database_name"
       }
   }
   
   

   Per inviare la richiesta, espandi una di queste opzioni:

   curl (Linux, macOS o Cloud Shell)

   Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import"

   PowerShell (Windows)

   Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

   $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://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import" | Select-Object -Expand Content

   Dovresti ricevere una risposta JSON simile alla seguente:

   Risposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

   Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:import.
5. Se non hai bisogno di conservare le autorizzazioni IAM che hai impostato in precedenza, rimuovile ora.

Passaggi successivi

• Scopri come controllare lo stato delle operazioni di importazione ed esportazione.
• Scopri di più sulle best practice per l'importazione e l'esportazione dei dati.
• Scopri di più su Cloud Storage.
• Problemi noti per importazioni ed esportazioni.