Convierte el código y el esquema de Oracle con la asistencia de Gemini

Database Migration Service integra Gemini para Google Cloud en los espacios de trabajo de conversión para ayudarte a acelerar y mejorar el proceso de conversión en dos áreas:

  • Proporciona funciones de explicabilidad del código con el asistente de conversiones: un conjunto de instrucciones específicas que pueden ayudarte a comprender mejor la lógica de conversión, proponer correcciones para problemas de conversión o optimizar el código convertido.

  • Agiliza la aplicación de correcciones para problemas de conversión con las sugerencias de conversión de código de Gemini: un mecanismo en el que el modelo de Gemini puede aprender a medida que corriges problemas de conversión y sugieres cambios en otros objetos defectuosos del espacio de trabajo.

También puedes combinar los dos enfoques para obtener una experiencia de conversión de objetos de código completa y asistida por Gemini. Para obtener más información, consulta Ejemplo de flujo de trabajo para corregir objetos de código con problemas de conversión.

Tu código y esquema de SQL se almacenan en la región en la que creas el espacio de trabajo de conversión. Si usas la conversión asistida de código y esquemas con modelos de Gemini, es posible que tu código y tus esquemas se procesen en otras regiones.

Descubre cómo y cuándo Gemini para Google Cloud usa tus datos.

Costos

Para usar la asistencia de Gemini en los espacios de trabajo de conversión de Database Migration Service, debes habilitar Gemini para la API de Google Cloud . Se aplican los precios de Gemini. Para obtener más información, consulta los precios de Gemini para Google Cloud .

Antes de comenzar

Para usar la asistencia de Gemini en los espacios de trabajo de conversión de Database Migration Service, debes habilitar Gemini para Google Cloud en tu proyecto.

Habilitar la API

Después de habilitar Gemini para Google Cloud en tu proyecto, las funciones de Gemini se habilitan para todos tus espacios de trabajo de conversión. Más adelante, puedes inhabilitar las sugerencias en un espacio de trabajo específico.

Usa el asistente de conversiones de Gemini

El asistente de conversiones es un conjunto de instrucciones específicas que puedes usar para obtener una mejor comprensión de la lógica de conversión de objetos, solicitar ideas sobre cómo optimizar el código y solucionar tus problemas de conversión, o incluso agregar comentarios a tu esquema para autodocumentar objetos de base de datos.

Una captura de pantalla que muestra cómo acceder a las instrucciones de Gemini para la explicabilidad de las conversiones de esquemas y códigos.
Figura 1. Instrucciones del asistente de conversiones de Gemini. (haz clic para agrandar)
Una captura de pantalla que muestra cómo acceder a las instrucciones de Gemini para la explicabilidad de las conversiones de esquemas y códigos.

Ayúdame a solucionar problemas de conversión de objetos

A veces, el motor de conversión de esquemas y código basado en reglas puede tener problemas cuando traduce objetos de Oracle a PostgreSQL. Por ejemplo, es posible que algunas funciones de Oracle no tengan equivalentes directos en PostgreSQL. Puedes usar el mensaje Ayúdame a solucionar problemas de conversión de objetos para obtener una propuesta de cambios de código que puedan solucionar el problema de conversión.

Esta indicación solo está disponible para los objetos de código editables que tienen problemas de conversión. No puedes ver esta solicitud para otros tipos de objetos en el lugar de trabajo de conversiones.

Para usar esta instrucción, haz lo siguiente:

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

    Ir a Lugares de trabajo de conversión

  2. En la lista de lugares de trabajo de conversión disponibles, selecciona el que quieras usar.

    Se abrirá el editor del lugar de trabajo de conversión.

  3. En el panel Oracle, selecciona uno de tus objetos de Oracle.

  4. En la vista de detalles del objeto, selecciona Asistente de conversiones > Ayúdame a solucionar problemas de conversión de objetos.

    Se abrirá un panel con los resultados de la instrucción.

  5. Verifica la pantalla de diferencias que muestra las mejoras propuestas. Si te gustan los resultados, puedes usar el botón Insertar sugerencia para actualizar el objeto convertido.

  6. Repite los pasos para cada objeto de código defectuoso. A medida que aplicas las propuestas de código, los modelos de Gemini aprenden el patrón y pueden ofrecer sugerencias sobre cómo propagar las correcciones a todos los objetos defectuosos de tu espacio de trabajo.

Explica la lógica de conversión de este objeto

Con la instrucción Explica la lógica de conversión de este objeto, puedes obtener una explicación paso a paso de lo que hace el código convertido, incluido un resumen de las prácticas recomendadas aplicadas en el código nuevo.

Para solicitar una explicación de la lógica de conversión de objetos, haz lo siguiente:

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

    Ir a Lugares de trabajo de conversión

  2. En la lista de lugares de trabajo de conversión disponibles, selecciona el que quieras usar.

    Se abrirá el editor del lugar de trabajo de conversión.

  3. En el panel Oracle, selecciona uno de tus objetos de Oracle.

  4. En la vista de detalles del objeto, selecciona Asistente de conversiones > Explica la lógica de conversión de este objeto.

    Se abrirá un panel con los resultados de la instrucción.

Ayuda para optimizar este código

A veces, los resultados de la conversión de código y esquema basados en reglas pueden ser técnicamente correctos, pero no están completamente optimizados para entornos de PostgreSQL. Puedes usar la instrucción Ayúdame a optimizar este código para obtener una propuesta con optimizaciones de código para tu objeto de base de datos.

Para usar esta instrucción, haz lo siguiente:

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

    Ir a Lugares de trabajo de conversión

  2. En la lista de lugares de trabajo de conversión disponibles, selecciona el que quieras usar.

    Se abrirá el editor del lugar de trabajo de conversión.

  3. En el panel Oracle, selecciona uno de tus objetos de Oracle.

  4. En la vista de detalles del objeto, selecciona Asistente de conversiones > Ayúdame a optimizar este código.

    Se abrirá un panel con los resultados de la instrucción.

  5. En el panel de resultados, lee la explicación, revisa el código y asegúrate de que la propuesta esté alineada con lo que necesitas. Si te gustan los resultados, puedes usar el botón Insertar sugerencia para actualizar el objeto convertido.

Agrega comentarios para explicar el propósito de este objeto

La instrucción Agrega comentarios para explicar el propósito de este objeto produce una propuesta de comentarios de código que puedes agregar a tu objeto de base de datos para el esquema de autodocumentación.

Para usar esta instrucción, haz lo siguiente:

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

    Ir a Lugares de trabajo de conversión

  2. En la lista de lugares de trabajo de conversión disponibles, selecciona el que quieras usar.

    Se abrirá el editor del lugar de trabajo de conversión.

  3. En el panel Oracle, selecciona uno de tus objetos de Oracle.

  4. En la vista de detalles del objeto, selecciona Asistente de conversiones > Agrega comentarios para explicar el propósito de este objeto.

    Se abrirá un panel con los resultados de la instrucción.

  5. En el panel de resultados, lee la explicación, revisa el código y asegúrate de que la propuesta esté alineada con lo que necesitas. Si te gustan los resultados, puedes usar el botón Insertar sugerencia para actualizar el objeto convertido.

Cómo propagar las correcciones de problemas de conversión con la conversión de código de Gemini

Cuando corriges problemas de conversión en tu lugar de trabajo, los modelos de Gemini pueden aprender de tus correcciones y sugerir cambios en otros objetos defectuosos del lugar de trabajo. De esta manera, puedes propagar tus correcciones a varios objetos sin hacer todas las modificaciones de forma manual.

Cómo ver las sugerencias de conversión de Gemini en Database Migration Service

Cuando corriges problemas de objetos (editando el código del objeto SQL o aplicando el código que propone la instrucción Ayúdame a solucionar problemas de conversión de objetos), los modelos de Gemini analizan tus cambios. Después de realizar suficientes cambios, la integración de Gemini muestra un mensaje y sugiere más ediciones.

Para acceder a las sugerencias asistidas por Gemini, sigue estos pasos:

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

    Ir a Lugares de trabajo de conversión

  2. En la lista de lugares de trabajo de conversión disponibles, selecciona el que quieras usar.

    Se abrirá el editor del lugar de trabajo de conversión.

  3. En el panel Oracle, selecciona el objeto cuyo SQL generado quieres ajustar.

  4. Soluciona los problemas de conversión que encuentres con el objeto y guarda los cambios de código. Puedes editar el código de forma manual o usar el mensaje Ayúdame a solucionar problemas de conversión de objetos.

    Los modelos de Gemini analizan tus correcciones más recientes hasta que pueden sugerir actualizaciones similares a otros objetos con problemas de conversión. Cuando los modelos de Gemini hayan analizado suficientes correcciones, se mostrará el diálogo Revisar sugerencias de Gemini.

    Diálogo de sugerencias de Gemini para corregir problemas.
    Figura 2. Diálogo de sugerencias de Gemini para corregir problemas (haz clic para agrandar)
    Diálogo de sugerencias de Gemini para corregir problemas.
  5. Para ver las sugerencias generadas por IA que se basan en los cambios que hiciste, haz clic en Revisar sugerencias.

Revisa las sugerencias de conversiones de Gemini

En la página Corregir problemas con Gemini, se muestran sugerencias generadas por los modelos de Gemini en función de los cambios de código que realizaste. Estas sugerencias contienen cambios similares que puedes aplicar a otros objetos. Para cada sugerencia, puedes revisarla, cambiarla, aceptarla o ignorarla.

La página Soluciona problemas con Gemini muestra tres variantes del código fuente de un objeto, que puedes seleccionar en el menú Edit view:

  • Código fuente original (solo lectura)
  • Borrador del código fuente de destino (solo lectura)
  • Código fuente de destino generado con la asistencia de Gemini (editable)

El panel Objetos contiene una lista de objetos que tienen problemas y correcciones sugeridas por los modelos de Gemini.

Para revisar las sugerencias de Gemini, sigue estos pasos:

  1. Haz clic en un objeto para mostrar la corrección relacionada sugerida por IA.
  2. Revisa y edita el código que sugirieron los modelos de Gemini.
  3. Realiza una de las siguientes acciones:

    • Para aceptar la sugerencia (incluidas tus ediciones), haz clic en Aceptar código. Los cambios se aplican al objeto en el espacio de trabajo de conversiones, y el estado del objeto en la lista de objetos cambia de Pendiente a Aceptado.

    • Para conservar la sugerencia (incluidas tus ediciones) sin aplicar los cambios, cambia a un objeto diferente. El objeto permanece en el estado Pendiente. Puedes editar el código y aceptar o ignorar la sugerencia más adelante.

    • Para ignorar las sugerencias pendientes o aceptadas (y revertir tus ediciones), haz clic en Ignorar código. El estado del objeto en la lista de objetos cambia de Pendiente a Ignorado. Se revierten tus cambios. Puedes editar el código y aplicarlo más adelante.

Para cerrar las sugerencias de Gemini y descartar todos los cambios que no hayas aplicado, sigue estos pasos:

  1. En la página Corregir problemas con Gemini, haz clic en la flecha hacia atrás.
  2. En el diálogo Cerrar Gemini, haz clic en Cerrar.

    Se cerró la sesión actual de Gemini. Para volver a la página de sugerencias, vuelve a acceder a las sugerencias de Gemini.

Inhabilita las sugerencias de conversiones de Gemini

De forma predeterminada, las sugerencias de conversiones de Gemini están habilitadas para tus espacios de trabajo de conversiones después de que habilitas Gemini para tu proyecto. Puedes inhabilitar las sugerencias de Gemini en un espacio de trabajo de conversión específico. Para inhabilitar las sugerencias de corrección de código de Gemini, sigue estos pasos:

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

    Ir a Lugares de trabajo de conversión

  2. En la lista de lugares de trabajo de conversión disponibles, selecciona el que quieras usar.

    Se abrirá el editor del lugar de trabajo de conversión.

  3. En la barra de tareas, haz clic en pen_spark Gemini y selecciona Sugerencia de código.

Las sugerencias de conversión de código de Gemini ahora están inhabilitadas para este espacio de trabajo de conversión.

¿Qué sigue?