Traduce consultas en SQL con la API de Translation

En este documento, se describe cómo usar la API de Translation en BigQuery para traducir secuencias de comandos escritas en otros dialectos de SQL a consultas de GoogleSQL. La API de Translation puede simplificar el proceso de migración de cargas de trabajo a BigQuery.

Antes de comenzar

Antes de enviar un trabajo de traducción, completa los siguientes pasos:

Asegúrate de tener todos los permisos necesarios.
Habilita la API de BigQuery Migration.
Recopila los archivos de origen que contienen las secuencias de comandos y las consultas de SQL que se deben traducir.
Sube los archivos de origen a Cloud Storage.

Permisos necesarios

Para obtener los permisos que necesitas para crear trabajos de traducción con la API de traducción, pídele a tu administrador que te otorgue el rol de IAM 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.

Este rol predefinido contiene los permisos necesarios para crear trabajos de traducción con la API de traducción. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear trabajos de traducción con la API de traducción:

bigquerymigration.workflows.create
bigquerymigration.workflows.get

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

Habilita la API de BigQuery Migration

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:

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

Ir a la API de BigQuery Migration
Haz clic en Habilitar.

Sube archivos de entrada a Cloud Storage

Si deseas usar la consola de Google Cloud o la API de BigQuery Migration para realizar un trabajo de traducción, debes subir los archivos de origen que contienen las consultas y secuencias de comandos que deseas traducir a Cloud Storage. También puedes subir cualquier archivo de metadatos o archivos YAML de configuración al mismo bucket de Cloud Storage que contiene los archivos de origen. Para obtener más información sobre la creación de buckets y la carga de archivos a Cloud Storage, consulta Crea buckets y Sube objetos desde un sistema de archivos.

Tipos de tareas compatibles

La API de traducción puede traducir los siguientes dialectos de SQL a GoogleSQL:

SQL de Amazon Redshift: Redshift2BigQuery_Translation
Apache HiveQL y Beeline CLI: HiveQL2BigQuery_Translation
SQL de Apache Spark: SparkSQL2BigQuery_Translation
T-SQL de Azure Synapse: AzureSynapse2BigQuery_Translation
Greenplum SQL: Greenplum2BigQuery_Translation
SQL de IBM Db2: Db22BigQuery_Translation
SQL de IBM Netezza y NZPLSQL: Netezza2BigQuery_Translation
SQL de MySQL: MySQL2BigQuery_Translation
SQL de Oracle, PL/SQL, Exadata: Oracle2BigQuery_Translation
SQL de PostgreSQL: Postgresql2BigQuery_Translation
SQL de Presto o Trino: Presto2BigQuery_Translation
SQL de Snowflake: Snowflake2BigQuery_Translation
SQLite: SQLite2BigQuery_Translation
T-SQL de SQL Server: SQLServer2BigQuery_Translation
Teradata y Teradata Vantage: Teradata2BigQuery_Translation
SQL de Vertica: Vertica2BigQuery_Translation

Ubicaciones

La API de Translation 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`	CO₂ bajo
	Madrid	`europe-southwest1`	CO₂ bajo
	Bélgica	`europe-west1`	CO₂ bajo
	Londres	`europe-west2`	CO₂ bajo
	Fráncfort	`europe-west3`	CO₂ bajo
	Países Bajos	`europe-west4`	CO₂ bajo
	Zúrich	`europe-west6`	CO₂ bajo
	París	`europe-west9`	CO₂ bajo
	Turín	`europe-west12`
América
	São Paulo	`southamerica-east1`	CO₂ bajo
	EE.UU. multirregión	`us`
	Iowa	`us-central1`	CO₂ bajo
	Carolina del Sur	`us-east1`
	Virginia del Norte	`us-east4`
	Columbus, Ohio	`us-east5`
	Dallas	`us-south1`	CO₂ bajo
	Oregón	`us-west1`	CO₂ bajo
	Los Ángeles	`us-west2`
	Salt Lake City	`us-west3`

Envía un trabajo de traducción

Para enviar un trabajo de traducción con la API de Translation, usa el método projects.locations.workflows.create y proporciona una instancia del recurso MigrationWorkflow con un tipo de tarea compatible.

Ejemplo: Crea una traducción por lotes

Con el siguiente comando de curl, se crea un trabajo de traducción por lotes en el que los archivos de entrada y salida se almacenan en Cloud Storage. El campo source_target_mapping contiene una lista que asigna las entradas literal de origen a una ruta relativa opcional para el resultado de destino.

curl -d "{
  \"tasks\": {
      string: {
        \"type\": \"TYPE\",
        \"translation_details\": {
            \"target_base_uri\": \"TARGET_BASE\",
            \"source_target_mapping\": {
              \"source_spec\": {
                  \"base_uri\": \"BASE\"
              }
            },
        }
      }
  }
  }" \
  -H "Content-Type:application/json" \
  -H "Authorization: Bearer TOKEN" -X POST https://bigquerymigration.googleapis.com/v2alpha/projects/PROJECT_ID/locations/LOCATION/workflows

Reemplaza lo siguiente:

TYPE: el tipo de tarea de la traducción, que determina el dialecto de origen y objetivo.
TARGET_BASE: Es el URI base para todos los resultados de traducción.
BASE: el URI base para todos los archivos leídos como fuentes de traducción.
TOKEN: Es el token para la autenticación. Para generar un token, usa el comando gcloud auth print-access-token o la zona de pruebas de OAuth 2.0 (usa el permiso https://www.googleapis.com/auth/cloud-platform).
PROJECT_ID: es el proyecto que procesará la traducción.
LOCATION: la ubicación en la que se procesa el trabajo.

El comando anterior muestra una respuesta que incluye un ID de flujo de trabajo escrito en el formato projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_ID.

Ejemplo: Crea un trabajo de traducción interactivo con entradas y salidas literales de string

Con el siguiente comando de curl, se crea un trabajo de traducción con entradas y salidas literales de cadena. El campo source_target_mapping contiene una lista que asigna los directorios de origen a una ruta de acceso relativa opcional para el resultado de destino.

curl -d "{
  \"tasks\": {
      string: {
        \"type\": \"TYPE\",
        \"translation_details\": {
        \"source_target_mapping\": {
            \"source_spec\": {
              \"literal\": {
              \"relative_path\": \"PATH\",
              \"literal_string\": \"STRING\"
              }
            }
        },
        \"target_return_literals\": \"TARGETS\",
        }
      }
  }
  }" \
  -H "Content-Type:application/json" \
  -H "Authorization: Bearer TOKEN" -X POST https://bigquerymigration.googleapis.com/v2alpha/projects/PROJECT_ID/locations/LOCATION/workflows

Reemplaza lo siguiente:

TYPE: el tipo de tarea de la traducción, que determina el dialecto de origen y objetivo.
PATH: el identificador de la entrada literal, similar a un nombre de archivo o una ruta de acceso.
STRING: Es la string de datos de entrada literales que se traducirán (por ejemplo, SQL).
TARGETS: Son los objetivos esperados que el usuario desea que se muestren directamente en la respuesta en el formato literal. Deben estar en el formato del URI de destino (por ejemplo, GENERATED_DIR + target_spec.relative_path + source_spec.literal.relative_path). Todo lo que no esté en esta lista no se mostrará en la respuesta. El directorio generado, GENERATED_DIR para las traducciones de SQL generales es sql/.
TOKEN: Es el token para la autenticación. Para generar un token, usa el comando gcloud auth print-access-token o la zona de pruebas de OAuth 2.0 (usa el permiso https://www.googleapis.com/auth/cloud-platform).
PROJECT_ID: es el proyecto que procesará la traducción.
LOCATION: la ubicación en la que se procesa el trabajo.

El comando anterior muestra una respuesta que incluye un ID de flujo de trabajo escrito en el formato projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_ID.

Explora el resultado de la traducción

Después de ejecutar el trabajo de traducción, especifica el ID del flujo de trabajo del trabajo de traducción para recuperar los resultados mediante el siguiente comando:

curl \
-H "Content-Type:application/json" \
-H "Authorization:Bearer TOKEN" -X GET https://bigquerymigration.googleapis.com/v2alpha/projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_ID

Reemplaza lo siguiente:

TOKEN: Es el token para la autenticación. Para generar un token, usa el comando gcloud auth print-access-token o la zona de pruebas de OAuth 2.0 (usa el permiso https://www.googleapis.com/auth/cloud-platform).
PROJECT_ID: es el proyecto que procesará la traducción.
LOCATION: la ubicación en la que se procesa el trabajo.
WORKFLOW_ID: el ID que se genera cuando creas un flujo de trabajo de traducción.