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

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

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 los modelos 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 lugares de trabajo de conversión de Database Migration Service, debes habilitar la API de Gemini for Google Cloud . Se aplican los precios de Gemini. Para obtener más información, consulta Gemini para Google Cloud precios.

Para usar las funciones potenciadas por Gemini en Database Migration Service, haz lo siguiente:

  1. Habilita Gemini para Google Cloud en tu proyecto.

    Habilitar la API

  2. Después de habilitar Gemini para Google Cloud en tu proyecto, el Asistente de conversiones y la coincidencia de patrones se habilitan automáticamente para todos los espacios de trabajo de conversiones de tu proyecto. Para usar la conversión automática, debes habilitarla por lugar de trabajo.

    La habilitación o inhabilitación de cada función potenciada por Gemini también depende de si usas un lugar de trabajo de conversiones actualizado. Para obtener más información sobre cómo habilitar o inhabilitar cada función, consulta las siguientes secciones de esta página.

Usa la conversión automática de Gemini

Cuando conviertes tu esquema de origen, Database Migration Service usa las reglas de conversión determinísticas para crear los equivalentes de sintaxis de PostgreSQL. La conversión automática integra correcciones potenciadas por Gemini además de los resultados determinísticos para reducir la cantidad de problemas de conversión y mejorar su calidad.

Para usar la conversión automática, haz lo siguiente:

  1. Crea un nuevo lugar de trabajo de conversión. Asegúrate de actualizarla de inmediato para usar la experiencia optimizada más reciente.
  2. Ve a Lugares de trabajo de conversión y selecciona tu lugar de trabajo.

    Ve a Lugares de trabajo de conversión

  3. Habilita la conversión automática para tu espacio de trabajo.
  4. Convierte tu código fuente y esquema. Haz clic en Convertir fuente.

    Database Migration Service emplea automáticamente mejoras potenciadas por Gemini en la conversión. Puedes usar la vista de árbol para ver qué objetos se mejoraron con Gemini:

    Vista del árbol de conversiones con un resumen de las mejoras potenciadas por Gemini.
    Figura 1. Vista de árbol del esquema de origen con el estado de la mejora de Gemini (haz clic para agrandar)
    Vista del árbol de conversiones con un resumen de las mejoras potenciadas por Gemini.
  5. En la vista de árbol, selecciona cualquier objeto aumentado para ver los detalles de las mejoras proporcionadas por la conversión automática. Si no te gustan los cambios que introdujo Gemini, haz clic en Usar código determinístico en su lugar para revertir el objeto a los resultados de conversión determinísticos.

    Panel de conversión automática potenciado por Gemini con detalles sobre los ajustes que se implementan en el esquema convertido.
    Figura 2. Panel de conversión automática potenciado por Gemini en el que puedes inspeccionar los detalles de las ampliaciones de código y esquema. (haz clic para agrandar)
    Panel de conversión automática potenciado por Gemini con detalles sobre los ajustes que se implementan en el esquema convertido.

Habilita la conversión automática

Si inhabilitaste la conversión automática, puedes habilitarla en el panel de Gemini:

  1. En la consola de Google Cloud, ve a Lugares de trabajo de conversión y selecciona tu lugar de trabajo.

    Ve a Lugares de trabajo de conversión

  2. Haz clic en pen_spark Gemini.

    Se abrirá el panel lateral de Gemini.

  3. Selecciona la casilla de verificación Auto-conversion y haz clic en Guardar configuración.

    Tu lugar de trabajo de conversiones ahora se convertirá automáticamente cuando conviertas tu esquema.

  4. Opcional: En el diálogo ¿Quieres convertir objetos de origen con Gemini?, haz clic en Convertir.

    Tus objetos convertidos no se modifican cuando habilitas la conversión automática. Puedes volver a convertir tu esquema más adelante.

Inhabilita la conversión automática

Para inhabilitar la conversión automática, haz lo siguiente:

  1. En la consola de Google Cloud, ve a Lugares de trabajo de conversión y selecciona tu lugar de trabajo.

    Ve a Lugares de trabajo de conversión

  2. Haz clic en pen_spark Gemini.

    Se abrirá el panel lateral de Gemini.

  3. Desmarca la casilla de verificación Conversión automática y haz clic en Guardar configuración.

    Tu lugar de trabajo de conversión ahora usará la conversión de código y esquema determinista cuando conviertas tu esquema.

  4. Opcional: En el cuadro de diálogo ¿Convertir objetos de origen?, haz clic en Convertir.

    Tus objetos convertidos no se modifican cuando inhabilitas la conversión automática. Puedes volver a convertir tu esquema más adelante si deseas revertir los resultados de las conversiones para usar reglas de conversión deterministas.

Usa el asistente de conversiones de Gemini

El asistente de conversiones es un conjunto de instrucciones específicas que puedes usar para comprender mejor la lógica de conversión de objetos, solicitar ideas sobre cómo optimizar el código y solucionar 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 código y esquemas.
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 código y esquemas.

Habilita el Asistente de conversiones

El Asistente de conversiones se habilita de forma predeterminada cuando habilitas Gemini para Google Cloud en tu proyecto. Si inhabilitaste el asistente de conversiones, puedes volver a habilitarlo en tu espacio de trabajo. Los pasos para habilitar el Asistente de conversiones son diferentes según si usas un espacio de trabajo de conversiones actualizado o no.

Espacios de trabajo actualizados

Para habilitar el Asistente de conversiones en los espacios de trabajo de conversiones actualizados, haz lo siguiente:

  1. En la consola de Google Cloud, ve a Lugares de trabajo de conversión y selecciona tu lugar de trabajo.

    Ve a Lugares de trabajo de conversión

  2. Haz clic en pen_spark Gemini.

    Se abrirá el panel lateral de Gemini.

  3. Selecciona la casilla de verificación Asistencia para conversiones y haz clic en Guardar configuración.

Espacios de trabajo que no se actualizaron

En los espacios de trabajo más antiguos que no se actualizaron para usar la conversión automática de Gemini, la asistencia para la conversión se habilita de forma predeterminada después de que habilitas Gemini para tu proyecto. No es necesario que realices ningún paso adicional.

Inhabilita el asistente de conversiones

Los pasos para habilitar el asistente de conversiones son diferentes según si usas un lugar de trabajo de conversión actualizado o no.

Espacios de trabajo actualizados

Para habilitar el asistente de conversiones en los espacios de trabajo de conversiones actualizados, haz lo siguiente:

  1. En la consola de Google Cloud, ve a Lugares de trabajo de conversión y selecciona tu lugar de trabajo.

    Ve a Lugares de trabajo de conversión

  2. Haz clic en pen_spark Gemini.

    Se abrirá el panel lateral de Gemini.

  3. Selecciona la casilla de verificación Asistencia para conversiones y haz clic en Guardar configuración.

Espacios de trabajo que no se actualizaron

En los espacios de trabajo más antiguos que no se actualizaron para usar la conversión automática de Gemini, la asistencia para la conversión se habilita de forma predeterminada después de que habilitas Gemini para tu proyecto.

Puedes inhabilitar el asistente de conversiones si inhabilitas Gemini para Google Cloud en tu proyecto.

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 indicación 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 Lugares 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 Lugares 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 Lugares 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 Lugares 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 realizar todas las ediciones de forma manual.

Habilita las sugerencias de conversiones de Gemini

Las sugerencias de conversiones se habilitan de forma predeterminada cuando habilitas Gemini para Google Cloud en tu proyecto. Si la inhabilitaste anteriormente, puedes volver a habilitarla en tu espacio de trabajo. Los pasos para habilitar las sugerencias de conversiones son diferentes según si usas un lugar de trabajo de conversiones actualizado o no.

Espacios de trabajo actualizados

Para habilitar el asistente de conversiones en los espacios de trabajo de conversiones actualizados, haz lo siguiente:

  1. En la consola de Google Cloud, ve a Lugares de trabajo de conversión y selecciona tu lugar de trabajo.

    Ve a Lugares de trabajo de conversión

  2. Haz clic en pen_spark Gemini.

    Se abrirá el panel lateral de Gemini.

  3. Selecciona la casilla de verificación Pattern matching y haz clic en Save settings.

Espacios de trabajo que no se actualizaron

En los espacios de trabajo más antiguos que no se actualizaron para usar la conversión automática de Gemini, las sugerencias de conversión se habilitan de forma predeterminada después de que habilitas Gemini para tu proyecto. Si anteriormente inhabilitaste las sugerencias de conversiones, haz lo siguiente para volver a habilitarlas:

  1. En la consola de Google Cloud, ve a Lugares de trabajo de conversión y selecciona tu lugar de trabajo.

    Ve a Lugares de trabajo de conversión

  2. 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 habilitadas para este espacio de trabajo de conversión.

Inhabilita las sugerencias de conversiones de Gemini

Los pasos para habilitar el asistente de conversiones son diferentes según si usas un lugar de trabajo de conversión actualizado o no.

Espacios de trabajo actualizados

Para habilitar las sugerencias de conversiones en los espacios de trabajo de conversiones actualizados, haz lo siguiente:

  1. En la consola de Google Cloud, ve a Lugares de trabajo de conversión y selecciona tu lugar de trabajo.

    Ve a Lugares de trabajo de conversión

  2. Haz clic en pen_spark Gemini.

    Se abrirá el panel lateral de Gemini.

  3. Desmarca la casilla de verificación Pattern matching y haz clic en Save settings.

Espacios de trabajo que no se actualizaron

Para inhabilitar las sugerencias de conversiones en los espacios de trabajo más antiguos que no se actualizaron para usar la conversión automática de Gemini, haz lo siguiente:

  1. En la consola de Google Cloud, ve a Lugares de trabajo de conversión y selecciona tu lugar de trabajo.

    Ve a Lugares de trabajo de conversión

  2. 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.

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 de Gemini, sigue estos pasos:

  1. En la consola de Google Cloud, ve a Lugares 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 conversión 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.

En la página Soluciona problemas con Gemini, se muestran 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 Corrige 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, accede nuevamente a las sugerencias de Gemini.

¿Qué sigue?