Exportar e importar utilizando archivos de volcado de SQL

Esta página describe cómo exportar e importar datos a instancias de Cloud SQL mediante archivos de volcado de SQL.

Antes de empezar

Las exportaciones utilizan recursos de la base de datos, pero no interfieren con las operaciones normales de la base de datos a menos que la instancia tenga un suministro insuficiente.

Para conocer las mejores prácticas, consulte Mejores prácticas para importar y exportar datos .

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

Exportar datos de Cloud SQL para PostgreSQL

Roles y permisos necesarios para exportar desde Cloud SQL para PostgreSQL

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

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

  • La función de administración de identidades y accesos (IAM) storage.objectAdmin
  • Un rol personalizado, que incluye 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, consulte Administración de identidad y acceso .

Exportar a un archivo de volcado de SQL desde Cloud SQL para PostgreSQL

Cuando utiliza Cloud SQL para realizar una exportación, ya sea desde elGoogle Cloud consola, la CLI de gcloud o la API, está utilizando la utilidad pg_dump , con las opciones necesarias para garantizar que el archivo de exportación resultante sea válido para volver a importarlo a Cloud SQL.

Si planea importar sus datos a Cloud SQL, debe seguir las instrucciones proporcionadas en Exportar datos desde un servidor de base de datos externo para que su archivo de volcado de SQL tenga el formato correcto para Cloud SQL.

Para exportar datos desde una base de datos en una instancia de Cloud SQL a un archivo de volcado de SQL en un depósito de Cloud Storage:

Consola

  1. En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .

    Ir a Instancias de Cloud SQL

  2. Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.
  3. Haga clic en Exportar .
  4. En la sección Formato de archivo , haga clic en SQL para crear un archivo de volcado de SQL.
  5. En la sección Datos a exportar , utilice el menú desplegable para seleccionar la base de datos desde la que desea exportar.
  6. En la sección Destino , seleccione Explorar para buscar un depósito o carpeta de Cloud Storage para su exportación.
  7. Haga clic en Exportar para comenzar la exportación.

nube g

  1. Crear un depósito de almacenamiento en la nube .
  2. Busca la cuenta de servicio de la instancia de Cloud SQL desde la que estás exportando. Puedes hacerlo ejecutando el comando gcloud sql instances describe . Busca el campo serviceAccountEmailAddress en la salida.
    gcloud sql instances describe INSTANCE_NAME
      
  3. Use gcloud storage buckets add-iam-policy-binding para otorgar el rol de IAM storage.objectAdmin a la cuenta de servicio. Para obtener ayuda con la configuración de permisos de IAM, consulte Uso de permisos de IAM .
  4. Exporta la base de datos a tu depósito de Cloud Storage:
    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 sí vistas. Para exportar activadores o procedimientos almacenados, utilice la herramienta pg_dump .

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

  5. Si no necesita conservar la función de IAM que configuró anteriormente, revocarla ahora.

REST versión 1

  1. Crear un depósito para la exportación:
    gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME

    Este paso no es obligatorio, pero es muy recomendable, para no abrir el acceso a ningún otro dato.

  2. Asigne a su instancia el rol de IAM legacyBucketWriter para su bucket. Para obtener ayuda con la configuración de permisos de IAM, consulte Uso de permisos de IAM .
  3. Exportar su base de datos:

    Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

    • 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

    Método HTTP y URL:

    POST https://sqladmin.googleapis.com/v1/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,
           "sqlExportOptions": {
            "clean": [TRUE|FALSE],
            "ifExists": [TRUE|FALSE]
           }
        }
     }
    

    Para enviar su solicitud, expanda una de estas opciones:

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

  4. Si no necesita conservar la función IAM que configuró anteriormente, elimínela ahora.
Para obtener la lista completa de parámetros para la solicitud, consulte la página instancias:export .

REST v1beta4

  1. Crear un depósito para la exportación:
    gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
    

    Este paso no es obligatorio, pero es muy recomendable, para no abrir el acceso a ningún otro dato.

  2. Asigne a su instancia el rol de IAM storage.objectAdmin para su bucket. Para obtener ayuda con la configuración de permisos de IAM, consulte Uso de permisos de IAM .
  3. Exportar su base de datos:

    Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

    • 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

    Método HTTP y URL:

    POST https://sqladmin.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,
            "sqlExportOptions": {
             "clean": [TRUE|FALSE],
             "ifExists": [TRUE|FALSE]
            }
         }
      }
    

    Para enviar su solicitud, expanda una de estas opciones:

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

  4. Si no necesita conservar la función de IAM que configuró anteriormente, revocarla ahora.
Para obtener la lista completa de parámetros para la solicitud, consulte la página instancias:export .

Importar datos a Cloud SQL para PostgreSQL

Roles y permisos necesarios para importar a Cloud SQL para PostgreSQL

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

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

  • La función de IAM storage.objectAdmin
  • Un rol personalizado, que incluye los siguientes permisos:
    • storage.objects.get
    • storage.objects.list (solo para importar archivos en paralelo)

Para obtener ayuda con los roles de IAM, consulte Administración de identidad y acceso .

Importar un archivo de volcado de SQL a Cloud SQL para PostgreSQL

Los archivos SQL son archivos de texto simple con una secuencia de comandos SQL.

Consola

  1. En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .

    Ir a Instancias de Cloud SQL

  2. Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.
  3. Haga clic en Importar .
  4. En la sección Elija el archivo desde el cual desea importar datos , ingrese la ruta al depósito y el archivo de volcado de SQL que se usará para la importación, o busque un archivo existente.

    Puede importar un archivo comprimido ( .gz ) o sin comprimir ( .sql ).

  5. Para Formato , seleccione SQL .
  6. Seleccione la base de datos a la que desea importar los datos.

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

  7. Si desea especificar un usuario para realizar la importación, seleccione el usuario.

    Si su archivo de importación contiene instrucciones que debe realizar un usuario específico, utilice este campo para especificar ese usuario.

  8. Haga clic en Importar para iniciar la importación.

nube g

  1. Crear un depósito de almacenamiento en la nube.
  2. Sube el archivo a tu bucket.

    Para obtener ayuda con la carga de archivos a los depósitos, consulte Cargar objetos .

  3. Describe la instancia a la que estás importando:
    gcloud sql instances describe INSTANCE_NAME
  4. Copie el campo serviceAccountEmailAddress .
  5. Utilice gcloud storage buckets add-iam-policy-binding para otorgar la función de IAM storage.objectAdmin a la cuenta de servicio para el 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, consulte Uso de permisos de IAM .
  6. Importar 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 , consulte la página de referencia del comando sql import sql .

    Si el comando devuelve un error como ERROR_RDBMS , revise los permisos; este error a menudo se debe a problemas de permisos.

  7. Si no necesita conservar los permisos de IAM que configuró anteriormente, elimínelos utilizando gcloud storage buckets remove-iam-policy-binding .

REST versión 1

  1. Cree un archivo de volcado de SQL. Las instrucciones vinculadas establecen indicadores que lo hacen compatible con Cloud SQL.

    • Si está importando datos desde un servidor PostgreSQL local:
      1. Cree un archivo de volcado de SQL siguiendo las instrucciones de Exportación de datos mediante pg_dump .
      2. Cree un depósito en Cloud Storage siguiendo las instrucciones que se indican en Crear depósitos .
      3. Cargue el archivo de volcado de SQL al depósito de Cloud Storage mediante el procedimiento descrito en Cargar objetos .
  2. Crear un depósito de almacenamiento en la nube.
  3. Sube el archivo a tu bucket.

    Para obtener ayuda con la carga de archivos a los depósitos, consulte Cargar objetos .

  4. Proporcione a su instancia los roles de IAM legacyBucketWriter y objectViewer para su bucket. Para obtener ayuda con la configuración de permisos de IAM, consulte Uso de permisos de IAM .
  5. Importa tu archivo de volcado:

    Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

    • project-id : El ID del proyecto
    • instance-id : El ID de la instancia
    • bucket_name : El nombre del depósito de almacenamiento en la nube
    • path_to_sql_file : La ruta 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 su solicitud, expanda una de estas opciones:

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

    Para utilizar un usuario diferente para la importación, especifique la propiedad importContext.importUser .

    Para obtener la lista completa de parámetros para la solicitud, consulte la página instancias:import .
  6. Si no necesita conservar los permisos de IAM que configuró anteriormente, elimínelos ahora.

REST v1beta4

  1. Cree un archivo de volcado de SQL. Las instrucciones vinculadas establecen indicadores que lo hacen compatible con Cloud SQL.

    • Si está importando datos desde un servidor PostgreSQL local:
      1. Cree un archivo de volcado de SQL siguiendo las instrucciones de Exportación de datos mediante pg_dump .
      2. Cree un depósito en Cloud Storage siguiendo las instrucciones que se indican en Crear depósitos .
      3. Cargue el archivo de volcado de SQL al depósito de Cloud Storage mediante el procedimiento descrito en Cargar objetos .
  2. Crear un depósito de almacenamiento en la nube.
  3. Sube el archivo a tu bucket.

    Para obtener ayuda con la carga de archivos a los depósitos, consulte Cargar objetos .

  4. Asigne a su instancia el rol de IAM storage.objectAdmin para su bucket. Para obtener ayuda con la configuración de permisos de IAM, consulte Uso de permisos de IAM .
  5. Importa tu archivo de volcado:

    Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

    • project-id : El ID del proyecto
    • instance-id : El ID de la instancia
    • bucket_name : El nombre del depósito de almacenamiento en la nube
    • path_to_sql_file : La ruta 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 su solicitud, expanda una de estas opciones:

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

    Para utilizar un usuario diferente para la importación, especifique la propiedad importContext.importUser .

    Para obtener la lista completa de parámetros para la solicitud, consulte la página instancias:import .
  6. Si no necesita conservar los permisos de IAM que configuró anteriormente, elimínelos ahora.

¿Qué sigue?