Importa y exporta archivos en paralelo

MySQL | PostgreSQL | SQL Server

En esta página, se describe cómo importar y exportar archivos a instancias de Cloudu SQL en paralelo.

Nota: Si migras una base de datos completa desde un servidor de base de datos compatible (local, en AWS o Cloud SQL) a una instancia nueva de Cloud SQL, usa Database Migration Service en lugar de exportar e importar los archivos. Si exportas porque quieres crear una instancia nueva desde el archivo exportado, considera restablecer una copia de seguridad a una instancia diferente o clonar la instancia

Para verificar que la operación de importación o exportación de varios archivos en paralelo se haya completado de forma correcta, comprueba el estado de la operación. También puedes cancelar la importación de datos en instancias de Cloud SQL y la exportación de datos desde las instancias. Para obtener más información sobre cómo cancelar una operación de importación o exportación, consulta Cancela la importación y la exportación de datos.

Antes de comenzar

Antes de comenzar una operación de importación o exportación, haz lo siguiente:

Asegúrate de que tu base de datos tenga suficiente espacio libre.

Las operaciones de importación y exportación usan recursos de bases de datos, pero no interfieren en las operaciones normales de la base de datos, a menos que la instancia no cuente con el aprovisionamiento suficiente.

Sigue las prácticas recomendadas para exportar e importar datos.
Después de completar una operación de importación, verifica los resultados.

Exporta datos de Cloud SQL para MySQL a varios archivos en paralelo

Las siguientes secciones contienen información sobre la exportación de datos de Cloud SQL para MySQL a varios archivos en paralelo.

Roles y permisos necesarios a fin de exportar datos de Cloud SQL para MySQL a varios archivos en paralelo

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

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

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

El rol de Identity and Access Management (IAM) llamado storage.objectAdmin
Un rol personalizado que incluya los siguientes permisos:
- storage.objects.create
- storage.objects.list (solo para exportar archivos en paralelo)
- storage.objects.delete (solo para exportar archivos en paralelo)

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

Exporta datos a varios archivos en paralelo

Puedes exportar datos en paralelo desde varios archivos que residan en Cloud SQL hacia Cloud Storage. Para ello, usa la utilidad dumpInstance.

Una vez que los archivos estén en Cloud Storage, puedes importarlos a otra base de datos de Cloud SQL. Si deseas acceder a los datos de los archivos de forma local, descarga los datos de Cloud Storage a tu entorno local.

Si tus archivos contienen cláusulas DEFINER (vistas, activadores, stored_procedures, etc.), según el orden en que se ejecuten estas declaraciones, el uso de estos archivos para la importación puede fallar. Obtén más información sobre el uso de DEFINER y las posibles soluciones en Cloud SQL.

gcloud

Para exportar datos de Cloud SQL a varios archivos en paralelo, completa los siguientes pasos:

Crea un bucket de Cloud Storage.
Nota: No es necesario que crees una carpeta en el bucket. Si la carpeta no existe, Cloud SQL la crea como parte del proceso de exportación de varios archivos en paralelo. Sin embargo, si la carpeta existe, debe estar vacía o la operación de exportación fallará.
Para encontrar la cuenta de servicio de la instancia de Cloud SQL desde la que exportas los archivos, usa el comando
gcloud sql instances describe.
```
gcloud sql instances describe INSTANCE_NAME
```

Reemplaza INSTANCE_NAME por el nombre de tu instancia de Cloud SQL.

En el resultado, busca el valor asociado con el campo serviceAccountEmailAddress.

Para otorgar el rol de IAM storage.objectAdmin a la cuenta de servicio, usa el comando gcloud storage buckets add-iam-policy-binding. Para obtener ayuda con la configuración de permisos de IAM, consulta Usa permisos de IAM.
Para exportar datos de Cloud SQL a varios archivos en paralelo, usa el comando gcloud sql export sql:
```
gcloud sql export sql INSTANCE_NAME gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME \
--offload \
--parallel \
--threads=THREAD_NUMBER \
--database=DATABASE_NAME \
--table=TABLE_EXPRESSION
```
Realiza los siguientes reemplazos:
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL desde la que exportas archivos en paralelo.
- BUCKET_NAME: el nombre del bucket de Cloud Storage.
- BUCKET_PATH: la ruta de acceso al bucket en el que se almacenan los archivos de exportación.
- FOLDER_NAME: la carpeta en la que se almacenan los archivos de exportación.
- THREAD_NUMBER: la cantidad de subprocesos que Cloud SQL usa para exportar archivos en paralelo. Por ejemplo, si deseas exportar tres archivos a la vez en paralelo, especifica 3 como el valor para este parámetro.
- DATABASE_NAME (opcional): el nombre de las bases de datos dentro de la instancia de Cloud SQL desde la que se realiza la exportación. Si no especificas ninguna base de datos, Cloud SQL exporta todas las bases de datos para la instancia.
- TABLE_EXPRESSION: las tablas que se exportarán desde la base de datos especificada.
Nota: Si quieres usar exportaciones sin servidores para un máximo de 2 subprocesos, usa el parámetro offload. Si deseas exportar varios archivos en paralelo, usa el parámetro parallel. De lo contrario, quita estos parámetros del comando.

El comando export sql no contiene activadores ni procedimientos almacenados, pero contiene vistas. A fin de exportar activadores o procedimientos almacenados, usa un solo subproceso para la exportación. En este subproceso, se usa la herramienta mysqldump.

Una vez que se complete la exportación, deberías tener los archivos en una carpeta en el bucket de Cloud Storage con el formato de volcado de MySQL Shell.
Si no necesitas el rol de IAM que configuraste en Roles y permisos necesarios para exportar desde Cloud SQL para MySQL, revócalo.

REST v1

Para exportar datos de Cloud SQL a varios archivos en paralelo, completa los siguientes pasos:

Crea un bucket de Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Realiza los siguientes reemplazos:
- BUCKET_NAME: el nombre del bucket, sujeto a los requisitos de nomenclatura. Por ejemplo, my-bucket.
- PROJECT_NAME: el nombre del proyecto de Google Cloud que contiene el bucket de Cloud Storage que crearás.
- LOCATION_NAME: la ubicación del bucket en el que deseas almacenar los archivos que exportarás. Por ejemplo, us-east1
Nota: No es necesario que crees una carpeta en el bucket. Si la carpeta no existe, Cloud SQL la crea como parte del proceso de exportación de varios archivos en paralelo. Sin embargo, si la carpeta existe, debe estar vacía o la operación de exportación fallará.
Otórgale a tu instancia el rol de IAM legacyBucketWriter para tu bucket. Para obtener ayuda con la configuración de permisos de IAM, consulta Usa permisos de IAM.
Exporta datos de Cloud SQL a varios archivos en paralelo:

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_NAME: el nombre del proyecto de Google Cloud que contiene el bucket de Cloud Storage que creaste.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL desde la que exportas archivos en paralelo.
- BUCKET_NAME: el nombre del bucket de Cloud Storage.
- BUCKET_PATH: la ruta de acceso al bucket en el que se almacenan los archivos de exportación.
- FOLDER_NAME: la carpeta en la que se almacenan los archivos de exportación.
- DATABASE_NAME (opcional): el nombre de las bases de datos dentro de la instancia de Cloud SQL desde la que se realiza la exportación. Si no especificas ninguna base de datos, Cloud SQL exporta todas las bases de datos para la instancia.
- THREAD_NUMBER: la cantidad de subprocesos que Cloud SQL usa para exportar archivos en paralelo. Por ejemplo, si deseas exportar tres archivos a la vez en paralelo, especifica 3 como el valor para este parámetro.
Nota: El parámetro offload te permite usar exportaciones sin servidores para un máximo de 2 subprocesos. El parámetro parallel te permite exportar varios archivos en paralelo. Para usar estas funciones, establece los valores de los parámetros en TRUE. De lo contrario, establécelos en FALSE.

HTTP method and URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
Cuerpo JSON de la solicitud:
```
{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlExportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
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_NAME/instances/INSTANCE_NAME/export"
```
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_NAME/instances/INSTANCE_NAME/export" | 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_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```

Una vez que se complete la exportación, deberías tener los archivos en una carpeta en el bucket de Cloud Storage con el formato de volcado de MySQL Shell.

Si no necesitas el rol de IAM que configuraste en Roles y permisos necesarios para exportar desde Cloud SQL para MySQL, revócalo.

Para obtener una lista completa de los parámetros de la solicitud, consulta la página API de Cloud SQL Admin.

REST v1beta4

Para exportar datos de Cloud SQL a varios archivos en paralelo, completa los siguientes pasos:

Crea un bucket de Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Realiza los siguientes reemplazos:
- BUCKET_NAME: el nombre del bucket, sujeto a los requisitos de nomenclatura. Por ejemplo, my-bucket.
- PROJECT_NAME: el nombre del proyecto de Google Cloud que contiene el bucket de Cloud Storage que crearás.
- LOCATION_NAME: la ubicación del bucket en el que deseas almacenar los archivos que exportarás. Por ejemplo, us-east1
Nota: No es necesario que crees una carpeta en el bucket. Si la carpeta no existe, Cloud SQL la crea como parte del proceso de exportación de varios archivos en paralelo. Sin embargo, si la carpeta existe, debe estar vacía o la operación de exportación fallará.
Otórgale a tu instancia el rol de IAM storage.objectAdmin para tu bucket. Para obtener ayuda con la configuración de permisos de IAM, consulta Usa permisos de IAM.
Exporta datos de Cloud SQL a varios archivos en paralelo:

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_NAME: el nombre del proyecto de Google Cloud que contiene el bucket de Cloud Storage que creaste.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL desde la que exportas archivos en paralelo.
- BUCKET_NAME: el nombre del bucket de Cloud Storage.
- BUCKET_PATH: la ruta de acceso al bucket en el que se almacenan los archivos de exportación.
- FOLDER_NAME: la carpeta en la que se almacenan los archivos de exportación.
- DATABASE_NAME (opcional): el nombre de las bases de datos dentro de la instancia de Cloud SQL desde la que se realiza la exportación. Si no especificas ninguna base de datos, Cloud SQL exporta todas las bases de datos para la instancia.
- THREAD_NUMBER: la cantidad de subprocesos que Cloud SQL usa para exportar archivos en paralelo. Por ejemplo, si deseas exportar tres archivos a la vez en paralelo, especifica 3 como el valor para este parámetro.
Nota: El parámetro offload te permite usar exportaciones sin servidores para un máximo de 2 subprocesos. El parámetro parallel te permite exportar varios archivos en paralelo. Para usar estas funciones, establece los valores de los parámetros en TRUE. De lo contrario, establécelos en FALSE.

HTTP method and URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
Cuerpo JSON de la solicitud:
```
{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlExportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
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_NAME/instances/INSTANCE_NAME/export"
```
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_NAME/instances/INSTANCE_NAME/export" | 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_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```

Una vez que se complete la exportación, deberías tener los archivos en una carpeta en el bucket de Cloud Storage con el formato de volcado de MySQL Shell.

Si no necesitas el rol de IAM que configuraste en Roles y permisos necesarios para exportar desde Cloud SQL para MySQL, revócalo.

A fin de obtener una lista completa de los parámetros de la solicitud, consulta la página API de Cloud SQL Admin.

Importa datos de varios archivos en paralelo a Cloud SQL para MySQL

Las siguientes secciones contienen información sobre la importación de datos de varios archivos en paralelo a Cloud SQL para MySQL.

Roles y permisos obligatorios a fin de importar datos de varios archivos en paralelo a Cloud SQL para MySQL

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 importar archivos en paralelo)

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

Importa datos a Cloud SQL para MySQL

Puedes importar datos en paralelo desde varios archivos que residen en Cloud Storage a tu base de datos. Para ello, usa la utilidad loadDump.

gcloud

Para importar datos de varios archivos en paralelo a Cloud SQL, completa los siguientes pasos:

Crea buckets de Cloud Storage.
Sube los archivos a tu bucket.

Nota: Asegúrate de que los archivos que subas estén en el formato de volcado de MySQL Shell. Para obtener más información, consulta Exporta datos desde varios archivos en paralelo.

Para obtener ayuda con la carga de archivos en buckets, consulta Sube objetos desde archivos.
Para encontrar la cuenta de servicio de la instancia de Cloud SQL a la que importas archivos, usa el comando
gcloud sql instances describe.
```
gcloud sql instances describe INSTANCE_NAME
```

Reemplaza INSTANCE_NAME por el nombre de tu instancia de Cloud SQL.

En el resultado, busca el valor asociado con el campo serviceAccountEmailAddress.

Para otorgar el rol de IAM storage.objectAdmin a la cuenta de servicio, usa la utilidad gcloud storage buckets add-iam-policy-binding. Para obtener ayuda con la configuración de permisos de IAM, consulta Usa permisos de IAM.
Para importar datos de varios archivos en paralelo a Cloud SQL, usa el comando gcloud sql import sql:
```
gcloud sql import sql INSTANCE_NAME gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME \
--offload \
--parallel \ 
--threads=THREAD_NUMBER \
--database=DATABASE_NAME
```
Realiza los siguientes reemplazos:
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL a la que importas archivos en paralelo.
- BUCKET_NAME: el nombre del bucket de Cloud Storage.
- BUCKET_PATH: la ruta de acceso al bucket en el que se almacenan los archivos de importación.
- FOLDER_NAME: la carpeta en la que se almacenan los archivos de importación.
- THREAD_NUMBER: la cantidad de subprocesos que Cloud SQL usa para importar archivos en paralelo. Por ejemplo, si deseas importar tres archivos a la vez en paralelo, especifica 3 como el valor para este parámetro.
- DATABASE_NAME (opcional): el nombre de las bases de datos dentro de la instancia de Cloud SQL desde la que se realiza la importación. Si no especificas ninguna base de datos, Cloud SQL importa todas las bases de datos para la instancia.
Nota: Si quieres usar importaciones sin servidores para hasta 2 subprocesos, usa el parámetro offload. Si deseas importar varios archivos en paralelo, usa el parámetro parallel.

De lo contrario, quita estos parámetros del comando.

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 los permisos de IAM que configuraste en Roles y permisos obligatorios para importar a Cloud SQL para MySQL, usa gcloud storage buckets remove-iam-policy-binding a fin de quitarlos.

REST v1

Para importar datos de varios archivos en paralelo a Cloud SQL, completa los siguientes pasos:

Crea un bucket de Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Realiza los siguientes reemplazos:
- BUCKET_NAME: el nombre del bucket, sujeto a los requisitos de nomenclatura. Por ejemplo, my-bucket.
- PROJECT_NAME: el nombre del proyecto de Google Cloud que contiene el bucket de Cloud Storage que crearás.
- LOCATION_NAME: la ubicación del bucket en el que deseas almacenar los archivos que importas. Por ejemplo, us-east1
Sube los archivos a tu bucket.

Nota: Asegúrate de que los archivos que subas estén en el formato de volcado de MySQL Shell. Para obtener más información, consulta Exporta datos desde varios archivos en paralelo.

Para obtener ayuda con la carga de archivos en buckets, consulta Sube objetos desde archivos.
Otorga a la instancia el rol de IAM storage.objectAdmin para tu bucket. Para obtener ayuda con la configuración de permisos de IAM, consulta Usa permisos de IAM.
Importa datos de varios archivos en paralelo a Cloud SQL:

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_NAME: el nombre del proyecto de Google Cloud que contiene el bucket de Cloud Storage que creaste.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL a la que importas archivos en paralelo.
- BUCKET_NAME: el nombre del bucket de Cloud Storage.
- BUCKET_PATH: la ruta de acceso al bucket en el que se almacenan los archivos de importación.
- FOLDER_NAME: la carpeta en la que se almacenan los archivos de importación.
- DATABASE_NAME (opcional): el nombre de las bases de datos dentro de la instancia de Cloud SQL desde la que se realiza la importación. Si no especificas ninguna base de datos, Cloud SQL importa todas las bases de datos para la instancia.
- THREAD_NUMBER: la cantidad de subprocesos que Cloud SQL usa para importar archivos en paralelo. Por ejemplo, si deseas importar tres archivos a la vez en paralelo, especifica 3 como el valor para este parámetro.
Nota: El parámetro offload te permite usar importaciones sin servidores para hasta 2 subprocesos. El parámetro parallel te permite importar varios archivos en paralelo.

Para usar estas funciones, establece los valores de los parámetros en TRUE. De lo contrario, establécelos en FALSE.

HTTP method and URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
Cuerpo JSON de la solicitud:
```
{
 "importContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlImportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
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_NAME/instances/INSTANCE_NAME/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_NAME/instances/INSTANCE_NAME/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_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```
Para obtener una lista completa de los parámetros de la solicitud, consulta la página API de Cloud SQL Admin.
Si no necesitas los permisos de IAM que configuraste en Roles y permisos obligatorios para importar a Cloud SQL para MySQL, usa gcloud storage buckets remove-iam-policy-binding a fin de quitarlos.

REST v1beta4

Para importar datos de varios archivos en paralelo a Cloud SQL, completa los siguientes pasos:

Crea un bucket de Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Realiza los siguientes reemplazos:
- BUCKET_NAME: el nombre del bucket, sujeto a los requisitos de nomenclatura. Por ejemplo, my-bucket.
- PROJECT_NAME: el nombre del proyecto de Google Cloud que contiene el bucket de Cloud Storage que crearás.
- LOCATION_NAME: la ubicación del bucket en el que deseas almacenar los archivos que importas. Por ejemplo, us-east1
Sube los archivos a tu bucket.

Nota: Asegúrate de que los archivos que subas estén en el formato de volcado de MySQL Shell. Para obtener más información, consulta Exporta datos desde varios archivos en paralelo.

Para obtener ayuda con la carga de archivos en buckets, consulta Sube objetos desde archivos.
Otorga a la instancia el rol de IAM storage.objectAdmin para tu bucket. Para obtener ayuda con la configuración de permisos de IAM, consulta Usa permisos de IAM.
Importa datos de varios archivos en paralelo a Cloud SQL:

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_NAME: el nombre del proyecto de Google Cloud que contiene el bucket de Cloud Storage que creaste.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL desde la que importas archivos en paralelo.
- BUCKET_NAME: el nombre del bucket de Cloud Storage.
- BUCKET_PATH: la ruta de acceso al bucket en el que se almacenan los archivos de importación.
- FOLDER_NAME: la carpeta en la que se almacenan los archivos de importación.
- DATABASE_NAME (opcional): el nombre de las bases de datos dentro de la instancia de Cloud SQL desde la que se realiza la importación. Si no especificas ninguna base de datos, Cloud SQL importa todas las bases de datos para la instancia.
- THREAD_NUMBER: la cantidad de subprocesos que Cloud SQL usa para importar archivos en paralelo. Por ejemplo, si deseas importar tres archivos a la vez en paralelo, especifica 3 como el valor para este parámetro.
Nota: El parámetro offload te permite usar importaciones sin servidores para hasta 2 subprocesos. El parámetro parallel te permite importar varios archivos en paralelo.

Para usar estas funciones, establece los valores de los parámetros en TRUE. De lo contrario, establécelos en FALSE.

HTTP method and URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
Cuerpo JSON de la solicitud:
```
{
  "importContext":
    {
       "fileType": "SQL",
       "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
       "databases": ["DATABASE_NAME"],
       "offload": [TRUE|FALSE],
       "sqlImportOptions": {
         "parallel": [TRUE|FALSE],
         "threads": [THREAD_NUMBER]
        }
    }
 }
 
```
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_NAME/instances/INSTANCE_NAME/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_NAME/instances/INSTANCE_NAME/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_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```
Para obtener una lista completa de los parámetros de la solicitud, consulta la página API de Cloud SQL Admin.
Si no necesitas los permisos de IAM que configuraste en Roles y permisos obligatorios para importar a Cloud SQL para MySQL, usa gcloud storage buckets remove-iam-policy-binding a fin de quitarlos.

Limitaciones

Si especificas demasiados subprocesos cuando importas o exportas datos de varios archivos en paralelo, es posible que uses más memoria de la que tiene tu instancia de Cloud SQL. Si esto ocurre, aparecerá un mensaje de error interno. Verifica el uso de memoria de tu instancia y aumenta el tamaño de la instancia, según sea necesario. Para obtener más información, consulta Información sobre la configuración de instancias.
Cuando se realiza una exportación, no se admiten comas en nombres de bases de datos o nombres de tablas en los campos databases o tables.
Asegúrate de tener suficiente espacio en el disco para la descarga inicial del archivo de volcado. De lo contrario, aparecerá un error no space left on disk.
Si tu instancia tiene solo una CPU virtual, no podrás importar ni exportar varios archivos en paralelo. La cantidad de CPU virtuales para tu instancia no puede ser menor que la cantidad de subprocesos que usas para la operación de importación o exportación, y la cantidad de subprocesos debe ser al menos dos.
Si escribes declaraciones del lenguaje de definición de datos (DDL), como CREATE, DROP o ALTER durante una operación de exportación, la operación puede fallar o los datos exportados pueden no ser coherentes con la instantánea de recuperación de un momento determinado.
Si una operación de importación falla, es posible que hayas importado parcialmente los datos restantes. En el caso de las declaraciones DDL, MySQL las confirma de forma automática. Si esto ocurre, antes de volver a importar los datos, limpia los datos parciales.

¿Qué sigue?

Aprende a comprobar el estado de las operaciones de importación y exportación.
Obtén información sobre cómo cancelar la importación y exportación de datos.
Obtén información sobre las prácticas recomendadas para importar y exportar datos.
Obtén información sobre problemas conocidos de las importaciones y exportaciones.

Importa y exporta archivos en paralelo

Antes de comenzar

Exporta datos de Cloud SQL para MySQL a varios archivos en paralelo

Roles y permisos necesarios a fin de exportar datos de Cloud SQL para MySQL a varios archivos en paralelo

Exporta datos a varios archivos en paralelo

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

Importa datos de varios archivos en paralelo a Cloud SQL para MySQL

Roles y permisos obligatorios a fin de importar datos de varios archivos en paralelo a Cloud SQL para MySQL

Importa datos a Cloud SQL para MySQL

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Respuesta

Limitaciones

¿Qué sigue?