Importa y exporta con archivos de volcado de SQL

MySQL |PostgreSQL |SQL Server

En esta página, se describe la importación y exportación de datos en instancias de Cloud SQL mediante archivos de volcado de SQL.

La exportación de Cloud SQL a un archivo de volcado de SQL no es compatible con SQL Server.

Antes de comenzar

Las exportaciones usan recursos de bases de datos, pero no interfieren en las operaciones normales de las bases de datos, a menos que la instancia no cuente con el aprovisionamiento suficiente.

A fin de obtener prácticas recomendadas, consulta Recomendaciones para la importación y exportación de datos.

Después de completar una operación de importación, verifica los resultados.

Exporta datos de Cloud SQL para SQL Server

La exportación de Cloud SQL a un archivo de volcado de SQL no es compatible con SQL Server.

Importa datos a Cloud SQL para SQL Server

Roles y permisos necesarios para importar a Cloud SQL para SQL Server

Para importar datos de Cloud Storage a Cloud SQL, el usuario que inicia la importación debe tener uno de los siguientes roles:

El rol Administrador de Cloud SQL
Un rol personalizado que incluya los siguientes permisos:
- cloudsql.instances.get
- cloudsql.instances.import

Además, la cuenta de servicio para la instancia de Cloud SQL debe tener uno de los siguientes roles:

El rol de IAM storage.objectAdmin
Un rol personalizado que incluya los siguientes permisos:
- storage.objects.get
- storage.objects.list (solo para versiones solo para importar)

Para obtener ayuda con los roles de IAM, consulta Identity and Access Management.

Importa un archivo de volcado de SQL a Cloud SQL para SQL Server

Los archivos SQL son archivos de texto sin formato con una secuencia de comandos de SQL.

En el siguiente procedimiento, prepárate para especificar una base de datos existente desde la que importar tus archivos SQL.

Console

En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

Ir a Instancias de Cloud SQL
Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
Haz clic en Importar.
En la sección Elige el archivo del cual deseas importar datos, ingresa la ruta de acceso al depósito y el archivo de volcado de SQL que se usará para la importación, o navega a un archivo existente. .
Puedes importar un archivo comprimido (.gz) o uno sin comprimir (.sql).
En Formato, selecciona SQL.
Selecciona la base de datos hacia la cual deseas importar los datos.

Esto hace que Cloud SQL ejecute la instrucción USE DATABASE antes de la importación.

Si el archivo de volcado de SQL incluye una instrucción USE DATABASE, se anula la base de datos que estableciste en la consola de Google Cloud.
Si deseas especificar un usuario para que realice la importación, selecciona el usuario.

Si tu archivo de importación contiene instrucciones que un usuario específico debe llevar a cabo, usa este campo para especificar ese usuario.
Haz clic en Importar para comenzar la importación.

gcloud

Crea un bucket de Cloud Storage.
Sube el archivo a tu bucket.

Para obtener ayuda con la carga de archivos en depósitos, consulta Sube objetos.
Describe la instancia hacia la cual deseas importar:
```
gcloud sql instances describe INSTANCE_NAME
```
Copia el campo serviceAccountEmailAddress.
Usa gcloud storage buckets add-iam-policy-binding para otorgar la función de IAM storage.objectAdmin a la cuenta de servicio del bucket.
```
gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
  --member=serviceAccount:SERVICE-ACCOUNT \
  --role=roles/storage.objectAdmin
  
```
Para obtener ayuda con la configuración de permisos de IAM, consulta la sección sobre cómo usar permisos de IAM.
Importa la base de datos:
```
gcloud sql import sql INSTANCE_NAME gs://BUCKET_NAME/IMPORT_FILE_NAME \
--database=DATABASE_NAME
```
Para obtener información sobre el uso del comando import sql, consulta la página de referencia del comando sql import sql.

Si el comando muestra un error como ERROR_RDBMS, revisa los permisos; por lo general, este error se produce por problemas con los permisos.
Si no necesitas conservar los permisos de IAM que configuraste antes, quítalos mediante gcloud storage buckets remove-iam-policy-binding.

REST v1

Crea un bucket de Cloud Storage.
Sube el archivo a tu bucket.

Para obtener ayuda con la carga de archivos en buckets, consulta Sube objetos.
Otórgale a la instancia las funciones de Cloud IAM legacyBucketWriter y objectViewer para el bucket. Para obtener ayuda con la configuración de permisos de IAM, consulta la sección Usa permisos de IAM.
Importa el archivo de volcado:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- project-id: el ID del proyecto
- instance-id: el ID de la instancia
- bucket_name: El nombre del depósito de Cloud Storage
- path_to_sql_file: La ruta de acceso al archivo SQL
- database_name: El nombre de una base de datos dentro de la instancia de Cloud SQL
Método HTTP y URL:
```
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import
```
Cuerpo JSON de la solicitud:
```
{
 "importContext":
   {
      "fileType": "SQL",
      "uri": "gs://bucket_name/path_to_sql_file",
      "database": "database_name"
    }
}
```
Para enviar tu solicitud, expande una de estas opciones:
curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import"
```
PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import" | Select-Object -Expand Content
```
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
```
{
  "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"
}
```
Si quieres obtener una lista completa de parámetros para esta solicitud, consulta la página instances:import.
Si no necesitas conservar los permisos de IAM que configuraste, quítalos ahora.

REST v1beta4

Crea un bucket de Cloud Storage.
Sube el archivo a tu bucket.

Para obtener ayuda con la carga de archivos en buckets, consulta Sube objetos.
Otorga a la instancia la función de IAM storage.objectAdmin para el depósito. Para obtener ayuda con la configuración de permisos de IAM, consulta Usa permisos de IAM.
Importa el archivo de volcado:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- project-id: el ID del proyecto
- instance-id: el ID de la instancia
- bucket_name: El nombre del depósito de Cloud Storage
- path_to_sql_file: La ruta de acceso al archivo SQL
- database_name: El nombre de una base de datos dentro de la instancia de Cloud SQL
Método HTTP y URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import
```
Cuerpo JSON de la solicitud:
```
{
 "importContext":
   {
      "fileType": "SQL",
      "uri": "gs://bucket_name/path_to_sql_file",
      "database": "database_name"
    }
}
```
Para enviar tu solicitud, expande una de estas opciones:
curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import"
```
PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import" | Select-Object -Expand Content
```
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
```
{
  "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"
}
```
Si quieres obtener una lista completa de parámetros para esta solicitud, consulta la página instances:import.
Si no necesitas conservar los permisos de IAM que configuraste, quítalos ahora.

¿Qué sigue?

Aprende a verificar el estado de las operaciones de importación y exportación.
Obtén más información sobre las prácticas recomendadas para importar y exportar datos.
Obtén más información sobre Cloud Storage.
Problemas conocidos para importaciones y exportaciones.