Exporta datos desde Cloud SQL

En esta página, se describe cómo exportar datos desde instancias de Cloud SQL o desde un servidor de base de datos no administrado por Cloud SQL.

Exportas los datos de Cloud SQL a un archivo de volcado de SQL o de SQL en Cloud Storage. Luego, puedes importar el archivo en otra base de datos de MySQL en Cloud SQL. También puedes descargar datos de Cloud Storage a un entorno local si deseas acceder a ellos de forma local.

Para exportar datos a Cloud Storage, la cuenta de servicio de la instancia debe tener la función de IAM storage.objectAdmin establecida en el proyecto. Si deseas obtener más información, consulta Cloud Identity and Access Management para Cloud Storage.

Las exportaciones 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.

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

Puedes exportar un archivo CSV. También puedes exportar un archivo de volcado de SQL, por ejemplo, si deseas exportar a otra base de datos SQL.

Comparación entre la exportación estándar y la exportación sin servidores

En una exportación estándar desde Cloud SQL, la exportación se ejecuta mientras la base de datos está en línea. Cuando las bases de datos que se exportan son más pequeñas, es probable que el efecto sea mínimo. Sin embargo, cuando hay objetos o bases de datos grandes, como BLOB en la base de datos, existe la posibilidad de que la exportación disminuya el rendimiento de la base de datos. Esto puede afectar el tiempo que lleva realizar consultas y operaciones de base de datos en la base de datos. Una vez que comienzas una exportación, no es posible detenerla si la base de datos comienza a responder con lentitud.

Para evitar respuestas lentas durante una exportación, puedes usar la exportación sin servidores. Con la exportación sin servidores, Cloud SQL crea una instancia temporal separada para descargar la operación de exportación. La descarga de la operación de exportación permite que las bases de datos en la instancia principal continúen con la entrega de consultas y realicen operaciones con la tasa de rendimiento habitual. Cuando se completa la exportación de datos, la instancia temporal se borra de forma automática.

Una exportación sin servidores tiene mayor duración que una estándar, ya que lleva tiempo crear la instancia temporal. Como mínimo, lleva más de cinco minutos, pero para bases de datos más grandes, puede tomar más. Antes de determinar qué tipo de exportación usar, considera el efecto en el tiempo y el rendimiento.

Puedes usar la exportación sin servidores en una instancia principal o una réplica de lectura.

Las exportaciones de CSV y mysqldump se comportan de la misma manera en Cloud SQL como lo harían en cualquier otra base de datos MySQL. La base de datos no se bloquea durante la operación de exportación, a menos que uses la opción --master-data durante esta operación.

Las exportaciones 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.

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

Usa el mismo modo SQL para importar y exportar

La configuración del modo SQL afecta la forma en la que Cloud SQL interpreta las consultas de SQL. Por ejemplo, si exportas desde una base de datos que no tiene el modo SQL Estricto habilitado y, luego, intentas importar a Cloud SQL (que habilita el modo SQL Estricto de forma predeterminada), la importación puede fallar. La práctica recomendada es usar en la importación el mismo modo SQL que usaste para la exportación. Revisa el modo SQL en las bases de datos de origen y de destino para comprobar la compatibilidad. Presta especial atención a las marcas que habilitan el modo SQL Estricto. Si el modo SQL Estricto NO está establecido en la base de datos, te recomendamos quitarlo de Cloud SQL. Si lo quitas, debes establecer otra marca. Para verificar que la instancia de Cloud SQL tenga el modo deseado, ejecuta SELECT @@GLOBAL.sql_mode;.

Exporta datos de Cloud SQL a un archivo de volcado de SQL

Para crear un archivo de volcado de SQL, exporta datos de Cloud SQL a Cloud Storage. Una vez que el archivo esté en Cloud Storage, puedes importarlo a otra base de datos de Cloud SQL. También puedes descargar datos de Cloud Storage a un entorno local si deseas acceder a ellos de forma local.

Antes de comenzar

En este procedimiento, se requiere que exportes un archivo a Cloud Storage. Para exportar datos a Cloud Storage, la cuenta de servicio de la instancia debe tener las funciones de IAM storage.objectAdmin configuradas en el proyecto. Si deseas obtener ayuda con las funciones de IAM, consulta Cloud Identity and Access Management para Cloud Storage.

Puedes encontrar el nombre de la cuenta de servicio de la instancia en Google Cloud Console en la página Descripción general de la instancia. Puedes verificar las funciones del depósito de Cloud Storage mediante la herramienta de gsutil para inspeccionar el depósito:

gsutil iam get gs://[BUCKET_NAME]

Obtén más información sobre cómo usar IAM con depósitos.

Exporta datos a un archivo de volcado de SQL en Cloud Storage

Para exportar datos de una base de datos en una instancia de Cloud SQL a un archivo de volcado de SQL en un depósito de Cloud Storage, sigue estos pasos:

Console

  1. Ve a la página Instancias de Cloud SQL en Google Cloud Console.

    Ir a la página Instancias de Cloud SQL

  2. Haz clic en la instancia desde la que deseas exportar datos para abrir la página Descripción general.
  3. Haz clic en EXPORTAR en la barra de botones.
  4. En Ubicación de la exportación de Cloud Storage, selecciona Explorar a fin de buscar un depósito o una carpeta de Cloud Storage para tu exportación.
  5. En Formato, haz clic en SQL para crear un archivo de volcado de SQL.
  6. Haz clic en Mostrar opciones avanzadas.
  7. En Base de datos para exportar, usa el menú desplegable a fin de seleccionar una sola base de datos.
  8. Haz clic en Exportar para comenzar la exportación.
  9. Se abrirá el cuadro de diálogo ¿Exportar base de datos? con un mensaje que indica que el proceso de exportación puede tomar una hora o más en el caso de las bases de datos grandes. Durante la exportación, la única operación que puedes realizar en la instancia es visualizar la información. No podrás detener la exportación una vez que comience. Si es un buen momento para comenzar una exportación, haz clic en EXPORTAR. De lo contrario, haz clic en CANCELAR.

gcloud

  1. Si aún no lo hiciste, crea un depósito de Cloud Storage.

    Para obtener ayuda sobre cómo crear un depósito, consulta Crea depósitos de almacenamiento.

  2. Sube el archivo a tu depósito.

    Para obtener ayuda sobre cómo subir archivos a depósitos, consulta la sección sobre cómo subir objetos.

  3. Describe la instancia desde la que exportas:
      gcloud sql instances describe [INSTANCE_NAME]
      
  4. Copia el campo serviceAccountEmailAddress.
  5. Usa gsutil iam para otorgar la función de IAM storage.objectAdmin a la cuenta de servicio del depósito. Para obtener ayuda con la configuración de permisos de IAM, consulta Usa permisos de IAM.
  6. Exporta la base de datos:
      gcloud sql export sql [INSTANCE_NAME] gs://[BUCKET_NAME]/sqldumpfile.gz \
                                  --database=[DATABASE_NAME] --offload
      

    El comando export sql no contiene activadores ni procedimientos almacenados, pero contiene vistas. Para exportar activadores o procedimientos almacenados, usa la herramienta mysqldump.

    Para obtener más información sobre el uso del comando export sql, consulta la página de referencia del comando sql export sql.

  7. Si no necesitas retener la función de IAM que configuraste antes, revócala ahora.

REST

  1. Crea un depósito para la exportación:
    gsutil mb -p [PROJECT_NAME] -l [LOCATION_NAME] gs://[BUCKET_NAME]
    

    Este paso no es obligatorio, pero se recomienda para no habilitar el acceso a otros datos.

  2. Otórgale a tu 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.
  3. Exporta tu base de datos:

    Antes de usar cualquiera de los datos de solicitud siguientes, 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_dump_file: La ruta al archivo de volcado de SQL
    • database_name_1: El nombre de una base de datos dentro de la instancia de Cloud SQL
    • database_name_2: El nombre de una base de datos dentro de la instancia de Cloud SQL
    • offload: Habilita la exportación sin servidores. Configúralo como true para usar la exportación sin servidores.

    Método HTTP y URL:

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

    Cuerpo JSON de la solicitud:

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

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

  4. Si no necesitas retener la función de IAM que configuraste antes, revócala ahora.
A fin de obtener una lista completa de los parámetros para esta solicitud, consulta la página instances:export.

Exporta datos de Cloud SQL a un archivo CSV

Puedes exportar tus datos en el formato CSV de modo que otras herramientas y entornos puedan usarlos. Las exportaciones se realizan a nivel de la base de datos. Durante una exportación de CSV, puedes especificar los esquemas que se exportarán. Todos los esquemas en el nivel de la base de datos son aptos para la exportación.

Antes de comenzar

En este procedimiento, se requiere que exportes un archivo a Cloud Storage. Para exportar datos a Cloud Storage, la cuenta de servicio de la instancia debe tener las funciones de IAM storage.objectAdmin configuradas en el proyecto. Si deseas obtener ayuda con las funciones de IAM, consulta Cloud Identity and Access Management para Cloud Storage.

Puedes encontrar el nombre de la cuenta de servicio de la instancia en Google Cloud Console en la página Descripción general de la instancia. Puedes verificar las funciones del depósito de Cloud Storage mediante la herramienta de gsutil para inspeccionar el depósito:

gsutil iam get gs://[BUCKET_NAME]

Obtén más información sobre cómo usar IAM con depósitos.

Exporta datos a un archivo CSV en Cloud Storage

Para exportar datos de una base de datos en una instancia de Cloud SQL a un archivo de volcado de SQL en un depósito de Cloud Storage, sigue estos pasos:

Console

  1. Ve a la página Instancias de Cloud SQL en Google Cloud Console.

    Ir a la página Instancias de Cloud SQL

  2. Haz clic en la instancia para abrir la página Descripción general.
  3. Haz clic en EXPORTAR.
  4. En Ubicación de la exportación de Cloud Storage, selecciona un depósito o una carpeta de Cloud Storage para la exportación.
  5. En el campo Nombre, proporciona un nombre para tu archivo de exportación y haz clic en Seleccionar.

    Puedes usar una extensión de archivo .gz para comprimir el archivo de exportación.

  6. Establece el Formato en CSV.
  7. Haz clic en Mostrar opciones avanzadas.
  8. En Base de datos, selecciona el nombre de la base de datos en el menú desplegable.
  9. En Consulta de SQL, ingresa una consulta de SQL para especificar la tabla desde la que deseas exportar los datos.

    Por ejemplo, para exportar todo el contenido de la tabla entries en la base de datos guestbook, deberías ingresar lo siguiente:

    SELECT * FROM guestbook.entries;
    En tu consulta, debes especificar una tabla de la base de datos especificada; no puedes exportar una base de datos completa en formato CSV.

  10. Haz clic en Exportar para comenzar la exportación.
  11. Se abrirá el cuadro de diálogo ¿Exportar base de datos? con un mensaje que indica que el proceso de exportación puede tomar una hora o más en el caso de las bases de datos grandes. Durante la exportación, la única operación que puedes realizar en la instancia es visualizar la información. No podrás detener la exportación una vez que comience. Si es un buen momento para comenzar una exportación, haz clic en EXPORTAR. De lo contrario, haz clic en CANCELAR.

gcloud

  1. Si aún no lo hiciste, crea un depósito de Cloud Storage.

    Para obtener ayuda sobre cómo crear un depósito, consulta Crea depósitos de almacenamiento.

  2. Sube el archivo a tu depósito.

    Para obtener ayuda sobre cómo subir archivos a depósitos, consulta la sección sobre cómo subir objetos.

  3. Describe la instancia desde la que exportas:
    gcloud sql instances describe [INSTANCE_NAME]
    
  4. Usa gsutil iam para otorgar la función de IAM storage.objectAdmin a la cuenta de servicio del depósito. Para obtener ayuda con la configuración de permisos de IAM, consulta Usa permisos de IAM.
  5. Exporta la base de datos:
    gcloud sql export csv [INSTANCE_NAME] gs://[BUCKET_NAME]/[FILE_NAME] \
                                --database=[DATABASE_NAME]
                                --offload
                                --query=[SELECT_QUERY]
    

    Para obtener información sobre el uso del comando export csv, consulta la página de referencia del comando sql export csv.

  6. Si no necesitas retener la función de IAM que configuraste antes, revócala ahora.

REST

  1. Crea un depósito para la exportación:
    gsutil mb -p [PROJECT_NAME] -l [LOCATION_NAME] gs://[BUCKET_NAME]
    

    Este paso no es obligatorio, pero se recomienda para no habilitar el acceso a otros datos.

  2. Otórgale a tu 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.
  3. Exporta tu base de datos:

    Antes de usar cualquiera de los datos de solicitud siguientes, 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_csv_file: La ruta de acceso al archivo CSV
    • database_name: El nombre de una base de datos dentro de la instancia de Cloud SQL
    • offload: Habilita la exportación sin servidores. Configúralo como true para usar la exportación sin servidores.
    • select_query: La consulta de SQL para la exportación

    Método HTTP y URL:

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

    Cuerpo JSON de la solicitud:

    {
     "exportContext":
       {
          "fileType": "CSV",
          "uri": "gs://bucket_name/path_to_csv_file",
          "databases": ["database_name"],
          "offload": true | false
          "csvExportOptions":
           {
               "selectQuery":"select_query"
           }
       }
    }
    

    Para enviar tu solicitud, expande una de estas opciones:

    Deberías recibir una respuesta JSON similar a la siguiente:

    Si tu consulta elegida especifica una base de datos, anula la propiedad databases.

  4. Si no necesitas retener la función de IAM que configuraste antes, revócala ahora.
A fin de obtener una lista completa de los parámetros para esta solicitud, consulta la página instances:export.

Exportar en formato CSV es equivalente a ejecutar la siguiente instrucción de SQL:

  SELECT [QUERY] INTO OUTFILE ... CHARACTER SET 'utf8mb4'
        FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '\"'
        ESCAPED BY '\\' LINES TERMINATED BY '\n'

A fin de obtener una lista completa de los parámetros para esta solicitud, consulta la página instances:export.

Exporta datos de tu servidor de MySQL local a un archivo CSV

Si deseas exportar una base de datos de MySQL que no está administrada por Cloud SQL a un archivo CSV para luego importarla a Cloud SQL, utiliza el siguiente comando:

mysql --host=[INSTANCE_IP] --user=[USER_NAME] --password [DATABASE] \
-e " SELECT * FROM [TABLE] INTO OUTFILE '[FILE_NAME]' CHARACTER SET 'utf8mb4'
     FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '\"' ESCAPED BY '\"' "

Exporta datos con mysqldump

Si exportas datos desde una base de datos de MySQL local o desde una base de datos de Cloud SQL para importar a una base de datos de Cloud SQL, debes usar la herramienta mysqldump con las siguientes marcas:

  • --databases: Debes usar la opción --databases a fin de especificar una lista explícita de bases de datos para exportar, y esta lista no debe contener la base de datos del sistema mysql.
  • --hex-blob: Si tu base de datos contiene campos binarios, debes usar esta marca para asegurarte de que los campos binarios se importen de forma correcta.
  • --set-gtid-purged=OFF: La información GTID no se debe incluir en el archivo de volcado de SQL, ni el archivo de volcado de SQL debe inhabilitar el registro binario. (No se requiere para MySQL 5.5 o replicación externa).
  • --single-transactionReplica desde un servidor externo

Configuración estándar

En una línea de comandos, ejecuta mysqldump:

mysqldump --databases [DATABASE_NAME] -h [INSTANCE_IP] -u [USERNAME] -p \
--hex-blob --single-transaction --set-gtid-purged=OFF \
--default-character-set=utf8mb4 > [SQL_FILE].sql

Para obtener ayuda con mysqldump, consulta la referencia de mysqldump.

Replicación externa

Si deseas crear un archivo de volcado para usarlo en una configuración de servidor externo, consulta la sección sobre cómo replicar datos desde un servidor externo.

¿Qué sigue?