Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Esportazione e importazione mediante file BAK e file di log delle transazioni

MySQL | PostgreSQL | SQL Server

Questa pagina descrive l'esportazione e l'importazione di dati nelle istanze Cloud SQL utilizzando i file BAK e l'importazione di dati nelle istanze Cloud SQL utilizzando i file di log delle transazioni.

Prima di iniziare

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

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.

Esporta i dati da Cloud SQL per SQL Server

Cloud SQL supporta l'esportazione di file BAK integrati.

Se vuoi creare una nuova istanza da un file esportato, valuta la possibilità di eseguire il ripristino da un backup in un'altra istanza o di clonare l'istanza.

Cloud SQL esegue un backup completo del database selezionato durante un'operazione di esportazione.

Ruoli e autorizzazioni richiesti per l'esportazione da Cloud SQL per SQL Server

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

Il ruolo Cloud SQL Editor
Un ruolo personalizzato, che include le seguenti autorizzazioni:
- cloudsql.instances.get
- cloudsql.instances.export

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

Il ruolo IAM (Identity and Access Management) storage.objectAdmin
Un ruolo personalizzato, incluse le seguenti autorizzazioni:
- storage.objects.create
- storage.objects.list (per l'esportazione con striping e l'esportazione del log delle transazioni)
- storage.objects.delete (per l'esportazione con striping e l'esportazione del log delle transazioni)
- storage.buckets.get (solo per l'esportazione del log delle transazioni)

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

Esporta i dati in un file BAK da Cloud SQL per SQL Server

Console

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

Vai a Istanze Cloud SQL
Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Fai clic su Esporta.
Nella sezione Formato file, fai clic su BAK.
Nella sezione Dati da esportare, utilizza il menu a discesa per selezionare il database da cui vuoi esportare.
Nella sezione Destinazione, seleziona Sfoglia per cercare un bucket Cloud Storage o una cartella per l'esportazione.
Fai clic su Esporta per avviare l'esportazione.

gcloud

Crea un bucket Cloud Storage.
Trova il account di servizio per l'istanza Cloud SQL da cui stai eseguendo l'esportazione. Puoi farlo eseguendo il comando gcloud sql instances describe. Cerca il campo serviceAccountEmailAddress nell'output.
```
gcloud sql instances describe INSTANCE_NAME
  
```
Utilizza gcloud storage buckets add-iam-policy-binding per concedere il ruolo IAM storage.objectAdmin al account di servizio. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Esporta il database:
```
gcloud sql export bak INSTANCE_NAME gs://BUCKET_NAME/FILENAME \
--database=DATABASE_NAME
  
```
Per informazioni sull'utilizzo del comando gcloud sql export bak, consulta la pagina di riferimento dei comandi.
Se non hai bisogno di conservare il ruolo IAM impostato in precedenza, revocalo ora.

REST v1

Crea un bucket Cloud Storage per l'esportazione.
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
Questo passaggio non è obbligatorio, ma è vivamente consigliato per evitare di aprire l'accesso ad altri dati.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Esporta il database:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza
- BUCKET_NAME: il nome del bucket Cloud Storage
- PATH_TO_DUMP_FILE: il percorso del file di dump SQL
- DATABASE_NAME_1: il nome di un database all'interno dell'istanza Cloud SQL
- DATABASE_NAME_2: 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/export
```
Corpo JSON della richiesta:
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/export"
```
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/export" | 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": "user@example.com",
  "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"
}
```
Se non hai bisogno di conservare il ruolo IAM impostato in precedenza, rimuovilo ora.

Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:export.

REST v1beta4

Crea un bucket Cloud Storage per l'esportazione.
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
Questo passaggio non è obbligatorio, ma è vivamente consigliato per evitare di aprire l'accesso ad altri dati.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Esporta il database:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza
- BUCKET_NAME: il nome del bucket Cloud Storage
- PATH_TO_DUMP_FILE: il percorso del file di dump SQL
- DATABASE_NAME_1: il nome di un database all'interno dell'istanza Cloud SQL
- DATABASE_NAME_2: 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/export
```
Corpo JSON della richiesta:
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/export"
```
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/export" | 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": "user@example.com",
  "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"
}
```
Se non hai bisogno di conservare il ruolo IAM impostato in precedenza, revocalo ora.

Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:export.

Esporta i backup differenziali dei database

Prima di esportare un backup differenziale del database, devi esportare una base differenziale.

Se altri servizi o funzionalità, come il recupero point-in-time e la replica di lettura, attivano un backup completo tra l'esportazione del backup completo e l'esportazione del backup differenziale, devi attivare nuovamente un'esportazione del backup completo.

Per capire meglio, considera il seguente esempio:

Invii una richiesta di backup completo alle 07:00.
Abiliti il recupero point-in-time alle 09:00. Questa operazione attiva un backup completo della tua istanza.
Provi a eseguire un backup differenziale alle 17:00. Questa richiesta di esportazione non va a buon fine e viene visualizzato un messaggio di errore perché l'ultimo backup completo è stato attivato dal recupero point-in-time.

Cloud SQL non supporta le richieste di esportazione del database con --differential-base o --bak-type=DIFF nelle istanze di replica.

gcloud

Crea un bucket Cloud Storage.
Trova il account di servizio dell'istanza Cloud SQL da cui stai eseguendo l'esportazione. Puoi farlo eseguendo il comando gcloud sql instances describe. Cerca il campo serviceAccountEmailAddress nell'output.
```
gcloud sql instances describe INSTANCE_NAME
  
```
Utilizza gcloud storage buckets add-iam-policy-binding per concedere il ruolo IAM storage.objectAdmin al account di servizio. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Esporta il database come base differenziale.
```
gcloud sql export bak INSTANCE_NAME gs://BUCKET_NAME/DIFFERENTIAL_BASE_FILENAME \
--database=DATABASE_NAME --differential-base
```
Per informazioni sull'utilizzo del comando gcloud sql export bak, consulta la pagina di riferimento dei comandi.
Esporta un backup differenziale.
```
gcloud sql export bak INSTANCE_NAME gs://BUCKET_NAME/DIFFERENTIAL_BACKUP_FILENAME \
--database=DATABASE_NAME --bak-type=DIFF
  
```
Per informazioni sull'utilizzo del comando gcloud sql export bak, consulta la pagina di riferimento dei comandi.
Se non hai bisogno di conservare il ruolo IAM impostato in precedenza, revocalo ora.

REST v1

Crea un bucket Cloud Storage per l'esportazione.
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
Questo passaggio non è obbligatorio, ma è vivamente consigliato per evitare di aprire l'accesso ad altri dati.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.

Esporta il backup completo del database come base differenziale.

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

PROJECT_ID: l'ID progetto
INSTANCE_ID: l'ID istanza
BUCKET_NAME: il nome del bucket Cloud Storage
PATH_TO_BAK_FILE: il percorso del file BAK SQL
DATABASE_NAME: il nome del database all'interno dell'istanza Cloud SQL
offload: per attivare e utilizzare l'esportazione serverless, imposta questo valore su TRUE
Nota: l'esportazione serverless comporta costi aggiuntivi. Consulta la pagina dei prezzi.

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/export

Corpo JSON della richiesta:

{
 "exportContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "databases": ["DATABASE_NAME"]
      "offload": TRUE | FALSE
      "bakExportOptions": {
        "differentialBase":true
      }
   }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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/export"

PowerShell

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/export" | 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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "EXPORT",
  "exportContext": {
    "uri": {uri},
    "databases": [
    DATABASE_NAME
    ],
    "kind": "sql#exportContext",
    "fileType": "BAK",
    "bakExportOptions": {
      "bakType": FULL,
      "differentialBase": true,
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Esporta un backup differenziale.

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

project-id: l'ID progetto
instance-id: l'ID istanza
bucket_name: il nome del bucket Cloud Storage
path_to_dump_file: il percorso del file di dump SQL
database_name_1: il nome di un database all'interno dell'istanza Cloud SQL
database_name_2: il nome di un database all'interno dell'istanza Cloud SQL
offload: abilita l'esportazione serverless. Imposta su true per utilizzare l'esportazione serverless.
Nota: l'esportazione serverless comporta costi aggiuntivi. Consulta la pagina dei prezzi.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
 "exportContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_dump_file",
      "databases": ["database_name"]
      "offload": true | false
      "bakExportOptions": {
        bakType:"DIFF"
      }

    }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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/export"

PowerShell

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/export" | 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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "EXPORT",
  "exportContext": {
    "uri": {uri},
    "databases": [
    database_name
    ],
    "kind": "sql#exportContext",
    "fileType": "BAK",
    "bakExportOptions": {
      "bakType": DIFF,
      "differentialBase": false,
    }
  },
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Se non hai bisogno di conservare il ruolo IAM impostato in precedenza, rimuovilo ora.

Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:export.

REST v1beta4

Crea un bucket Cloud Storage per l'esportazione.
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
Questo passaggio non è obbligatorio, ma è vivamente consigliato per evitare di aprire l'accesso ad altri dati.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.

Esporta il backup completo del database come base differenziale.

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

project-id: l'ID progetto
instance-id: l'ID istanza
bucket_name: il nome del bucket Cloud Storage
path_to_dump_file: il percorso del file di dump SQL
database_name_1: il nome di un database all'interno dell'istanza Cloud SQL
database_name_2: il nome di un database all'interno dell'istanza Cloud SQL
offload: per abilitare e utilizzare l'esportazione serverless, imposta il valore su true.
Nota: l'esportazione serverless comporta costi aggiuntivi. Per saperne di più, consulta la pagina dei prezzi.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "exportContext":
    {
       "fileType": "BAK",
       "uri": "gs://bucket_name/path_to_dump_file",
       "databases": ["database_name"]
       "offload": true | false
       "bakExportOptions": {
         "differentialBase":true
       }

     }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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/export"

PowerShell

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/export" | 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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "EXPORT",
  "exportContext": {
    "uri": {uri},
    "databases": [
    database_name
    ],
    "kind": "sql#exportContext",
    "fileType": "BAK",
    "bakExportOptions": {
      "bakType": FULL,
      "differentialBase": true,
    }
  },
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Esporta un backup differenziale:

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

project-id: l'ID progetto
instance-id: l'ID istanza
bucket_name: il nome del bucket Cloud Storage
path_to_dump_file: il percorso del file di dump SQL
database_name_1: il nome di un database all'interno dell'istanza Cloud SQL
database_name_2: il nome di un database all'interno dell'istanza Cloud SQL
offload: per abilitare e utilizzare le esportazioni serverless, imposta questo valore su true.
Nota: l'esportazione serverless comporta costi aggiuntivi. Per saperne di più, consulta la pagina dei prezzi.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "exportContext":
    {
       "fileType": "BAK",
       "uri": "gs://bucket_name/path_to_dump_file",
       "databases": ["database_name"]
       "offload": true | false
       "bakExportOptions": {
        bakType:"DIFF"
       }

     }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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/export"

PowerShell

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/export" | 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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "EXPORT",
  "exportContext": {
    "uri": {uri},
    "databases": [
    database_name
    ],
    "kind": "sql#exportContext",
    "fileType": "BAK",
    "bakExportOptions": {
      "bakType": DIFF,
      "differentialBase": false,
    }
  },
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Se non hai bisogno di conservare il ruolo IAM impostato in precedenza, revocalo ora.

Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:export.

Esporta i log delle transazioni

Puoi esportare i log delle transazioni dalle istanze Cloud SQL per SQL Server che utilizzano la nuova architettura di rete, hanno il recupero point-in-time (PITR) abilitato e i log archiviati in Cloud Storage.

gcloud

Crea un bucket Cloud Storage per l'esportazione.
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
Questo passaggio non è obbligatorio, ma è vivamente consigliato per evitare di aprire l'accesso ad altri dati.
Trova il account di servizio dell'istanza Cloud SQL da cui stai eseguendo l'esportazione. Per farlo, esegui il comando gcloud sql instances describe. Cerca il campo serviceAccountEmailAddress nell'output.
```
gcloud sql instances describe INSTANCE_NAME
  
```
Utilizza gcloud storage buckets add-iam-policy-binding per concedere il ruolo IAM storage.Admin al account di servizio. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Imposta e gestisci le policy IAM sui bucket.
Esporta i log delle transazioni.
```
gcloud sql export bak INSTANCE_NAME gs://BUCKET_NAME/FOLDER_PATH
--export-log-start-time=START_DATE_AND_TIME /
--export-log-end-time=END_DATE_AND_TIME /
--database=DATABASE_NAME --bak-type=TLOG
  
```
Nota: i parametri export-log-start-time e export-log-end-time sono facoltativi. I valori di questi parametri devono essere nel fuso orario UTC e nel formato RFC 3339. Ad esempio: 2024-05-26T16:19:00:094Z.

Se non fornisci una data di inizio e un'ora di inizio e una data e un'ora di fine per i parametri, Cloud SQL esporta tutti i log delle transazioni entro il periodo di conservazione dei log nel bucket Cloud Storage. Il periodo di conservazione dei log può variare da 1 a 35 giorni per la versione Cloud SQL Enterprise Plus e da 1 a 7 giorni per la versione Cloud SQL Enterprise.

Se vuoi esportare i log delle transazioni in modo continuo, non utilizzare il parametro
--export-log-start-time ed esporta sempre nella stessa posizione in Cloud Storage. Cloud SQL non esporta ripetutamente i file di log già esistenti nella destinazione.

Per informazioni sull'utilizzo del comando gcloud sql export bak, consulta la pagina di riferimento dei comandi.
Se non hai bisogno di conservare il ruolo IAM impostato in precedenza, revocalo ora.

REST

Crea un bucket Cloud Storage.

Questo passaggio non è obbligatorio, ma è vivamente consigliato per evitare di aprire l'accesso ad altri dati.
Fornisci alla tua istanza il ruolo IAM storage.Admin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Imposta e gestisci le policy IAM sui bucket.
Esporta i log delle transazioni.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza.
- BUCKET_NAME: il nome del bucket Cloud Storage.
- FOLDER_PATH: il percorso della cartella nel bucket Cloud Storage. Cloud SQL esporta i log delle transazioni in questa cartella.
- DATABASE_NAME: il nome del database all'interno dell'istanza Cloud SQL.
- exportLogStartTime: la data e l'ora di inizio dei log delle transazioni da esportare.
- exportLogEndTime: la data e l'ora di fine dei log delle transazioni da esportare.
Metodo HTTP e URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/export
```
Corpo JSON della richiesta:
```
{
 "exportContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/FOLDER_PATH",
      "databases": ["DATABASE_NAME"]
      "bakExportOptions": {
        bakType:"TLOG"
        exportLogStartTime: START_DATE_AND_TIME
        exportLogEndTime: END_DATE_AND_TIME
      }
   }
}
```
Per inviare la richiesta, scegli una di queste opzioni:
curl

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/export"
PowerShell

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/export" | 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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "EXPORT",
  "exportContext": {
    "uri": {uri},
    "databases": [
    DATABASE_NAME
    ],
    "kind": "sql#exportContext",
    "fileType": "BAK",
    "bakExportOptions": {
      "bakType": TLOG,
      "differentialBase": false,
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
Se non hai bisogno di conservare il ruolo IAM impostato in precedenza, rimuovilo ora.

Per l'elenco completo dei parametri della richiesta, consulta la pagina instances.export.

Usa l'esportazione con striping

I vantaggi dell'esportazione suddivisa sono i seguenti:

Riduzione del tempo necessario per il completamento delle operazioni
È possibile esportare database di dimensioni superiori a 5 TB

Un potenziale svantaggio dell'utilizzo dell'esportazione con striping è che il backup, anziché essere costituito da un unico file, viene suddiviso in un insieme di file. Questo set è chiamato "set di striping"; consulta Dispositivi di backup in un set di supporti con striping (un set di striping). In Cloud SQL, l'esportazione viene eseguita in una cartella vuota in Cloud Storage anziché generare un singolo file. Per saperne di più, consulta Come utilizzare l'esportazione con striping.

Pianificazione delle operazioni

L'esportazione con striping può migliorare le prestazioni delle esportazioni. Tuttavia, se il tuo caso d'uso richiede un singolo file di output o se il tuo database ha una dimensione inferiore a 5 TB e se prestazioni più rapide non sono fondamentali, ti consigliamo di utilizzare un'esportazione non sottoposta a striping.

Se decidi di utilizzare l'esportazione con striping, valuta il numero di stripe. Puoi specificare questo valore nel comando gcloud CLI o nella chiamata API REST. Tuttavia, se vuoi un numero ottimale di stripe per le prestazioni o se non conosci un numero, ometti il numero. Il numero ottimale di stripe viene impostato automaticamente.

Il numero massimo di stripe attualmente supportati da Cloud SQL per SQL Server è 64.

Come utilizzare l'esportazione con striping

gcloud

Crea un bucket Cloud Storage.
Trova il account di servizio per l'istanza Cloud SQL da cui stai eseguendo l'esportazione. Per farlo, esegui il comando gcloud sql instances describe. Cerca il campo serviceAccountEmailAddress nell'output.
```
gcloud sql instances describe INSTANCE_NAME
  
```
Utilizza gcloud storage buckets add-iam-policy-binding per concedere il ruolo IAM storage.objectAdmin al account di servizio. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Per esportare il database, specifica il parametro --striped e/o specifica un valore per --stripe_count. L'impostazione di un valore per --stripe_count implica che il parametro --striped è intenzionale. Se specifichi --no-striped, ma specifichi un valore per --stripe_count, si verifica un errore:
```
gcloud beta sql export bak INSTANCE_NAME \
gs://BUCKET_NAME/STRIPED_EXPORT_FOLDER \
--database=DATABASE_NAME --striped --stripe_count=NUMBER
  
```
Per informazioni sull'utilizzo del comando gcloud beta sql export bak, consulta la pagina di riferimento dei comandi.
Se non hai bisogno di conservare il ruolo IAM impostato in precedenza, revocalo ora.

REST v1

Crea un bucket Cloud Storage per l'esportazione.
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
Questo passaggio non è obbligatorio, ma è vivamente consigliato per evitare di aprire l'accesso ad altri dati.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Esporta il database:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- instance-id: l'ID istanza
- bucket_name: il nome del bucket Cloud Storage
- path_to_folder: il percorso della cartella (nel bucket Cloud Storage) in cui esportare il set con striping
- database_name: il nome di un database nell'istanza Cloud SQL
- true | false: impostato su true per utilizzare l'esportazione con striping. Se specifichi true senza specificare un numero di stripe, viene impostato automaticamente un numero ottimale di stripe
- number_of_stripes: il numero di stripe da utilizzare. Se specificato, striped viene considerato come true
Metodo HTTP e URL:
```
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/export
```
Corpo JSON della richiesta:
```
{
 "exportContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_folder",
      "databases": ["database_name"],
      "bakExportOptions": {
        "striped": true | false,
        "stripe_count": ["number_of_stripes"]
      }
    }
}
```
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/export"
```
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/export" | 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": "user@example.com",
  "insertTime": "2022-09-29T22: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"
}
```
Se non hai bisogno di conservare il ruolo IAM impostato in precedenza, rimuovilo ora.

Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:export.

REST v1beta4

Crea un bucket Cloud Storage per l'esportazione.
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
Questo passaggio non è obbligatorio, ma è vivamente consigliato per evitare di aprire l'accesso ad altri dati.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Esporta il database:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- instance-id: l'ID istanza
- bucket_name: il nome del bucket Cloud Storage
- path_to_folder: il percorso della cartella (nel bucket Cloud Storage) in cui esportare il set con striping
- database_name: il nome di un database nell'istanza Cloud SQL
- true | false: impostato su true per utilizzare l'esportazione con striping. Se specifichi true senza specificare un numero di stripe, viene impostato automaticamente un numero ottimale di stripe
- number_of_stripes: il numero di stripe da utilizzare. Se specificato, striped viene considerato come true
Metodo HTTP e URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/export
```
Corpo JSON della richiesta:
```
{
 "exportContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_folder",
      "databases": ["database_name"],
      "bakExportOptions": {
        "striped": true | false,
        "stripe_count": ["number_of_stripes"]
      }
    }
}
```
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/export"
```
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/export" | 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": "user@example.com",
  "insertTime": "2022-09-29T22: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"
}
```
Se non hai bisogno di conservare il ruolo IAM impostato in precedenza, rimuovilo ora.

Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:export.

Importa 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 in Cloud SQL, l'utente che avvia l'importazione deve avere uno dei seguenti ruoli:

Il ruolo Cloud SQL Admin
Un ruolo personalizzato, che include le seguenti autorizzazioni:
- cloudsql.instances.get
- cloudsql.instances.import

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

Il ruolo IAM storage.objectAdmin
Un ruolo personalizzato, incluse le seguenti autorizzazioni:
- storage.objects.get
- storage.objects.list (solo per l'importazione con striping)

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

Importa i dati da un file BAK in Cloud SQL per SQL Server

Per utilizzare l'importazione con striping, consulta Utilizza l'importazione con striping.

Sono disponibili vari framework di importazione. Ad esempio, Cloud SQL per SQL Server supporta Change Data Capture (CDC) per le seguenti versioni del database:

SQL Server 2017 Standard
SQL Server 2017 Enterprise
SQL Server 2019 Standard
SQL Server 2019 Enterprise
SQL Server 2022 Standard
SQL Server 2022 Enterprise

Quando importi un database abilitato per CDC, il flag KEEP_CDC viene conservato.

Se la versione dell'istanza è Microsoft SQL Server Enterprise Edition, puoi importare file BAK criptati.

Le istanze di Microsoft SQL Server Standard Edition importano anche file BAK criptati, ma solo tramite gcloud CLI.

Le uniche estensioni BAK supportate sono .bak e .bak.gz. I backup crittografati con GPG non sono attualmente supportati.

Per le istruzioni riportate di seguito, preparati a specificare un nuovo database. Non creare un database prima di iniziare l'importazione del file BAK.

Per importare i dati in un'istanza Cloud SQL utilizzando un file BAK:

Console

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

Vai a Istanze Cloud SQL
Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Fai clic su Importa.
Nel campo Scegli un file da cui eseguire l'importazione, inserisci il percorso del bucket e del file BAK da utilizzare per l'importazione.
Puoi importare un file compresso (.gz) o non compresso.
Nella sezione Formato file, seleziona BAK.
Se importi dati in un'istanza Cloud SQL Enterprise Plus, puoi importare file BAK criptati. Le istanze della versione Cloud SQL Enterprise supportano anche l'importazione di file BAK criptati, ma solo tramite gcloud CLI.

Per importare un file BAK criptato, segui questi passaggi:
1. Seleziona BAK criptato.
2. Nel campo Certificato, seleziona il certificato che vuoi importare. Questo certificato viene emesso da un'autorità di certificazione (CA) di terze parti.
3. Nel campo Chiave privata, seleziona il file che contiene la chiave privata che vuoi importare. La chiave privata viene utilizzata per criptare e decriptare i dati inviati da un'istanza Cloud SQL di origine a una di destinazione.
4. Nel campo Password, inserisci la password della chiave privata.
Nella sezione Destinazione, specifica il database nell'istanza Cloud SQL in cui vuoi importare il file BAK.
Per avviare l'importazione, fai clic su Importa.

gcloud

Crea un bucket Cloud Storage per l'importazione.
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
Questo passaggio non è obbligatorio, ma è vivamente consigliato per evitare di aprire l'accesso ad altri dati.
Assicurati di aver configurato i ruoli e le autorizzazioni richiesti.
Carica i dati dal file BAK nel bucket.
Descrivi l'istanza in cui stai eseguendo l'importazione:
```
gcloud sql instances describe INSTANCE_NAME
```
Copia il campo serviceAccountEmailAddress.
Utilizza gcloud storage buckets add-iam-policy-binding per concedere il ruolo IAM storage.objectViewer al account di servizio per il bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.

Importa i dati dal file:

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

Per le importazioni criptate, utilizza il seguente comando:

gcloud sql import bak INSTANCE_NAME gs://BUCKET_NAME/FILE_NAME
--database=DATABASE_NAME --cert-path=gs://BUCKET_NAME/CERTIFICATE_NAME
 --pvk-path=gs://BUCKET_NAME/KEY_NAME --prompt-for-pvk-password

Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, rimuovile utilizzando gcloud storage buckets remove-iam-policy-binding.

REST v1

Crea un bucket Cloud Storage.
Carica il file nel bucket.

Per assistenza sul caricamento di file nei bucket, consulta Caricamento di oggetti.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Importa i dati dal file:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- instance-id: l'ID istanza
- bucket_name: il nome del bucket Cloud Storage
- path_to_bak_file: il percorso del file BAK
- 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": "BAK",
      "uri": "gs://bucket_name/path_to_bak_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": "user@example.com",
  "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 utilizzare un utente diverso per l'importazione, specifica la proprietà importContext.importUser.
Per l'elenco completo dei parametri della richiesta, consulta la pagina instances:import.
Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, rimuovile.

REST v1beta4

Crea un bucket Cloud Storage.
Carica il file nel bucket.

Per assistenza sul caricamento di file nei bucket, consulta Caricamento di oggetti.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Importa i dati dal file:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- instance-id: l'ID istanza
- bucket_name: il nome del bucket Cloud Storage
- path_to_bak_file: il percorso del file BAK
- 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": "BAK",
      "uri": "gs://bucket_name/path_to_bak_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": "user@example.com",
  "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 utilizzare un utente diverso per l'importazione, specifica la proprietà importContext.importUser.
Per l'elenco completo dei parametri della richiesta, consulta la pagina instances:import.
Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, rimuovile.

Se ricevi un errore come ERROR_RDBMS, assicurati che il file BAK esista nel bucket e di disporre delle autorizzazioni corrette per il bucket. Per assistenza sulla configurazione controllo dell'accesso in Cloud Storage, consulta Crea e gestisci gli elenchi di controllo dell'accesso.

Importa backup differenziali del database

Prima di importare un backup differenziale del database, devi importare un backup completo e il database deve trovarsi nello stato RESTORING dopo l'importazione del backup completo.

Cloud SQL non supporta l'importazione di backup di database differenziali su istanze abilitate per il recupero point-in-time. Questo perché l'importazione di un backup del database con --no-recovery è un prerequisito per l'importazione dei backup differenziali del database. Inoltre, non puoi abilitare il recupero point-in-time su un'istanza se il database è nello stato RESTORING. In caso di errore di importazione, esegui una delle seguenti operazioni per abilitare il recupero point-in-time:

Porta online il database nello stato RESTORING utilizzando il flag --recovery-only .
Rimuovi il database.

Per importare i dati in un'istanza Cloud SQL utilizzando un backup differenziale del database, segui questi passaggi:

gcloud

Crea un bucket Cloud Storage per l'importazione.
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
Questo passaggio non è obbligatorio, ma ti consigliamo vivamente di eseguirlo per non aprire l'accesso ad altri dati.
Assicurati di aver configurato i ruoli e le autorizzazioni richiesti.
Carica i dati dal file BAK nel bucket.
Descrivi l'istanza in cui stai eseguendo l'importazione:
```
gcloud sql instances describe INSTANCE_NAME
```
Copia il campo serviceAccountEmailAddress.
Utilizza gcloud storage buckets add-iam-policy-binding per concedere il ruolo IAM storage.objectViewer al account di servizio per il bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.

Importa un backup completo con --no-recovery.

gcloud sql import bak INSTANCE_NAME gs://BUCKET_NAME/DIFFERENTIAL_BASE_FILENAME \
--database=DATABASE_NAME --bak-type=FULL --no-recovery

Importa un backup differenziale del database.

gcloud sql import bak INSTANCE_NAME gs://BUCKET_NAME/DIFFERENTIAL_BACKUP_FILENAME \
--database=DATABASE_NAME --bak-type=DIFF --no-recovery

Dopo aver ripristinato tutti i file di backup, utilizza il flag --recovery-only per portare online il database importato da uno stato RESTORING. Invitiamo vivamente gli utenti a non utilizzare i comandi T-SQL per portare online il database importato.
```
gcloud sql import bak INSTANCE_NAME \
--database=DATABASE_NAME --recovery-only
```
Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, rimuovile utilizzando gcloud storage buckets remove-iam-policy-binding.

REST v1

Crea un bucket Cloud Storage.
Carica il file nel bucket.

Per assistenza sul caricamento di file nei bucket, consulta Caricamento di oggetti.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.

Nota: nei passaggi seguenti, specifica la proprietà importContext.importUser per utilizzare un utente diverso per l'importazione. Per l'elenco completo dei parametri della richiesta, consulta la pagina instances:import.

Importa un backup completo con noRecovery.

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

PROJECT_ID: l'ID progetto
INSTANCE_ID: l'ID istanza.
BUCKET_NAME: il nome del bucket Cloud Storage.
PATH_TO_BAK_FILE: il percorso del file BAK.
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": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "noRecovery": true,
        "bakType": "FULL",
      }

    }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

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",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": true,
      "bakType": FULL,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Importa un backup differenziale del database.

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

project-id: l'ID progetto
instance-id: l'ID istanza
bucket_name: il nome del bucket Cloud Storage
path_to_bak_file: il percorso del file BAK
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": "BAK",
      "uri": "gs://bucket_name/path_to_bak_file",
      "database": "database_name"
      "bakImportOptions": {
        "bakType": "DIFF",
        "noRecovery": true,
      }

    }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

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",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": database_name,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": false,
      "bakType": DIFF,
      "recoveryOnly": false
    }
  },
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Dopo aver ripristinato tutti i file di backup, utilizza il flag recoveryOnly per portare online il database importato da uno stato RESTORING. Invitiamo vivamente gli utenti a non utilizzare i comandi T-SQL per portare online il database importato.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza
- BUCKET_NAME: il nome del bucket Cloud Storage
- PATH_TO_BAK_FILE: il percorso del file BAK
- 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": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "recoveryOnly": true,
      }

    }
}
```
Per inviare la richiesta, scegli una di queste opzioni:
curl

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

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",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "recoveryOnly": true
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, rimuovile.

REST v1beta4

Crea un bucket Cloud Storage.
Carica il file nel bucket.

Per assistenza sul caricamento di file nei bucket, consulta Caricamento di oggetti.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.

Importa un backup completo connoRecovery.

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

PROJECT-ID: l'ID progetto
INSTANCE_ID: l'ID istanza.
BUCKET_NAME: il nome del bucket Cloud Storage.
PATH_TO_BAK_FILE: il percorso del file BAK.
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": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "noRecovery": true,
        "bakType": "FULL",
      }
    }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": true,
      "bakType": FULL,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/operations/operation-id",
  "targetProject": "PROJECT-ID"
}

Importa un backup differenziale del database.

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

project-id: l'ID progetto
instance-id: l'ID istanza
bucket_name: il nome del bucket Cloud Storage
path_to_bak_file: il percorso del file BAK
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": "BAK",
      "uri": "gs://bucket_name/path_to_bak_file",
      "database": "database_name"
      "bakImportOptions": {
        "bakType": "DIFF",
        "noRecovery": true,
      }
    }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": database_name,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": false,
      "bakType": DIFF,
      "recoveryOnly": false
    }
  },
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Dopo aver ripristinato tutti i file di backup, utilizza il flag recoveryOnly per portare online il database importato da uno stato RESTORING. Invitiamo vivamente gli utenti a non utilizzare i comandi T-SQL per portare online il database importato.

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

PROJECT_ID: l'ID progetto
INSTANCE_ID: l'ID istanza
BUCKET_NAME: il nome del bucket Cloud Storage
PATH_TO_BAK_FILE: il percorso del file BAK
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": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "recoveryOnly": true,
      }
    }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "recoveryOnly": true
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

Importa i backup dei log delle transazioni

Un log delle transazioni è un record delle transazioni del database e delle modifiche apportate da ogni transazione. Puoi utilizzarlo per ristabilire la coerenza del database in caso di errore del sistema.

Per importare i dati in un'istanza Cloud SQL utilizzando un backup del log delle transazioni, segui questi passaggi:

gcloud

(Facoltativo) Crea un bucket Cloud Storage per l'importazione.

gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME

Carica i file di backup nel bucket.
Descrivi l'istanza in cui stai eseguendo l'importazione:
```
gcloud sql instances describe INSTANCE_NAME
```
Copia il campo serviceAccountEmailAddress.
Utilizza gcloud storage buckets add-iam-policy-binding per concedere il ruolo IAM storage.objectViewer al account di servizio per il bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Importa un backup completo utilizzando il parametro --no-recovery. Assicurati che il database sia nello stato RESTORING dopo l'importazione del backup completo.
```
gcloud sql import bak INSTANCE_NAME gs://BUCKET_NAME/BACKUP_FILENAME \
--database=DATABASE_NAME --bak-type=FULL --no-recovery
```
(Facoltativo) Importa un backup differenziale.
Importa un backup del log delle transazioni.
```
gcloud sql import bak INSTANCE_NAME gs://BUCKET_NAME/BACKUP_FILENAME \
--database=DATABASE_NAME --bak-type=TLOG
--stop-at=STOP_AT_TIMESTAMP --stop-at-mark=STOP_AT_MARK_NAME
--no-recovery
```
Sostituisci quanto segue:
- INSTANCE_NAME: il nome dell'istanza
- BUCKET_NAME: il nome del bucket Cloud Storage.
- BACKUP_FILENAME: il nome del file di backup.
- DATABASE_NAME: il nome di un database all'interno dell'istanza Cloud SQL.
- STOP_AT_TIMESTAMP: il timestamp in cui deve essere interrotta l'importazione del log delle transazioni. Questo è un campo facoltativo e il valore deve utilizzare il formato RFC 3339.
- STOP_AT_MARK_NAME: la transazione contrassegnata in cui l'importazione del log delle transazioni deve essere interrotta. Questo è un campo facoltativo e può assumere qualsiasi stringa come valore. Se il valore è nel formato lsn:log-sequence-number, l'importazione del log delle transazioni si interrompe in corrispondenza del numero di sequenza del log specificato.
Ripeti questo passaggio fino a quando non vengono importati tutti i backup del log delle transazioni.
Dopo aver ripristinato tutti i file di backup, utilizza il flag --recovery-only per portare online il database importato da uno stato RESTORING. Invitiamo vivamente gli utenti a non utilizzare i comandi T-SQL per portare online il database importato.
```
gcloud sql import bak INSTANCE_NAME \
--database=DATABASE_NAME --recovery-only
```
Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, rimuovile utilizzando gcloud storage buckets remove-iam-policy-binding.

REST v1

Crea un bucket Cloud Storage.
Carica il file nel bucket.

Per assistenza sul caricamento di file nei bucket, consulta Caricamento di oggetti.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.

instances:import

Importa un backup completo con noRecovery. Assicurati che il database sia nello stato RESTORING dopo l'importazione del backup completo.

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

PROJECT_ID: l'ID progetto
INSTANCE_ID: l'ID istanza.
BUCKET_NAME: il nome del bucket Cloud Storage.
PATH_TO_BAK_FILE: il percorso del file BAK.
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": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "noRecovery": true,
        "bakType": "FULL",
      }

    }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

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",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": true,
      "bakType": FULL,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

(Facoltativo) Importa un backup differenziale.
Importa un backup del log delle transazioni.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza.
- BUCKET_NAME: il nome del bucket Cloud Storage.
- PATH_TO_TLOG_FILE: il percorso del file di log delle transazioni.
- DATABASE_NAME: il nome di un database all'interno dell'istanza Cloud SQL.
- STOP_AT_TIMESTAMP: il timestamp in cui deve essere interrotta l'importazione del log delle transazioni. Questo è un campo facoltativo e il valore deve utilizzare il formato RFC 3339.
- STOP_AT_MARK_NAME: la transazione contrassegnata in cui l'importazione del log delle transazioni deve essere interrotta. Questo è un campo facoltativo e può assumere qualsiasi stringa come valore. Se il valore è nel formato lsn:log-sequence-number, l'importazione del log delle transazioni si interrompe in corrispondenza del numero di sequenza del log specificato.
Metodo HTTP e URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/import
```
Corpo JSON della richiesta:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_TLOG_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "bakType": "TLOG",
        "stopAt": STOP_AT_TIMESTAMP,
        "stopAtMark": STOP_AT_MARK_NAME,
        "noRecovery": true,
      }

    }
}
```
Per inviare la richiesta, scegli una di queste opzioni:
curl

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

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",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": false,
      "bakType": TLOG,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
Ripeti questo passaggio finché non vengono importati tutti i backup del log delle transazioni.
Dopo aver ripristinato tutti i file di backup, utilizza il flag recoveryOnly per portare online il database importato da uno stato RESTORING. Invitiamo vivamente gli utenti a non utilizzare i comandi T-SQL per portare online il database importato.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza
- BUCKET_NAME: il nome del bucket Cloud Storage
- PATH_TO_BAK_FILE: il percorso del file BAK
- 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": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "recoveryOnly": true,
      }

    }
}
```
Per inviare la richiesta, scegli una di queste opzioni:
curl

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

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",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "recoveryOnly": true
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, rimuovile.

REST v1beta4

Crea un bucket Cloud Storage.
Carica il file nel bucket.

Per assistenza sul caricamento di file nei bucket, consulta Caricamento di oggetti.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.

Importa un backup completo con noRecovery. Assicurati che il database sia nello stato RESTORING dopo l'importazione del backup completo.

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

PROJECT-ID: l'ID progetto
INSTANCE_ID: l'ID istanza.
BUCKET_NAME: il nome del bucket Cloud Storage.
PATH_TO_BAK_FILE: il percorso del file BAK.
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": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "noRecovery": true,
        "bakType": "FULL",
      }
    }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": true,
      "bakType": FULL,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/operations/operation-id",
  "targetProject": "PROJECT-ID"
}

(Facoltativo) Importa un backup differenziale.
Importa un backup del log delle transazioni. In questo caso, stopAt e stopAtMark sono campi facoltativi.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza.
- BUCKET_NAME: il nome del bucket Cloud Storage.
- PATH_TO_BAK_FILE: il percorso del file BAK.
- DATABASE_NAME: il nome di un database all'interno dell'istanza Cloud SQL.
- STOP_AT_TIMESTAMP: il timestamp in cui deve essere interrotta l'importazione del log delle transazioni. Questo è un campo facoltativo e il valore deve utilizzare il formato RFC 3339.
- STOP_AT_MARK_NAME: la transazione contrassegnata in cui l'importazione del log delle transazioni deve essere interrotta. Questo è un campo facoltativo e può assumere qualsiasi stringa come valore. Se il valore è nel formato lsn:log-sequence-number, l'importazione del log delle transazioni si interrompe in corrispondenza del numero di sequenza del log specificato.
Metodo HTTP e URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/import
```
Corpo JSON della richiesta:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "bakType": "TLOG",
        "stopAt": STOP_AT_TIMESTAMP,
        "stopAtMark":STOP_AT_MARK_NAME,
        "noRecovery": true,
      }

    }
}
```
Per inviare la richiesta, scegli una di queste opzioni:
curl

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

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",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": false,
      "bakType": TLOG,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
Ripeti questo passaggio finché non vengono importati tutti i backup dei log delle transazioni.

Dopo aver ripristinato tutti i file di backup, utilizza recoveryOnly per portare online il database importato.

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

PROJECT_ID: l'ID progetto
INSTANCE_ID: l'ID istanza
BUCKET_NAME: il nome del bucket Cloud Storage
PATH_TO_BAK_FILE: il percorso del file BAK
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": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "recoveryOnly": true,
      }
    }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "recoveryOnly": true
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

Utilizza l'importazione con striping

I vantaggi dell'importazione con striping sono i seguenti:

Riduzione del tempo necessario per il completamento delle operazioni
È possibile importare database di dimensioni superiori a 5 TB

Un potenziale svantaggio dell'utilizzo dell'importazione con striping è che tutti i file del set con striping (anziché un singolo file) devono essere caricati nella stessa cartella del bucket Cloud Storage prima di eseguire l'importazione.

Pianificazione delle operazioni

Nella maggior parte dei casi d'uso, l'importazione con striping consente di ottenere prestazioni migliori senza svantaggi. Tuttavia, se non puoi eseguire il backup in un set con striping da una determinata istanza o se il tuo database è inferiore a 5 TB e se prestazioni più rapide non sono fondamentali, ti consigliamo di utilizzare un'importazione senza striping.

Come utilizzare l'importazione con striping

gcloud

Crea un bucket Cloud Storage per l'importazione.
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
Questo passaggio non è obbligatorio, ma è vivamente consigliato per evitare di aprire l'accesso ad altri dati.
Assicurati di aver configurato i ruoli e le autorizzazioni IAM richiesti.
Crea una nuova cartella nel bucket.
Per importare il database, carica i file del set con striping (del database) nella nuova cartella. Assicurati che tutti i file siano caricati nella cartella e che questa non contenga file aggiuntivi.
Descrivi l'istanza da cui stai eseguendo l'esportazione:
```
gcloud sql instances describe INSTANCE_NAME
```
Copia il campo serviceAccountEmailAddress.
Utilizza gcloud storage buckets add-iam-policy-binding per concedere il ruolo IAM storage.objectViewer al account di servizio per il bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Importa i dati dalla cartella. La differenza rispetto a un'importazione non suddivisa è la seguente: l'URI rimanda al nome della cartella in cui è stato caricato il set di stripe, anziché a un singolo file, e devi specificare il parametro --striped:
```
gcloud beta sql import bak INSTANCE_NAME gs://BUCKET_NAME/FOLDER_NAME \
--database=DATABASE_NAME --striped
```
Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, rimuovile utilizzando gcloud storage buckets remove-iam-policy-binding.

REST v1

Crea un bucket Cloud Storage.
Carica il file nel bucket.

Per assistenza sul caricamento di file nei bucket, consulta Caricamento di oggetti.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Importa i dati dal file:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- instance-id: l'ID istanza
- bucket_name: il nome del bucket Cloud Storage
- path_to_folder: il percorso della cartella (nel bucket Cloud Storage) in cui si trova il set di stripe
- database_name: il nome di un database da creare nell'istanza Cloud SQL
- true | false: impostato su true per utilizzare l'importazione con striping
Metodo HTTP e URL:
```
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import
```
Corpo JSON della richiesta:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_folder",
      "database": "database_name",
      "bakImportOptions": {
        "striped": true | false
      }
    }
}
```
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": "user@example.com",
  "insertTime": "2022-09-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 utilizzare un utente diverso per l'importazione, specifica la proprietà importContext.importUser.
Per l'elenco completo dei parametri della richiesta, consulta la pagina instances:import.
Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, rimuovile.

REST v1beta4

Crea un bucket Cloud Storage.
Carica il file nel bucket.

Per assistenza sul caricamento di file nei bucket, consulta Caricamento di oggetti.
Fornisci alla tua istanza il ruolo IAM storage.objectAdmin per il tuo bucket. Per saperne di più sull'impostazione delle autorizzazioni IAM, consulta Utilizzo delle autorizzazioni IAM.
Importa i dati dal file:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- project-id: l'ID progetto
- instance-id: l'ID istanza
- bucket_name: il nome del bucket Cloud Storage
- path_to_folder: il percorso della cartella (nel bucket Cloud Storage) in cui si trova il set di stripe
- database_name: il nome di un database da creare nell'istanza Cloud SQL
- true | false: impostato su true per utilizzare l'importazione con striping
Metodo HTTP e URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import
```
Corpo JSON della richiesta:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_folder",
      "database": "database_name",
      "bakImportOptions": {
        "striped": true | false
      }
    }
}
```
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": "user@example.com",
  "insertTime": "2022-09-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 utilizzare un utente diverso per l'importazione, specifica la proprietà importContext.importUser.
Per l'elenco completo dei parametri della richiesta, consulta la pagina instances:import.
Se non hai bisogno di conservare le autorizzazioni IAM impostate in precedenza, rimuovile.

Se ricevi un errore come ERROR_RDBMS, assicurati che la tabella esista. Se la tabella esiste, verifica di disporre delle autorizzazioni corrette per il bucket. Per assistenza sulla configurazione controllo dell'accesso in Cloud Storage, consulta Crea e gestisci gli elenchi di controllo dell'accesso.

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.
Problemi noti relativi a importazioni ed esportazioni.

Esportazione e importazione mediante file BAK e file di log delle transazioni Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Esporta i dati da Cloud SQL per SQL Server

Ruoli e autorizzazioni richiesti per l'esportazione da Cloud SQL per SQL Server

Esporta i dati in un file BAK da Cloud SQL per SQL Server

Console

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Risposta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Risposta

Esporta i backup differenziali dei database

gcloud

REST v1

curl

PowerShell

Risposta

curl

PowerShell

Risposta

REST v1beta4

curl

PowerShell

Risposta

curl

PowerShell

Risposta

Esporta i log delle transazioni

gcloud

REST

curl

PowerShell

Risposta

Usa l'esportazione con striping

Pianificazione delle operazioni

Come utilizzare l'esportazione con striping

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Risposta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Risposta

Importa in Cloud SQL per SQL Server

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

Importa i dati da un file BAK in Cloud SQL per SQL Server

Console

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Risposta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Risposta

Importa backup differenziali del database

gcloud

REST v1

curl

PowerShell

Risposta

curl

PowerShell

Risposta

curl

PowerShell

Risposta

REST v1beta4

curl

PowerShell

Risposta

curl

PowerShell

Esportazione e importazione mediante file BAK e file di log delle transazioni