Esta página se ha traducido con Cloud Translation API.

Exportar e importar archivos en paralelo

MySQL | PostgreSQL | SQL Server

En esta página se describe cómo exportar e importar archivos en instancias de Cloud SQL en paralelo.

Nota: Si vas a migrar una base de datos completa desde un servidor de bases de datos compatible (local, en AWS o en Cloud SQL) a una nueva instancia de Cloud SQL, utiliza Database Migration Service en lugar de exportar e importar archivos en paralelo. Si vas a exportar el archivo porque quieres crear una instancia a partir de él, te recomendamos que restaures una copia de seguridad en otra instancia o que clones la instancia.

Para comprobar que la operación de importación o exportación de varios archivos en paralelo se ha completado correctamente, consulta 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 el artículo Cancelar la importación y exportación de datos.

Antes de empezar

Antes de iniciar una operación de exportación o importación:

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

Las operaciones de importación y exportación usan recursos de la base de datos, pero no interfieren con las operaciones típicas de la base de datos, a menos que la instancia no tenga suficientes recursos.

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

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

En las secciones siguientes se ofrece información sobre cómo exportar datos de Cloud SQL para MySQL a varios archivos en paralelo.

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

Para exportar datos de Cloud SQL a Cloud Storage, el usuario que inicie 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 de la instancia de Cloud SQL debe tener uno de los siguientes roles:

El rol storage.objectAdmin Gestión de Identidades y Accesos (IAM)
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 gestión de identidades y accesos, consulta Gestión de identidades y accesos.

Exportar datos a varios archivos en paralelo

Puede exportar datos en paralelo desde varios archivos que residen en Cloud SQL a Cloud Storage. Para ello, usa la utilidad dumpInstance.

Una vez que los archivos estén en Cloud Storage, podrás importarlos a otra base de datos de Cloud SQL. Si quieres acceder a los datos de los archivos de forma local, descárgalos de Cloud Storage a tu entorno local.

Si tus archivos contienen cláusulas DEFINER (vistas, activadores, stored_procedures, etc.), es posible que no se puedan importar si se ejecutan en un orden determinado. Consulta más información sobre el uso de DEFINER y las posibles soluciones alternativas en Cloud SQL.

gcloud

Para exportar datos de Cloud SQL a varios archivos en paralelo, sigue estos pasos:

Crea un segmento de Cloud Storage.
Nota: No es necesario que crees una carpeta en el contenedor. Si la carpeta no existe, Cloud SQL la creará 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 vas a exportar archivos, usa el comando
gcloud sql instances describe.
```
gcloud sql instances describe INSTANCE_NAME
```

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

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

Para asignar el storage.objectAdmin rol de gestión de identidades y accesos 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 gestión de identidades y accesos, consulta Usar permisos de gestión de identidades y accesos.
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
```
Haz las siguientes sustituciones:
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL desde la que vas a exportar archivos en paralelo.
- BUCKET_NAME: el nombre del segmento de Cloud Storage.
- BUCKET_PATH: la ruta al segmento donde se almacenan los archivos de exportación.
- FOLDER_NAME: la carpeta en la que se almacenan los archivos de exportación.
- THREAD_NUMBER: número de subprocesos que usa Cloud SQL para exportar archivos en paralelo. Por ejemplo, si quiere exportar tres archivos a la vez en paralelo, especifique 3 como valor de este parámetro.
- DATABASE_NAME (opcional): el nombre de las bases de datos de la instancia de Cloud SQL desde la que se realiza la exportación. Si no especificas ninguna base de datos, Cloud SQL exportará todas las bases de datos de la instancia.
- TABLE_EXPRESSION: las tablas que se van a exportar de la base de datos especificada.
Nota: Si quieres usar exportaciones sin servidor con hasta 2 hilos, utiliza el parámetro offload. Si quiere exportar varios archivos en paralelo, utilice el parámetro parallel. De lo contrario, quita estos parámetros del comando.

El comando export sql no contiene activadores ni procedimientos almacenados, pero sí contiene vistas. Para exportar activadores o procedimientos almacenados, usa un solo subproceso para la exportación. En esta conversación se usa la herramienta mysqldump.

Una vez completada la exportación, deberías tener archivos en una carpeta del segmento de Cloud Storage en formato de volcado de MySQL Shell.
Si no necesitas el rol de gestión de identidades y accesos que has definido 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, sigue estos pasos:

Crea un segmento de Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Haz las siguientes sustituciones:
- BUCKET_NAME: el nombre del segmento, sujeto a los requisitos de nomenclatura. Por ejemplo, my-bucket.
- PROJECT_NAME: el nombre del Google Cloud proyecto que contiene el segmento de Cloud Storage que vas a crear.
- LOCATION_NAME: la ubicación del contenedor en el que quieras almacenar los archivos que vas a exportar. Por ejemplo, us-east1.
Nota: No es necesario que crees una carpeta en el contenedor. Si la carpeta no existe, Cloud SQL la creará 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á.
Asigna a tu instancia el legacyBucketWriter rol de gestión de identidades y accesos de tu segmento. Para obtener ayuda sobre cómo definir permisos de gestión de identidades y accesos, consulta Usar permisos de gestión de identidades y accesos.
Exportar datos de Cloud SQL a varios archivos en paralelo:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_NAME: el nombre del Google Cloud proyecto que contiene el segmento de Cloud Storage que has creado.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL desde la que vas a exportar archivos en paralelo.
- BUCKET_NAME: el nombre del segmento de Cloud Storage.
- BUCKET_PATH: la ruta al segmento donde 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 de la instancia de Cloud SQL desde la que se realiza la exportación. Si no especificas ninguna base de datos, Cloud SQL exportará todas las bases de datos de la instancia.
- THREAD_NUMBER: número de subprocesos que usa Cloud SQL para exportar archivos en paralelo. Por ejemplo, si quiere exportar tres archivos a la vez en paralelo, especifique 3 como valor de este parámetro.
Nota: El parámetro offload te permite usar exportaciones sin servidor con hasta 2 hilos. El parámetro parallel te permite exportar varios archivos en paralelo. Para usar estas funciones, asigna el valor TRUE a estos parámetros. De lo contrario, asigna el valor FALSE.

Método HTTP y 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, despliega una de estas opciones:
curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, 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 presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, 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 siguiente:
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 completada la exportación, deberías tener archivos en una carpeta del segmento de Cloud Storage en formato de volcado de MySQL Shell.

Si no necesitas el rol de gestión de identidades y accesos que has definido en Roles y permisos necesarios para exportar desde Cloud SQL para MySQL, revócalo.

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

REST v1beta4

Para exportar datos de Cloud SQL a varios archivos en paralelo, sigue estos pasos:

Crea un segmento de Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Haz las siguientes sustituciones:
- BUCKET_NAME: el nombre del segmento, sujeto a los requisitos de nomenclatura. Por ejemplo, my-bucket.
- PROJECT_NAME: el nombre del Google Cloud proyecto que contiene el segmento de Cloud Storage que vas a crear.
- LOCATION_NAME: la ubicación del contenedor en el que quieras almacenar los archivos que vas a exportar. Por ejemplo, us-east1.
Nota: No es necesario que crees una carpeta en el contenedor. Si la carpeta no existe, Cloud SQL la creará 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á.
Asigna a tu instancia el storage.objectAdmin rol de gestión de identidades y accesos de tu segmento. Para obtener ayuda sobre cómo definir permisos de gestión de identidades y accesos, consulta Usar permisos de gestión de identidades y accesos.
Exportar datos de Cloud SQL a varios archivos en paralelo:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_NAME: el nombre del Google Cloud proyecto que contiene el segmento de Cloud Storage que has creado.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL desde la que vas a exportar archivos en paralelo.
- BUCKET_NAME: el nombre del segmento de Cloud Storage.
- BUCKET_PATH: la ruta al segmento donde 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 de la instancia de Cloud SQL desde la que se realiza la exportación. Si no especificas ninguna base de datos, Cloud SQL exportará todas las bases de datos de la instancia.
- THREAD_NUMBER: número de subprocesos que usa Cloud SQL para exportar archivos en paralelo. Por ejemplo, si quiere exportar tres archivos a la vez en paralelo, especifique 3 como valor de este parámetro.
Nota: El parámetro offload te permite usar exportaciones sin servidor con hasta 2 hilos. El parámetro parallel te permite exportar varios archivos en paralelo. Para usar estas funciones, asigna el valor TRUE a estos parámetros. De lo contrario, asigna el valor FALSE.

Método HTTP y 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, despliega una de estas opciones:
curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, 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 presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, 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 siguiente:
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 completada la exportación, deberías tener archivos en una carpeta del segmento de Cloud Storage en formato de volcado de MySQL Shell.

Si no necesitas el rol de gestión de identidades y accesos que has definido en Roles y permisos necesarios para exportar desde Cloud SQL para MySQL, revócalo.

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

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

En las siguientes secciones se ofrece información sobre cómo importar datos de varios archivos en paralelo a Cloud SQL para MySQL.

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

Para importar datos de Cloud Storage a Cloud SQL, el usuario que inicie 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 de la instancia de Cloud SQL debe tener uno de los siguientes roles:

Rol de gestión de identidades y accesos 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 gestión de identidades y accesos, consulta Gestión de identidades y accesos.

Importar datos en Cloud SQL para MySQL

Puede importar datos en paralelo desde varios archivos que residan en Cloud Storage a su base de datos. Para ello, usa la utilidad loadDump.

gcloud

Para importar datos de varios archivos en paralelo a Cloud SQL, siga estos pasos:

Crea un segmento de Cloud Storage.
Sube los archivos a tu segmento.

Nota: Asegúrate de que los archivos que vas a subir tengan el formato de volcado de MySQL Shell. Para obtener más información, consulta Exportar datos de varios archivos en paralelo.

Para obtener ayuda sobre cómo subir archivos a los contenedores, consulta Subir objetos desde archivos.
Para encontrar la cuenta de servicio de la instancia de Cloud SQL a la que vas a importar archivos, usa el comando
gcloud sql instances describe.
```
gcloud sql instances describe INSTANCE_NAME
```

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

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

Para asignar el storage.objectAdmin rol de gestión de identidades y accesos 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 gestión de identidades y accesos, consulta Usar permisos de gestión de identidades y accesos.
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 \
--parallel \ 
--threads=THREAD_NUMBER \
--database=DATABASE_NAME
```
Haz las siguientes sustituciones:
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL a la que vas a importar archivos en paralelo.
- BUCKET_NAME: el nombre del segmento de Cloud Storage.
- BUCKET_PATH: la ruta al segmento 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: número de subprocesos que usa Cloud SQL para importar archivos en paralelo. Por ejemplo, si quiere importar tres archivos a la vez en paralelo, especifique 3 como valor de este parámetro.
- DATABASE_NAME (opcional): nombre de las bases de datos de la instancia de Cloud SQL desde la que se realiza la importación. Si no especificas ninguna base de datos, Cloud SQL importará todas las bases de datos de la instancia.
Nota: Si quiere importar varios archivos en paralelo, utilice el parámetro parallel.

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

Si el comando devuelve un error como ERROR_RDBMS, revisa los permisos, ya que este error suele deberse a problemas con los permisos.
Si no necesitas los permisos de gestión de identidades y accesos que has definido en Roles y permisos necesarios para importar a Cloud SQL para MySQL, usa gcloud storage buckets remove-iam-policy-binding para quitarlos.

REST v1

Para importar datos de varios archivos en paralelo a Cloud SQL, siga estos pasos:

Crea un segmento de Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Haz las siguientes sustituciones:
- BUCKET_NAME: el nombre del segmento, sujeto a los requisitos de nomenclatura. Por ejemplo, my-bucket.
- PROJECT_NAME: el nombre del Google Cloud proyecto que contiene el segmento de Cloud Storage que vas a crear.
- LOCATION_NAME: la ubicación del contenedor en el que quieres almacenar los archivos que vas a importar. Por ejemplo, us-east1.
Sube los archivos a tu segmento.

Nota: Asegúrate de que los archivos que vas a subir tengan el formato de volcado de MySQL Shell. Para obtener más información, consulta Exportar datos de varios archivos en paralelo.

Para obtener ayuda sobre cómo subir archivos a los contenedores, consulta Subir objetos desde archivos.
Proporciona a tu instancia el storage.objectAdmin rol de gestión de identidades y accesos para tu segmento. Para obtener ayuda sobre cómo definir permisos de gestión de identidades y accesos, consulta el artículo Usar permisos de gestión de identidades y accesos.
Importar datos de varios archivos en paralelo en Cloud SQL:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_NAME: el nombre del Google Cloud proyecto que contiene el segmento de Cloud Storage que has creado.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL a la que vas a importar archivos en paralelo.
- BUCKET_NAME: el nombre del segmento de Cloud Storage.
- BUCKET_PATH: la ruta al segmento 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): nombre de las bases de datos de la instancia de Cloud SQL desde la que se realiza la importación. Si no especificas ninguna base de datos, Cloud SQL importará todas las bases de datos de la instancia.
- THREAD_NUMBER: número de subprocesos que usa Cloud SQL para importar archivos en paralelo. Por ejemplo, si quiere importar tres archivos a la vez en paralelo, especifique 3 como valor de este parámetro.
Nota: El parámetro offload te permite usar importaciones sin servidor en hasta dos subprocesos. El parámetro parallel te permite importar varios archivos en paralelo.

Para usar estas funciones, asigna el valor TRUE a estos parámetros. De lo contrario, asigna el valor FALSE.

Método HTTP y 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, despliega una de estas opciones:
curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, 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 presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, 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 siguiente:
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 ver la lista completa de parámetros de la solicitud, consulta la página de la API Admin de Cloud SQL.
Si no necesitas los permisos de gestión de identidades y accesos que has definido en Roles y permisos necesarios para importar a Cloud SQL para MySQL, usa gcloud storage buckets remove-iam-policy-binding para quitarlos.

REST v1beta4

Para importar datos de varios archivos en paralelo a Cloud SQL, siga estos pasos:

Crea un segmento de Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Haz las siguientes sustituciones:
- BUCKET_NAME: el nombre del segmento, sujeto a los requisitos de nomenclatura. Por ejemplo, my-bucket.
- PROJECT_NAME: el nombre del Google Cloud proyecto que contiene el segmento de Cloud Storage que vas a crear.
- LOCATION_NAME: la ubicación del contenedor en el que quieres almacenar los archivos que vas a importar. Por ejemplo, us-east1.
Sube los archivos a tu segmento.

Nota: Asegúrate de que los archivos que vas a subir tengan el formato de volcado de MySQL Shell. Para obtener más información, consulta Exportar datos de varios archivos en paralelo.

Para obtener ayuda sobre cómo subir archivos a los contenedores, consulta Subir objetos desde archivos.
Proporciona a tu instancia el storage.objectAdmin rol de gestión de identidades y accesos para tu segmento. Para obtener ayuda sobre cómo definir permisos de gestión de identidades y accesos, consulta el artículo Usar permisos de gestión de identidades y accesos.
Importar datos de varios archivos en paralelo en Cloud SQL:

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_NAME: el nombre del Google Cloud proyecto que contiene el segmento de Cloud Storage que has creado.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL desde la que vas a importar archivos en paralelo.
- BUCKET_NAME: el nombre del segmento de Cloud Storage.
- BUCKET_PATH: la ruta al segmento 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): nombre de las bases de datos de la instancia de Cloud SQL desde la que se realiza la importación. Si no especificas ninguna base de datos, Cloud SQL importará todas las bases de datos de la instancia.
- THREAD_NUMBER: número de subprocesos que usa Cloud SQL para importar archivos en paralelo. Por ejemplo, si quiere importar tres archivos a la vez en paralelo, especifique 3 como valor de este parámetro.
Nota: El parámetro offload te permite usar importaciones sin servidor en hasta dos subprocesos. El parámetro parallel te permite importar varios archivos en paralelo.

Para usar estas funciones, asigna el valor TRUE a estos parámetros. De lo contrario, asigna el valor FALSE.

Método HTTP y 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, despliega una de estas opciones:
curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, 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 presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, 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 siguiente:
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 ver la lista completa de parámetros de la solicitud, consulta la página de la API Admin de Cloud SQL.
Si no necesitas los permisos de gestión de identidades y accesos que has definido en Roles y permisos necesarios para importar a Cloud SQL para MySQL, usa gcloud storage buckets remove-iam-policy-binding para quitarlos.

Limitaciones

Si especificas demasiados subprocesos al importar o exportar 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. Comprueba el uso de memoria de tu instancia y aumenta su tamaño si es necesario. Para obtener más información, consulta Acerca de la configuración de instancias.
Cuando se realiza una exportación, no se admiten comas en los nombres de las bases de datos ni en los nombres de las tablas de los campos databases o tables.
Asegúrate de que tienes suficiente espacio en disco para descargar el archivo de volcado inicial. De lo contrario, aparecerá un error no space left on disk.
Si tu instancia solo tiene una CPU virtual (vCPU), no podrás importar ni exportar varios archivos en paralelo. El número de vCPUs de tu instancia no puede ser inferior al número de hilos que estés usando para la operación de importación o exportación, y el número de hilos debe ser al menos dos.
Las importaciones y exportaciones multiproceso (paralelas) no son compatibles con las importaciones y exportaciones de un solo proceso. Por ejemplo, los archivos de volcado generados por una exportación de un solo subproceso solo se pueden importar mediante importaciones de un solo subproceso. Del mismo modo, los archivos de volcado generados por exportaciones paralelas solo se pueden importar mediante importaciones paralelas.

Si escribes instrucciones de lenguaje de definición de datos (DDL), como CREATE, DROP o ALTER, durante una operación de exportación, es posible que la operación falle o que los datos exportados no sean coherentes con la instantánea de recuperación a un momento dado.
Si falla una operación de importación, es posible que queden datos importados parcialmente. MySQL confirma las instrucciones DDL automáticamente. Si esto ocurre, antes de volver a importar los datos, limpia las instrucciones DDL y los datos.
Al igual que en una operación de importación paralela de una sola base de datos, antes de ejecutar una operación de importación paralela de una instancia completa, asegúrate de que se hayan creado todas las bases de datos.

Siguientes pasos

Obtén más información sobre cómo comprobar el estado de las operaciones de importación y exportación.
Consulta cómo cancelar la importación y exportación de datos.
Consulta las prácticas recomendadas para importar y exportar datos.
Consulta los problemas conocidos de importación y exportación.

Exportar e importar archivos en paralelo Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Antes de empezar

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

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

Exportar 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

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

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

Importar datos en 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

Siguientes pasos

Exportar e importar archivos en paralelo