La
función AI.TRANSLATE
te permite traducir texto entre idiomas directamente en BigQuery. Por ejemplo, puedes localizar catálogos de productos, traducir los comentarios de los clientes para los equipos de asistencia global o estandarizar las respuestas de encuestas multilingües sin crear canalizaciones de datos independientes. La función conecta BigQuery
con la API de Cloud Translation usando tus credenciales de usuario final, por lo que no necesitas
crear una conexión ni un modelo remoto.
En este instructivo, crearás una tabla de muestra de comentarios de clientes multilingües, traducirás texto al inglés con la detección automática de idioma, inspeccionarás los metadatos de traducción y traducirás opiniones sobre películas al español con el modelo de LLM de Translation.
Objetivos
- Crear un conjunto de datos y una tabla de muestra de texto multilingüe
- Traduce texto multilingüe al inglés con la detección automática de idioma.
- Devuelve los metadatos de traducción y los códigos de idioma de origen detectados.
- Traduce texto con matices usando el modelo de LLM de Translation.
Costos
En este documento, usarás los siguientes componentes facturables de Google Cloud:
- BigQuery. You incur costs for the data that you process in BigQuery.
- Cloud Translation. You incur costs for calls to the Cloud Translation API.
Para generar una estimación de costos en función del uso previsto,
usa la calculadora de precios.
Para obtener más información, consulta los precios de BigQuery y los precios de Translation.
Antes de comenzar
Console
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the BigQuery and Translation APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
Asegúrate de tener los siguientes roles en el proyecto: Editor de datos de BigQuery, Usuario de trabajos de BigQuery, Usuario de la API de Cloud Translation.
Verifica los roles
-
En la consola de Google Cloud , dirígete a la página IAM.
Ir a IAM - Selecciona el proyecto.
-
En la columna Principal, busca todas las filas que te identifiquen a ti o a un grupo en el que se te incluya. Para saber en qué grupos estás incluido, comunícate con tu administrador.
- Para todas las filas en las que se te especifique o se te incluya, verifica la columna Rol para ver si la lista de roles incluye los roles necesarios.
Otorga los roles
-
En la consola de Google Cloud , dirígete a la página IAM.
Ir a IAM - Selecciona el proyecto.
- Haz clic en Otorgar acceso.
-
En el campo Principales nuevas, ingresa tu identificador de usuario. Este suele ser el identificador de un usuario que pertenece a un grupo de identidades de personal. Para obtener más información, consulta Representa a los usuarios del grupo de personal en políticas de IAM o comunícate con el administrador.
- Haz clic en Selecciona un rol y, luego, busca el rol.
- Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega uno más.
- Haz clic en Guardar.
-
gcloud
-
Instala Google Cloud CLI.
-
Configura gcloud CLI para usar tu identidad federada.
Para obtener más información, consulta Accede a gcloud CLI con tu identidad federada.
-
Para inicializar gcloud CLI, ejecuta el siguiente comando:
gcloud init -
Crea o selecciona un proyecto de Google Cloud .
Roles necesarios para seleccionar o crear un proyecto
- Seleccionar un proyecto: Seleccionar un proyecto no requiere un rol de IAM específico; puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
-
Crea un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos
(
roles/resourcemanager.projectCreator), que contiene el permisoresourcemanager.projects.create. Obtén más información para otorgar roles.
-
Crea un proyecto de Google Cloud :
gcloud projects create PROJECT_ID
Reemplaza
PROJECT_IDpor un nombre para el proyecto de Google Cloud que estás creando. -
Selecciona el proyecto de Google Cloud que creaste:
gcloud config set project PROJECT_ID
Reemplaza
PROJECT_IDpor el nombre de tu proyecto de Google Cloud .
-
Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .
Habilita las APIs de BigQuery y Translation, si aún no están habilitadas:
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el permiso
serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.gcloud services enable bigquery.googleapis.com
translate.googleapis.com -
Otorga roles a tu cuenta de usuario. Ejecuta el siguiente comando una vez para cada uno de los siguientes roles de IAM:
roles/bigquery.dataEditor, roles/bigquery.jobUser, roles/cloudtranslate.usergcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Reemplaza lo siguiente:
PROJECT_ID: ID del proyectoUSER_IDENTIFIER: Es el identificador de tu cuenta de usuario . Para ver ejemplos, consulta Representa a los usuarios del grupo de personal en las políticas de IAM.ROLE: Es el rol de IAM que otorgas a tu cuenta de usuario.
Crea un conjunto de datos
Para crear un conjunto de datos de BigQuery, selecciona una de las siguientes opciones:
Console
En la consola de Google Cloud , ve a la página BigQuery.
En el panel de la izquierda, haz clic en Explorar:

Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.
En Explorador, expande tu proyecto y, luego, haz clic en Conjuntos de datos.
En la página Conjuntos de datos, haz clic en Crear conjunto de datos.
En el panel Crear conjunto de datos, haz lo siguiente:
En ID del conjunto de datos, ingresa
bqml_tutorial.En Ubicación de los datos, selecciona US.
Deja el resto de la configuración predeterminada como está.
Haz clic en Crear conjunto de datos.
bq
Para crear un conjunto de datos nuevo, usa el
comando bq mk --dataset.
Crea un conjunto de datos llamado
bqml_tutorialcon la ubicación de los datos establecida enUS:bq mk --dataset \ --location=US \ --description "BigQuery ML tutorial dataset." \ bqml_tutorial
Confirma que se haya creado el conjunto de datos:
bq ls
API
Llama al método datasets.insert
con un recurso de conjunto de datos definido:
{ "datasetReference": { "datasetId": "bqml_tutorial" } }
Crea una tabla de muestra
Usa la
declaración CREATE TABLE
para crear una tabla de comentarios de clientes multilingües en el conjunto de datos
bqml_tutorial:
En la consola de Google Cloud , ve a la página BigQuery.
En el editor de consultas, ejecuta la siguiente declaración:
CREATE OR REPLACE TABLE `bqml_tutorial.customer_feedback` AS ( SELECT * FROM UNNEST( [ STRUCT<feedback_id INT64, feedback_text STRING>( 1, 'El servicio de entrega fue rápido y confiable.'), (2, 'Je suis très satisfait de la qualité de ce produit.'), (3, 'Die Benutzeroberfläche der App ist sehr übersichtlich.'), (4, 'O suporte ao cliente resolveu meu problema com rapidez.') ]) );
Traduce texto multilingüe
Usa la
función AI.TRANSLATE
para traducir los comentarios de los clientes al inglés (en). Cuando omites el
argumento source_language, la API de Cloud Translation detecta automáticamente
el idioma de origen de cada fila y traduce el texto con el modelo predeterminado de
traducción automática neuronal (NMT):
En la consola de Google Cloud , ve a la página BigQuery.
En el editor de consultas, ejecuta la siguiente sentencia para traducir los comentarios al inglés:
SELECT feedback_id, feedback_text, AI.TRANSLATE(feedback_text, 'en') AS translated_text FROM `bqml_tutorial.customer_feedback`;
Para obtener una lista de los códigos de idioma de destino válidos, consulta los idiomas admitidos.
El resultado es similar a lo siguiente:
+-------------+-----------------------------+-----------------------------+ | feedback_id | feedback_text | translated_text | +-------------+-----------------------------+-----------------------------+ | 1 | El servicio de entrega fue | The delivery service was | | | rápido y confiable. | fast and reliable. | +-------------+-----------------------------+-----------------------------+ | 2 | Je suis très satisfait de | I am very satisfied with | | | la qualité de ce produit. | the quality of this | | | | product. | +-------------+-----------------------------+-----------------------------+ | 3 | Die Benutzeroberfläche der | The app's user interface is | | | App ist sehr übersichtlich. | very clear. | +-------------+-----------------------------+-----------------------------+ | 4 | O suporte ao cliente | Customer support resolved | | | resolveu meu problema com | my issue quickly. | | | rapidez. | | +-------------+-----------------------------+-----------------------------+
Devuelve los detalles de la traducción y los idiomas detectados
Cuando procesas texto de varias regiones, es posible que quieras registrar el
idioma de origen detectado junto con cada traducción o verificar si hay errores por fila.
Establece return_details => TRUE en la
función AI.TRANSLATE
para que devuelva un valor STRUCT que incluya el texto traducido, el estado de ejecución
y los metadatos de la respuesta de la API:
En la consola de Google Cloud , ve a la página BigQuery.
En el editor de consultas, ejecuta la siguiente sentencia para extraer el código de idioma detectado, el texto traducido y el estado de cada fila:
WITH translations AS ( SELECT feedback_id, AI.TRANSLATE( feedback_text, 'en', return_details => TRUE) AS translation FROM `bqml_tutorial.customer_feedback` ) SELECT feedback_id, STRING(translation.details.detected_language_code) AS detected_language, translation.result AS translated_text, translation.status FROM translations;
El resultado es similar a lo siguiente:
+-------------+-------------------+-----------------------------+--------+ | feedback_id | detected_language | translated_text | status | +-------------+-------------------+-----------------------------+--------+ | 1 | es | The delivery service was | OK | | | | fast and reliable. | | +-------------+-------------------+-----------------------------+--------+ | 2 | fr | I am very satisfied with | OK | | | | the quality of this | | | | | product. | | +-------------+-------------------+-----------------------------+--------+ | 3 | de | The app's user interface is | OK | | | | very clear. | | +-------------+-------------------+-----------------------------+--------+ | 4 | pt | Customer support resolved | OK | | | | my issue quickly. | | +-------------+-------------------+-----------------------------+--------+
Cuando
return_detailsse establece enTRUE, elSTRUCTque se devuelve contiene los siguientes campos:result: un valorSTRINGque contiene el texto traducido oNULLsi se produce un error.status: un valorSTRINGque contieneOKcuando la operación se realiza correctamente o un mensaje de error si se produce un error.details: un valorJSONque contiene la respuesta de la API de Cloud Translation para la fila, incluidodetected_language_codecuando el idioma de origen se detecta automáticamente, o detalles del error si se produce un error.
Traduce texto con el LLM de Translation
Para el texto que contiene lenguaje informal, jerga o sentimientos complejos, como
opiniones de clientes o películas, configura model => 'translation-llm' en la
función AI.TRANSLATE
para usar el modelo de LLM de Translation en lugar del
modelo de NMT predeterminado. Cuando conoces el idioma de la columna de entrada, también puedes
especificar el argumento source_language:
En la consola de Google Cloud , ve a la página BigQuery.
En el editor de consultas, ejecuta la siguiente sentencia para traducir cinco opiniones de películas en inglés de un conjunto de datos público al español (
es):SELECT review, AI.TRANSLATE( review, 'es', source_language => 'en', model => 'translation-llm') AS translated_review FROM `bigquery-public-data.imdb.reviews` LIMIT 5;
El resultado es similar a lo siguiente:
+------------------------------------+------------------------------------+ | review | translated_review | +------------------------------------+------------------------------------+ | Once again Mr. Costner has dragged | Una vez más, el Sr. Costner ha | | out a movie for far longer than... | alargado una película mucho más... | +------------------------------------+------------------------------------+ | This movie is amazing because the | Esta película es increíble porque | | fact that real people portray... | las personas reales se... | +------------------------------------+------------------------------------+ | ... | ... | +------------------------------------+------------------------------------+
Realiza una limpieza
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos usados en este instructivo, borra el proyecto que contiene los recursos o conserva el proyecto y borra los recursos individuales.
Borra el proyecto
Borra un proyecto de Google Cloud :
gcloud projects delete PROJECT_ID
Borra los recursos individuales
Si quieres volver a usar el proyecto, borra el conjunto de datos que creaste para este instructivo:
Console
En la consola de Google Cloud , ve a la página BigQuery.
Borra el conjunto de datos
bqml_tutorialSi borras el conjunto de datos, también se borrará la tablacustomer_feedback:En el panel Explorador, expande tu proyecto y, luego, haz clic en Conjuntos de datos.
En la lista Conjuntos de datos, haz clic en el conjunto de datos
bqml_tutorial.En el panel de detalles, haz clic en Borrar.
En el cuadro de diálogo Borrar conjunto de datos, haz clic en Borrar.
gcloud
- Borra el conjunto de datos
bqml_tutorialy la tablacustomer_feedback:
bq rm --dataset --recursive bqml_tutorial
¿Qué sigue?
- Obtén más información sobre la
función
AI.TRANSLATE. - Obtén más información sobre los modelos de LLM de Translation y traducción automática neuronal.
- Compara las opciones de análisis de texto en Elige una función de procesamiento de lenguaje natural.
- Obtén más información sobre la IA generativa en BigQuery.
- Consulta las sentencias de SQL y las funciones admitidas en Recorridos del usuario final de extremo a extremo para modelos de IA generativa.