Traduce consultas con el traductor interactivo de SQL

En este documento, se describe cómo traducir una consulta de un dialecto de SQL diferente a una consulta en GoogleSQL mediante el traductor de SQL interactivo de BigQuery. El traductor interactivo de SQL puede ayudar a reducir el tiempo y el esfuerzo cuando migras cargas de trabajo a BigQuery. Este documento está dirigido a usuarios familiarizados con la consola de Google Cloud.

Si tu ubicación es compatible, puedes usar la función de reglas de traducción (Vista previa) para personalizar la forma en que el traductor interactivo de SQL traduce SQL.

Limitaciones

Debes acceder con una Cuenta de Google para usar el traductor interactivo de SQL. El traductor de SQL interactivo no admite el uso de identidades federadas.

Antes de comenzar

Si tu proyecto de Google Cloud CLI se creó antes del 15 de febrero de 2022, habilita la API de BigQuery Migration de la siguiente manera:

1. En la consola de Google Cloud, ve a la página API de BigQuery Migration.

   Ir a la API de BigQuery Migration

2. Haz clic en Habilitar.

Nota: Los proyectos creados después del 15 de febrero de 2022 tienen esta API habilitada automáticamente.

Permisos y roles

En esta sección se describen los permisos de Identity and Access Management (IAM) que necesitarás para usar el traductor interactivo de SQL y las funciones predefinidas de IAM que otorgan esos permisos. En la sección, también se describen los permisos necesarios para establecer parámetros de configuración de traducción adicionales.

Permisos para usar el traductor interactivo de SQL

Para obtener los permisos que necesitas para usar el traductor interactivo, pídele a tu administrador que te otorgue el rol de IAM de editor de MigrationWorkflow (roles/bigquerymigration.editor) en el recurso parent. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para usar el traductor interactivo. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para usar el traductor interactivo:

• bigquerymigration.workflows.create
• bigquerymigration.workflows.get

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

Permisos para establecer opciones de configuración de traducción adicionales

Puedes establecer configuraciones de traducción adicionales mediante los campos ID de configuración de traducción y Ubicación del origen de la configuración de traducción en la configuración de traducción. Para establecer esta configuración de traducción, necesitas los siguientes permisos:

• bigquerymigration.workflows.get
• bigquerymigration.workflows.list

El siguiente rol predefinido de IAM proporciona los permisos que necesitas para establecer opciones de configuración de traducción adicionales:

• roles/bigquerymigration.viewer

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

Dialectos de SQL compatibles

El traductor de SQL interactivo de BigQuery puede traducir los siguientes dialectos de SQL a GoogleSQL:

• SQL de Amazon Redshift
• Apache HiveQL y Beeline CLI
• SQL de IBM Netezza y NZPLSQL
• Teradata y Teradata Vantage:
  • SQL
  • Consulta básica de Teradata (BTEQ)
  • Teradata Parallel Transport (TPT)

Además, se admite la traducción de los siguientes dialectos de SQL en la vista previa:

• SQL de Apache Spark
• T-SQL de Azure Synapse
• Greenplum SQL
• IBM DB2 SQL
• SQL de MySQL
• SQL de Oracle, PL/SQL, Exadata
• PostgreSQL SQL
• Trino o PrestoSQL
• SQL de Snowflake
• SQL Server T-SQL
• SQLite
• SQL de Vertica

Ubicaciones

El traductor interactivo de SQL está disponible en las siguientes ubicaciones de procesamiento:

	Descripción de la región	Nombre de la región	Detalles
Asia-Pacífico
	Tokio	asia-northeast1
	Bombay	asia-south1
	Singapur	asia-southeast1
	Sídney	australia-southeast1
Europa
	UE multirregión	eu
	Varsovia	europe-central2
	Finlandia	europe-north1	CO2 bajo
	Madrid	europe-southwest1	CO2 bajo
	Bélgica	europe-west1	CO2 bajo
	Londres	europe-west2	CO2 bajo
	Fráncfort	europe-west3	CO2 bajo
	Países Bajos	europe-west4	CO2 bajo
	Zúrich	europe-west6	CO2 bajo
	París	europe-west9	CO2 bajo
	Turín	europe-west12
América
	Quebec	northamerica-northeast1	CO2 bajo
	São Paulo	southamerica-east1	CO2 bajo
	EE.UU. multirregión	us
	Iowa	us-central1	CO2 bajo
	Carolina del Sur	us-east1
	Virginia del Norte	us-east4
	Columbus, Ohio	us-east5
	Dallas	us-south1	CO2 bajo
	Oregón	us-west1	CO2 bajo
	Los Ángeles	us-west2
	Salt Lake City	us-west3

La función regla de traducción está disponible en las siguientes ubicaciones de procesamiento:

• us (EE.UU. multirregión)
• eu (UE multirregión)
• us-central1 (Iowa)
• europe-west4 (Países Bajos)

Traduce una consulta a GoogleSQL

Sigue estos pasos para traducir una consulta a GoogleSQL:

1. En la consola de Google Cloud, ve a la página de BigQuery.

   Ir a BigQuery

2. En el panel Editor, haz clic en Más y, luego, selecciona Configuración de traducción.

3. En Dialecto de origen, selecciona el dialecto de SQL que deseas traducir.

4. Opcional. En Ubicación de procesamiento, selecciona la ubicación en la que deseas que se ejecute el trabajo de traducción. Por ejemplo, si estás en Europa y no quieres que tus datos pasen ningún límite de ubicación, selecciona la región eu.

5. Haz clic en Guardar.

6. En el panel Editor, haz clic en Más y, luego, selecciona Habilitar la traducción de SQL.

   El panel Editor se divide en dos paneles.

7. En el panel izquierdo, ingresa la consulta que deseas traducir.

8. Haz clic en Traducir.

   BigQuery traduce tu consulta en GoogleSQL y la muestra en el panel derecho. Por ejemplo, en la siguiente captura de pantalla se muestra SQL de Teradata traducido:

   

9. Opcional: Para ejecutar la consulta de GoogleSQL traducida, haz clic en Ejecutar.

10. Para volver al editor de SQL, haz clic en Más y, luego, selecciona Inhabilitar la traducción de SQL (opcional).

    El panel del Editor regresa a un solo panel.

Configura el traductor de SQL interactivo

Puedes configurar el traductor de SQL interactivo para ajustar la forma en que este traduce tu SQL de origen. Para ello, proporciona tus propias reglas para usar con Gemini en un archivo de configuración de YAML o proporciona un archivo de configuración de YAML que contenga metadatos de objetos SQL o información de asignación de objetos.

Crea una regla de traducción

Nota: Con las traducciones de SQL mejoradas con Gemini, puedes personalizar tus secuencias de comandos con el modelo de Gemini. Las traducciones de SQL mejoradas con Gemini pueden usar Gemini de forma limitada y sin cargo, lo que debería ser suficiente para la mayoría de los proyectos de migración. Para solicitar un aumento de este límite o obtener asistencia y enviar comentarios sobre esta función preliminar, comunícate con [e-mail].

Puedes personalizar la forma en que el traductor interactivo de SQL traduce SQL creando reglas de traducción. El traductor de SQL interactivo ajusta sus traducciones según las reglas de traducción de SQL mejoradas con Gemini que le asignes, lo que te permite personalizar los resultados de la traducción según tus necesidades de migración. Esta función solo se admite en ciertas ubicaciones.

Para crear una regla de traducción de SQL mejorada con Gemini, haz una de las siguientes acciones:

Console

Para crear una regla de traducción de SQL mejorada con Gemini, haz lo siguiente:

1. Después de ejecutar una traducción interactiva, haz clic en Asistente y, luego, en Personalizar esta traducción.

   

2. Usa una o ambas de las siguientes indicaciones para crear una regla de traducción:

   • En el mensaje Buscar y reemplazar un patrón, especifica un patrón de SQL que desees reemplazar en el campo Reemplazar y un patrón SQL para reemplazar en el campo Con.

     Un patrón de SQL puede contener cualquier cantidad de instrucciones, cláusulas o funciones en una secuencia de comandos de SQL. Cuando creas una regla con esta instrucción, la traducción de SQL mejorada con Gemini identifica cualquier instancia de ese patrón de SQL en el resultado de la traducción y lo reemplaza de forma dinámica por otro patrón de SQL. Por ejemplo, puedes usar esta instrucción para crear una regla que reemplace todas las ocurrencias de months_between (X,Y) por date_diff(X,Y,MONTH).

   • En el campo Describe un cambio en el resultado, escribe un cambio en el resultado de la traducción de SQL en lenguaje natural.

     Cuando creas una regla con esta instrucción, la traducción de SQL mejorada con Gemini identifica la solicitud y realiza el cambio especificado en el resultado de la traducción.

3. Haz clic en Vista previa.

4. En el diálogo Vista previa de cambios sugeridos, revisa los cambios que realizó la traducción de SQL mejorada por Gemini en el resultado de la traducción según tu regla.

5. Opcional: Para agregar esta regla a fin de usarla con traducciones futuras, selecciona la casilla de verificación Agregar regla….

   Las reglas se guardan en el archivo YAML de configuración predeterminado o __default.ai_config.yaml. Este archivo YAML de configuración se guarda en la carpeta de Cloud Storage como se especifica en el campo Ubicación del origen de la configuración de traducción en la configuración de traducción. Un archivo YAML de configuración está sujeto a limitaciones de tamaño de archivo de configuración.

6. Para aplicar los cambios sugeridos al resultado de la traducción, haz clic en Aplicar.

YAML

Para crear una regla de traducción de SQL mejorada con Gemini, puedes crear un archivo YAML de configuración basado en Gemini y subirlo a Cloud Storage. Para obtener más información, consulta Cómo crear un archivo YAML de configuración basado en Gemini y Cómo aplicar un archivo YAML de configuración basado en Gemini a tu próxima traducción.

Aplica un archivo YAML de configuración basado en Gemini a tu próxima traducción

Para aplicar un archivo YAML de configuración para los resultados de IA, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página de BigQuery.

   Ir a BigQuery

2. En el editor de consultas, haz clic en Más > Configuración de traducción.

3. En el campo Ubicación del origen de la configuración de traducción, especifica la ruta de acceso al archivo YAML basado en Gemini almacenado en una carpeta de Cloud Storage.

4. Haz clic en Guardar. Después de ejecutar una traducción interactiva, aparece un punto rojo en el botón Assist para indicar que hay una sugerencia de Gemini disponible.

5. Haz clic en Ayuda y, luego, en Ver sugerencias para ver los cambios sugeridos en el resultado de la traducción que realiza el servicio de traducción de SQL mejorado con Gemini.

   

6. En el diálogo Vista previa de cambios sugeridos, revisa los cambios que realizó la traducción de SQL mejorada por Gemini en el resultado de la traducción según tu regla.

7. Para aplicar los cambios sugeridos al resultado de la traducción, haz clic en Aplicar.

Explica una traducción

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Nota: Con las traducciones de SQL mejoradas con Gemini, puedes generar una explicación de texto para tus secuencias de comandos con el modelo de Gemini. Las traducciones de SQL mejoradas con Gemini tienen un uso limitado de Gemini sin cargo. Este uso es suficiente para la mayoría de los proyectos de migración. Para solicitar un aumento de este límite, o para obtener asistencia y enviar comentarios sobre esta función de vista previa, comunícate con [e-mail].

Después de ejecutar una traducción interactiva, puedes solicitar una explicación de texto generada por Gemini. El texto generado incluye un resumen de la consulta en SQL traducida. Gemini también identifica diferencias y discrepancias de traducción entre la consulta en SQL de origen y la consulta de GoogleSQL traducida.

Para obtener la explicación de la traducción de SQL generada por Gemini, haz lo siguiente:

1. Para crear una explicación de traducción de SQL generada por Gemini, haz clic en Asistente y, luego, en Explica esta traducción.

   

Traduce con un ID de configuración de traducción por lotes

Puedes ejecutar una consulta interactiva con las mismas configuraciones de traducción que un trabajo de traducción por lotes si proporcionas un ID de configuración de traducción por lotes.

1. En el editor de consultas, haz clic en Más > Configuración de traducción.

2. En el campo ID de configuración de traducción, proporciona un ID de configuración de traducción por lotes para aplicar la misma configuración de traducción a partir de un trabajo de migración por lotes de BigQuery completado.

   Para encontrar el ID de configuración de la traducción por lotes de un trabajo, selecciona un trabajo de traducción por lotes de la página Traducción de SQL y haz clic en la pestaña Configuración de traducción. El ID de configuración de traducción por lotes se muestra como Nombre del recurso.

3. Haz clic en Guardar.

Cómo traducir con parámetros de configuración adicionales

Puedes ejecutar una consulta interactiva con configuraciones de traducción adicionales si especificas archivos YAML de configuración almacenados en una carpeta de Cloud Storage. Las configuraciones de traducción pueden incluir metadatos de objeto SQL o información de asignación de objetos de la base de datos de origen que puedan mejorar la calidad de la traducción. Por ejemplo, incluye información o esquemas de DDL de la base de datos de origen para mejorar la calidad de la traducción interactiva de SQL.

Para especificar configuraciones de traducción, proporciona una ubicación a los archivos de origen de configuración de traducción y haz lo siguiente:

1. En el editor de consultas, haz clic en Más > Configuración de traducción.

2. En la sección Ubicación del origen de la configuración de traducción, especifica la ruta a un archivo de configuración de traducción almacenado en una carpeta de Cloud Storage.

   El traductor interactivo de SQL de BigQuery admite archivos de configuración que contienen metadatos de traducción y asignación de nombres de objetos. Para obtener información sobre cómo subir archivos a Cloud Storage, consulta Carga objetos desde un sistema de archivos.

3. Haz clic en Guardar.

Limitaciones del tamaño del archivo de configuración

Cuando usas un archivo de configuración de traducción con el traductor interactivo de SQL de BigQuery, el tamaño del archivo de metadatos comprimido o del archivo de configuración YAML debe ser inferior a 50 MB. Si el tamaño del archivo supera los 50 MB, el traductor interactivo omite ese archivo de configuración durante la traducción y produce un mensaje de error similar al siguiente:

CONFIG ERROR: Skip reading file "gs://metadata-file.zip". File size (150,000,000 bytes) exceeds limit (50 MB).

Un método que permite reducir el tamaño del archivo de metadatos es usar las marcas --database o --schema para extraer solo los metadatos de las bases de datos o los esquemas que son relevantes para las consultas de entrada de traducción. Para obtener más información sobre el uso de estas marcas cuando generas archivos de metadatos, consulta Marcas globales.

Soluciona problemas de errores de traducción

Los siguientes son errores comunes que se encuentran cuando se usa el traductor interactivo de SQL.

Problemas de traducción de RelationNotFound o AttributeNotFound

Para garantizar la traducción más precisa, ingresa las declaraciones del lenguaje de definición de datos (DDL) de todas las tablas usadas en una consulta antes de la consulta. Por ejemplo, si deseas traducir la consulta select table1.field1, table2.field1 from table1, table2 where table1.id = table2.id; de Amazon Redshift, debes ingresar las siguientes instrucciones de SQL en el traductor interactivo de SQL:

create table schema1.table1 (id int, field1 int, field2 varchar(16));
create table schema1.table2 (id int, field1 varchar(30), field2 date);

select table1.field1, table2.field1
from table1, table2
where table1.id = table2.id;

Precios

No se aplican cargos por usar el traductor interactivo de SQL. Sin embargo, se aplican las tarifas normales al almacenamiento que se usa para almacenar archivos de entrada y salida. Para obtener más información, consulta los precios de almacenamiento.

¿Qué sigue?

Obtén más información sobre los siguientes pasos en la migración de almacenes de datos:

• Descripción general de la migración
• Evaluación de la migración
• Descripción general de transferencia de datos y esquemas
• Traducción de SQL por lotes
• Canalizaciones de datos
• Seguridad y administración de los datos
• Herramienta de validación de datos