Crea un lugar de trabajo de conversión y convierte el esquema

En esta página, se muestra cómo crear un espacio de trabajo de conversión y usarlo para realizar de inmediato la conversión determinística de código y esquema de Oracle a PostgreSQL.

Puedes crear espacios de trabajo de conversión interactivos de dos maneras:

  • A través de una conexión directa con la base de datos: Database Migration Service se conecta directamente a la base de datos de origen en ejecución a través de un perfil de conexión y recupera el esquema a través de una conexión de red.

  • Con archivos de esquema en Cloud Storage: Puedes extraer los metadatos de tu esquema de forma local con las secuencias de comandos de extracción que proporciona Google, subir los archivos resultantes a un bucket de Cloud Storage y preparar tu espacio de trabajo sin conectarte a la base de datos de origen.

Conéctate directamente a la base de datos de origen

Puedes crear un espacio de trabajo de conversión interactivo y realizar la conversión de esquemas conectándote directamente a la base de datos de origen con Database Migration Service. Antes de crear el lugar de trabajo de esta manera, asegúrate de crear un perfil de conexión para tu base de datos de origen.

Roles necesarios para el método de conexión directa

Para obtener los permisos que necesitas para crear un espacio de trabajo de conversión, pídele a tu administrador que te otorgue el rol de IAM de Administrador de Database Migration (roles/datamigration.admin) en tu proyecto.

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso en la documentación de Identity and Access Management.

Este rol predefinido contiene los permisos necesarios para crear un espacio de trabajo de conversión en Database Migration Service. Para ver los permisos exactos que son necesarios, expande la sección Permisos necesarios:

Permisos necesarios

Se requieren los siguientes permisos para crear un espacio de trabajo de conversión en Database Migration Service:

  • cloudaicompanion.entitlements.get

    Este permiso se incluye en el rol roles/datamigration.admin. Es obligatorio para las funciones de conversión mejoradas con Gemini.

  • datamigration.conversionworkspaces.apply
  • datamigration.conversionworkspaces.commit
  • datamigration.conversionworkspaces.convert
  • datamigration.conversionworkspaces.create
  • datamigration.conversionworkspaces.delete
  • datamigration.conversionworkspaces.get
  • datamigration.conversionworkspaces.getIamPolicy
  • datamigration.conversionworkspaces.list
  • datamigration.conversionworkspaces.rollback
  • datamigration.conversionworkspaces.seed
  • datamigration.conversionworkspaces.setIamPolicy
  • datamigration.conversionworkspaces.update

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Crea un espacio de trabajo de conversión con un perfil de conexión

Para crear un espacio de trabajo de conversión en el que Database Migration Service se conecte a tu base de datos de origen y prepare la instantánea inicial de los objetos de la base de datos de origen, sigue estos pasos:

  1. En la consola de Google Cloud , ve a Espacios de trabajo de conversión.

    Ir a Espacios de trabajo de conversión

  2. Haz clic en Configurar espacio de trabajo.
  3. En la página Crea un espacio de trabajo de conversión, haz lo siguiente:
    1. Ingresa el nombre, el identificador y la región de tu espacio de trabajo de conversión.
    2. En el menú desplegable Motor de base de datos de origen, selecciona Oracle.
    3. En Motor de base de datos de destino, selecciona Cloud SQL para PostgreSQL.

    4. En la sección Habilita la configuración de Gemini para tu espacio de trabajo, usa las casillas de verificación para habilitar las funciones de conversión con tecnología de Gemini. También puedes habilitar estas funciones más adelante cuando quieras convertir código y esquemas con la asistencia de Gemini.

      Las funciones de conversión potenciadas por Gemini requieren la API de Gemini para Google Cloud . Para obtener más información, consulta Funciones de conversión potenciadas por Gemini.

    5. Haz clic en Crear espacio de trabajo y continuar.
  4. En la página Define la instantánea de esquema de origen y de extracción, haz lo siguiente:
    1. En la sección Método de conexión de origen, selecciona Perfil de conexión.
    2. En el menú desplegable Perfil de conexión de origen, selecciona el perfil de conexión para tu base de datos de origen.
    3. Haz clic en Extraer instantánea del esquema y continuar.

    Database Migration Service ahora se está conectando a la base de datos de origen y recuperando tu esquema. Este proceso puede tardar varios minutos.

  5. En la página Selecciona y convierte objetos, usa las casillas de verificación para seleccionar los objetos que deseas convertir a la sintaxis de PostgreSQL.

    No es necesario que conviertas todos tus objetos de una sola vez. En cambio, puedes seleccionar solo algunos objetos ahora y agregar más objetos a la conversión más adelante.

  6. Haz clic en Convertir y continuar.

    Se abrirá el espacio de trabajo de conversión.

  7. Cuando abras un lugar de trabajo nuevo por primera vez, podrás actualizarlo para acceder a la función de conversión automática potenciada por Gemini. Sigue estos pasos:
    • En el cuadro de diálogo Presentamos la conversión automática de Gemini, selecciona la casilla de verificación Actualiza el lugar de trabajo para explorar la nueva experiencia y haz clic en Continuar.
    • En el cuadro de diálogo ¿Quieres convertir objetos de origen con Gemini?, haz clic en Convertir.

      Database Migration Service ahora vuelve a realizar el proceso de conversión para aplicar las mejoras de conversión potenciadas por Gemini además de los resultados de la conversión determinística. Para obtener más información sobre la función de conversión automática de Gemini, consulta Conversión automática de Gemini.

Usa archivos de esquema almacenados en Cloud Storage

Puedes extraer los metadatos de tu esquema de forma local con las secuencias de comandos de extracción proporcionadas por Google, subir los archivos resultantes a un bucket de Cloud Storage y preparar tu lugar de trabajo sin conectarte a la base de datos de origen.

Roles obligatorios para usar los archivos de esquema en Cloud Storage

Para obtener los permisos que necesitas para crear un espacio de trabajo de conversión con archivos de esquema almacenados en Cloud Storage, pídele a tu administrador que otorgue los roles de IAM necesarios en tu proyecto para las siguientes cuentas involucradas en el proceso de migración:

  • Cuenta de usuario que crea el espacio de trabajo de conversión: Administrador de Database Migration (roles/datamigration.admin)
  • Cuenta de servicio de Database Migration Service: Rol de visualizador de objetos de Storage (roles/storage.objectViewer) en el bucket de Cloud Storage que almacena los archivos de esquema.

    La dirección de correo electrónico de la cuenta de servicio de Database Migration Service usa el siguiente formato: service-PROJECT_NUMBER@gcp-sa-datamigration.. Reemplaza PROJECT_NUMBER por el número del proyecto de Google Cloud . Para obtener más información sobre esta cuenta de servicio, consulta Cuenta de servicio de Database Migration Service.

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso en la documentación de Identity and Access Management.

El rol predefinido roles/datamigration.admin contiene los permisos necesarios para crear un espacio de trabajo de conversión en Database Migration Service. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear un espacio de trabajo de conversión en Database Migration Service:

  • cloudaicompanion.entitlements.get

    Este permiso se incluye en el rol roles/datamigration.admin. Es obligatorio para las funciones de conversión mejoradas con Gemini.

  • datamigration.conversionworkspaces.apply
  • datamigration.conversionworkspaces.commit
  • datamigration.conversionworkspaces.convert
  • datamigration.conversionworkspaces.create
  • datamigration.conversionworkspaces.delete
  • datamigration.conversionworkspaces.get
  • datamigration.conversionworkspaces.getIamPolicy
  • datamigration.conversionworkspaces.list
  • datamigration.conversionworkspaces.rollback
  • datamigration.conversionworkspaces.seed
  • datamigration.conversionworkspaces.setIamPolicy
  • datamigration.conversionworkspaces.update

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Crea un espacio de trabajo de conversión con archivos de esquema

Para crear un espacio de trabajo de conversión con archivos de esquema, sigue estos pasos.

  1. Recuperar las secuencias de comandos de Python de la consola de Google Cloud Sigue estos pasos:
    1. En la consola de Google Cloud , ve a Espacios de trabajo de conversión.

      Ir a Espacios de trabajo de conversión

    2. Haz clic en Configurar espacio de trabajo.
    3. En la página Crea un espacio de trabajo de conversión, haz lo siguiente:
      1. Ingresa el nombre, el identificador y la región del espacio de trabajo.
      2. En el menú desplegable Motor de base de datos de origen, selecciona Oracle.
      3. En el menú desplegable Motor de base de datos de destino, selecciona Cloud SQL para PostgreSQL.

      4. En la sección Habilita la configuración de Gemini para tu espacio de trabajo, usa las casillas de verificación para habilitar las funciones de conversión potenciadas por Gemini y haz clic en Continuar.

        También puedes habilitar estas funciones más adelante cuando quieras Convertir código y esquemas con la asistencia de Gemini. Las funciones de conversión potenciadas por Gemini requieren la API de Gemini para Google Cloud . Para obtener más información, consulta Funciones de conversión potenciadas por Gemini.

    4. En la página Define la instantánea de esquema de origen y de extracción, en la sección Método de conexión de origen, selecciona Cloud Storage.
    5. En la sección Antes de seleccionar una carpeta, junto al encabezado Extractor de metadatos de Oracle, haz clic en Abrir. Sigue las instrucciones del panel lateral para descargar y ejecutar la utilidad de extracción en tu base de datos de origen y producir los archivos JSON de metadatos del esquema. Esta utilidad requiere que puedas establecer una conexión de red con tu base de datos de origen.
  2. Crea un bucket de Cloud Storage dedicado en el que subas los archivos JSON de metadatos del esquema. Para obtener más información sobre cómo crear buckets de Cloud Storage, consulta Crea buckets en la documentación de Cloud Storage.
  3. Dentro del bucket de Cloud Storage dedicado, crea una carpeta vacía y dedicada para los archivos de esquema de la base de datos que exportaste en los pasos anteriores. Para obtener más información sobre cómo crear carpetas de Cloud Storage, consulta Crea y administra carpetas en la documentación de Cloud Storage.
  4. Sube solo los archivos de esquema JSON de metadatos que creaste con las secuencias de comandos de Python que recuperaste de la consola de Google Cloud en los pasos anteriores a la carpeta de base de datos dedicada y vacía en tu bucket de Cloud Storage.
  5. Sigue creando tu espacio de trabajo en la consola de Google Cloud o crea uno nuevo con Google Cloud CLI.

    Console

    1. Después de subir los archivos de metadatos del esquema extraídos a un bucket de Cloud Storage, continúa en la página Define la fuente y extrae la instantánea del esquema.
    2. En el campo Carpeta, haz clic en Explorar y selecciona la carpeta que contiene tus archivos de esquema.
    3. Haz clic en Extraer instantánea del esquema y continuar.

      Database Migration Service ahora analiza los metadatos del esquema del bucket.

    4. En la página Selecciona y convierte objetos, elige los objetos que deseas convertir y haz clic en Convertir y continuar.

    gcloud

    Después de subir los archivos de metadatos del esquema extraídos a un bucket de Cloud Storage, puedes crear e inicializar un lugar de trabajo nuevo con Google Cloud CLI. Lleva a cabo los pasos siguientes:

    1. Crea un espacio de trabajo de conversión vacío.
      Ejecuta el siguiente comando (haz clic para expandir):

      gcloud database-migration conversion-workspaces create

        gcloud database-migration conversion-workspaces create WORKSPACE_ID \
      --region=REGION \
      --source-database-engine=ORACLE \
      --destination-database-engine=POSTGRESQL

      Reemplaza lo siguiente:

      • WORKSPACE_ID: Es el identificador de tu espacio de trabajo de conversión.
      • REGION: Es la región en la que deseas crear el espacio de trabajo.

    2. Inicializa el espacio de trabajo con tus archivos de esquema en Cloud Storage.
      Para analizar y cargar los archivos de metadatos del esquema almacenados en tu bucket en el espacio de trabajo de conversión, ejecuta el siguiente comando (haz clic para expandir):

      gcloud database-migration conversion-workspaces seed

        gcloud database-migration conversion-workspaces seed WORKSPACE_ID \
      --region=REGION \
      --gcs-path=gs://BUCKET_NAME/PREFIX/

      Reemplaza lo siguiente:

      • WORKSPACE_ID: Es el identificador de tu espacio de trabajo de conversión.
      • REGION: Es la región en la que deseas crear el espacio de trabajo.
      • BUCKET_NAME: Es el nombre del bucket de Cloud Storage que contiene tus archivos de esquema.
      • PREFIX: Es la ruta de acceso a la carpeta que contiene los archivos de metadatos del esquema extraídos.

Espacios de trabajo de conversión heredados

Los espacios de trabajo de conversión heredados son un tipo de espacios de trabajo de conversión más antiguos y limitados. No recomendamos usar el tipo heredado de espacios de trabajo de conversión para tus migraciones. Si necesitas usar un espacio de trabajo de conversión heredado, expande la sección Crea un espacio de trabajo de conversión heredado y convierte el esquema para obtener más información.

Crea un espacio de trabajo de conversión heredado y convierte el esquema

Los espacios de trabajo de conversión heredados usan archivos de configuración de Ora2Pg. Antes de crear un espacio de trabajo de conversión heredado, asegúrate de crear primero tu configuración de Ora2Pg fuera de Database Migration Service. Para obtener más información, consulta Trabaja con espacios de trabajo de conversión heredados.

  1. En la consola de Google Cloud , ve a Espacios de trabajo de conversión.

    Ir a Espacios de trabajo de conversión

  2. Haz clic en Configurar espacio de trabajo.
  3. En la página Crea un espacio de trabajo de conversión, haz lo siguiente:
    1. Ingresa el nombre, el identificador y la región de tu espacio de trabajo de conversión.
    2. En el menú desplegable Motor de base de datos de origen, selecciona Oracle.
    3. En la lista desplegable Motor de base de datos de destino, selecciona Cloud SQL para PostgreSQL.
    4. Expande la sección Personalizar la configuración del espacio de trabajo y selecciona la casilla de verificación Habilitar espacio de trabajo de conversión heredada.
    5. Haz clic en Crear espacio de trabajo y continuar.
  4. En la página Conéctate a la fuente y convierte objetos, haz lo siguiente:
    1. En el menú desplegable Perfil de conexión de origen, selecciona el perfil de conexión para tu base de datos de origen.

    2. En el cuadro Archivo de configuración, haz clic en Explorar y usa el selector de archivos del sistema para elegir tu archivo de asignación de conversiones.

      Para subir varios archivos de asignación de conversiones, haz clic en Agregar archivo.

    3. En la sección Convertir la configuración, haz clic en Extraer el esquema y convertir.

      Database Migration Service ahora se conecta a la base de datos de origen, recupera tu esquema y lo convierte al esquema de SQL de destino según las reglas definidas en tu archivo de asignación de conversión. Este proceso puede tardar varios minutos.

  5. Haz clic en Guardar y cerrar.

    Se abrirá la página de detalles del espacio de trabajo de conversión.

Ahora puedes aplicar el esquema convertido a tu base de datos de destino. Si tu base de datos de origen incluye tablas que no tienen claves primarias, también debes crear manualmente restricciones de clave primaria en las tablas convertidas en la base de datos de destino después de aplicar el esquema convertido. Para obtener más información, consulta Trabaja con espacios de trabajo de conversión heredados.

¿Qué sigue?

Ahora puedes trabajar con tu espacio de trabajo de conversión para solucionar problemas de conversión, modificar tus objetos con el editor interactivo y aplicar el esquema convertido a tu base de datos de destino. Consulta Convierte el código y el esquema de Oracle a la sintaxis de PostgreSQL.