Esportazione e importazione mediante file di dump SQL

MySQL   |  PostgreSQL   |  SQL Server

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

Nota: L'importazione da un file SQL è molto più lenta ed è più adatto a un sottoinsieme di dati o ad alcune tabelle di piccole dimensioni. L'importazione da un file SQL è soggetta a errori a causa della sintassi, delle dimensioni del file o . Se esegui l'esportazione per creare una nuova istanza dal file file, considera ripristino da un backup a un'altra istanza o clonando l'istanza.

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

Prima di iniziare

Importante: prima di iniziare un'esportazione di grandi dimensioni, assicurati che almeno il 25% della dimensione del database è libera (nell'istanza). Ciò aiuta a prevenire a una crescita automatica aggressiva, che può influire sulla disponibilità dell'istanza.

Le esportazioni utilizzano risorse di database, ma non interferiscono con il normale database a meno che l'istanza non abbia un underprovisioning.

Per le best practice, vedi Best practice per l'importazione e Esportazione dei dati.

Dopo aver completato un'operazione di importazione, verifica il che consentono di analizzare i dati e visualizzare i risultati.

Esporta dati da Cloud SQL per SQL Server

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

Importa i dati in Cloud SQL per SQL Server

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

Per importare dati da Cloud Storage a Cloud SQL, l'utente che avvia l'importazione deve avere uno dei seguenti ruoli:

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

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

• Il ruolo IAM storage.objectAdmin
• Un ruolo personalizzato che includa le seguenti autorizzazioni:
  • storage.objects.get
  • storage.objects.list (solo per l'importazione a righe)

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

Nota: le modifiche apportate alle autorizzazioni e ai ruoli IAM potrebbero richiedere alcuni minuti prima che le modifiche diventino effettive. Per ulteriori informazioni, vedi Propagazione delle modifiche dell'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 che è stato esportato da una versione superiore di SQL Server o eseguire l'importazione da un livello di compatibilità superiore in uno inferiore. Ad esempio, se hai esportato un file SQL Server 2017 non è possibile 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 al bucket e al file di dump SQL da utilizzare per l'importazione oppure passa a un .

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

5. In Formato, seleziona SQL.

6. Seleziona il database in cui importare i dati.

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

   Se il file di dump SQL include una USE DATABASE, esegue l'override del database impostato nell'istruzione USE DATABASE la console Google Cloud.

7. Se vuoi specificare un utente che esegua l'importazione, seleziona l'utente.

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

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

gcloud

1. Crea un bucket Cloud Storage.

2. Carica il file nel bucket.

   Per informazioni sul caricamento di file nei bucket, consulta Caricamento di oggetti.

3. Descrivi l'istanza in cui esegui l'importazione:

   gcloud sql instances describe INSTANCE_NAME
   

4. Copia il campo serviceAccountEmailAddress.
5. Usa gsutil iam per concedere storage.objectAdmin ruolo IAM per l'account di servizio per il bucket.

   gsutil iam ch serviceAccount:SERVICE-ACCOUNT:objectAdmin \
   gs://BUCKET_NAME
     

   Per assistenza sull'impostazione 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 le sql import sql pagina di riferimento per i comandi.

   Se il comando restituisce un errore come ERROR_RDBMS, esamina il autorizzazioni; questo errore è spesso dovuto a problemi di autorizzazioni.

7. Se non devi conservare le autorizzazioni IAM, impostati in precedenza, rimuovili utilizzando gsutil iam.

REST v1

1. Crea un bucket Cloud Storage.

2. Carica il file nel bucket.

   Per informazioni sul caricamento di file nei bucket, consulta Caricamento di oggetti.

3. Fornisci alla tua istanza legacyBucketWriter e objectViewer ruoli IAM per i tuoi di sincronizzare la directory di una VM con un bucket. Per assistenza sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
4. Importa il file di dump:

   Prima di utilizzare i dati della richiesta, effettua 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 delle seguenti opzioni:

   curl (Linux, macOS o Cloud Shell)

   Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti 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. 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://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import"

   PowerShell (Windows)

   Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'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. 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://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, vedi pagina instances:import.
5. Se non devi conservare le autorizzazioni IAM, impostate in precedenza, rimuovile ora.

REST v1beta4

1. Crea un bucket Cloud Storage.

2. Carica il file nel bucket.

   Per informazioni sul caricamento di file nei bucket, consulta Caricamento di oggetti.

3. Fornisci alla tua istanza storage.objectAdmin ruolo IAM per di sincronizzare la directory di una VM con un bucket. Per assistenza sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
4. Importa il file di dump:

   Prima di utilizzare i dati della richiesta, effettua 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 delle seguenti opzioni:

   curl (Linux, macOS o Cloud Shell)

   Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti 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. 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://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 a l'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. 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://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, vedi pagina instances:import.
5. Se non devi conservare le autorizzazioni IAM, impostate 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 relativi a importazioni ed esportazioni.