Crear canalizaciones

En este documento, se describe cómo crear canalizaciones en BigQuery. Las canalizaciones funcionan con Dataform.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. 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 the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the BigQuery, Dataform, and Vertex AI APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  5. 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 the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the BigQuery, Dataform, and Vertex AI APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    8.

Roles requeridos para las canalizaciones

Para obtener los permisos que necesitas para crear canalizaciones, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

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

Roles requeridos para las opciones de notebooks

Para obtener los permisos que necesitas para seleccionar una plantilla de entorno de ejecución en las opciones del notebook, pídele a tu administrador que te otorgue el rol de IAM de Usuario del entorno de ejecución del notebook (roles/aiplatform.notebookRuntimeUser) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Si no tienes este rol, puedes seleccionar la especificación predeterminada del tiempo de ejecución del notebook.

Configura la región predeterminada para los elementos de código

Si es la primera vez que creas un recurso de código, debes configurar la región predeterminada para los recursos de código. No puedes cambiar la región de un recurso de código después de crearlo.

Todos los recursos de código en BigQuery Studio usan la misma región predeterminada. Para establecer la región predeterminada de los recursos de código, sigue estos pasos:

  1. Ve a la página de BigQuery.

    Ir a BigQuery

  2. En el panel Explorador, busca el proyecto en el que habilitaste los elementos de código.

  3. Haz clic en Ver acciones junto al proyecto y, luego, en Cambiar mi región de código predeterminada.

  4. En Región, selecciona la región que deseas usar para los recursos de código.

  5. Haz clic en Seleccionar.

Para obtener una lista de las regiones admitidas, consulta Ubicaciones de BigQuery Studio.

Crea una canalización

También puedes usar la página Pipelines & Connections de BigQuery en la consola de Google Cloud para crear una canalización de Dataform que use un flujo de trabajo optimizado y específico de BigQuery. Esta función está en vista previa.

Para crear una canalización, sigue estos pasos:

  1. Ve a la página de BigQuery.

    Ir a BigQuery

  2. En la barra de pestañas del panel del editor, haz clic en la flecha junto al signo + y, luego, haz clic en Canalización.

  3. Opcional: Para cambiar el nombre de la canalización, haz clic en su nombre y, luego, escribe uno nuevo.

  4. Haz clic en Comenzar y, luego, ve a la pestaña Configuración.

  5. En la sección Autenticación, elige autorizar la canalización con las credenciales de usuario de tu Cuenta de Google o una cuenta de servicio.

    • Para usar las credenciales de usuario de tu Cuenta de Google (versión preliminar), selecciona Ejecutar con mis credenciales de usuario.

    • Para usar una cuenta de servicio, selecciona Ejecutar con la cuenta de servicio seleccionada y, luego, selecciona una cuenta de servicio. Si necesitas crear una cuenta de servicio, haz clic en Cuenta de servicio nueva.

  6. En la sección Ubicación de procesamiento, selecciona una ubicación de procesamiento para la canalización.

    • Para habilitar la selección automática de una ubicación, selecciona Selección automática de ubicación. Esta opción selecciona una ubicación según los conjuntos de datos a los que se hace referencia en la solicitud. El proceso de selección es el siguiente:

      • Si tu consulta hace referencia a conjuntos de datos de la misma ubicación, BigQuery usa esa ubicación.
      • Si tu consulta hace referencia a conjuntos de datos de dos o más ubicaciones diferentes, se producirá un error. Para obtener detalles sobre esta limitación, consulta Replicación de conjuntos de datos entre regiones.
      • Si tu consulta no hace referencia a ningún conjunto de datos, BigQuery usa de forma predeterminada la multirregión US.

    • Para elegir una región específica, selecciona Región y, luego, elige una región en el menú Región. Como alternativa, puedes usar la variable del sistema @@location en tu consulta. Para obtener más información, consulta Cómo especificar ubicaciones.

    • Para elegir una multirregión, selecciona Multirregión y, luego, elige una multirregión en el menú Multirregión.

    La ubicación de procesamiento de la canalización no tiene que coincidir con la ubicación de almacenamiento predeterminada para los recursos de código.

Opciones de SQLX

Para configurar los parámetros de SQLX para tu canalización, haz lo siguiente en la sección Opciones de SQLX:

  1. En el campo Proyecto predeterminado, ingresa el nombre de un proyecto deGoogle Cloud existente. Este valor se usa para defaultProject en el archivo workflow_settings.yaml y para defaultDatabase en el archivo dataform.json. Las tareas de canalización usan el proyecto predeterminado durante su ejecución.

  2. Opcional: En el campo Conjunto de datos predeterminado, busca y selecciona un conjunto de datos existente. La lista de conjuntos de datos disponibles se filtra según el proyecto y la ubicación de procesamiento seleccionados. Este valor se usa para defaultDataset en el archivo workflow_settings.yaml. Las tareas de la canalización usan el conjunto de datos predeterminado durante su ejecución.

Opciones de notebook

Para agregar un notebook a tu canalización, haz lo siguiente en la sección Opciones de notebook:

  1. En el campo de plantilla de entorno de ejecución, acepta el entorno de ejecución predeterminado del notebook o busca y selecciona un entorno de ejecución existente.

  2. En el campo Bucket de Cloud Storage, haz clic en Explorar y selecciona o crea un bucket de Cloud Storage para almacenar el resultado de los notebooks en tu canalización.

  3. Sigue los pasos que se indican en Agrega un principal a una política a nivel del bucket para agregar tu cuenta de servicio personalizada de Dataform como principal al bucket de Cloud Storage que planeas usar para almacenar el resultado de ejecuciones programadas de canalizaciones y otorga el rol de administrador de almacenamiento (roles/storage.admin) a este principal.

    Se debe otorgar a la cuenta de servicio personalizada de Dataform seleccionada el rol de IAM de administrador de Storage en el bucket seleccionado.

Agrega una tarea de canalización

Para agregar una tarea a una canalización, sigue estos pasos:

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

    Ir a BigQuery

  2. En el panel de la izquierda, haz clic en  Explorar:

    Botón destacado del panel Explorador.

    Si no ves el panel izquierdo, haz clic en  Expandir panel izquierdo para abrirlo.

  3. En el panel Explorador, expande tu proyecto, haz clic en Canalizaciones y, luego, selecciona una canalización.

  4. Para agregar un recurso de código, selecciona una de las siguientes opciones:

    Consulta en SQL

    1. Haz clic en Agregar tarea y, luego, selecciona Consulta. Puedes crear una consulta nueva o importar una existente.

    2. Opcional: En el panel Detalles de la tarea de consulta, en el menú Ejecutar después de, selecciona una tarea que preceda a tu consulta.

    Crea una consulta nueva

    1. Haz clic en el menú de flecha junto a Editar consulta y selecciona En contexto o En una pestaña nueva.

    2. Buscar una consulta existente

    3. Selecciona un nombre de consulta y, luego, presiona Intro.

    4. Haz clic en Guardar.

    5. Opcional: Para cambiar el nombre de la consulta, haz clic en el nombre de la consulta en el panel de la canalización, luego en Editar consulta, haz clic en el nombre de la consulta existente en la parte superior de la pantalla y, luego, escribe un nombre nuevo.

    Cómo importar una búsqueda existente

    1. Haz clic en el menú de flecha junto a Editar consulta y, luego, en Importar una copia.

    2. Busca una consulta existente para importar o selecciona una consulta existente en el panel de búsqueda. Cuando importas una consulta, la original no se modifica porque el archivo fuente de la consulta se copia en la canalización.

    3. Haz clic en Editar para abrir la consulta importada.

    4. Haz clic en Guardar.

    Notebook

    1. Haz clic en Agregar tarea y, luego, selecciona Notebook. Puedes crear un cuaderno nuevo o importar uno existente. Para cambiar la configuración de las plantillas de tiempo de ejecución de notebooks, consulta Opciones de notebook.

    2. Opcional: En el panel Detalles de la tarea del notebook, en el menú Ejecutar después de, selecciona una tarea que preceda a tu notebook.

    Crea un cuaderno nuevo

    1. Haz clic en el menú de flecha junto a Edit Notebook y selecciona In context o In new tab.

    2. Busca un notebook existente.

    3. Selecciona un nombre de notebook y, luego, presiona Intro.

    4. Haz clic en Guardar.

    5. Opcional: Para cambiar el nombre del notebook, haz clic en su nombre en el panel de la canalización, luego en Editar notebook, haz clic en el nombre existente del notebook en la parte superior de la pantalla y, luego, escribe un nombre nuevo.

    Cómo importar un notebook existente

    1. Haz clic en el menú de flecha junto a Edit Notebook y, luego, en Import a copy.

    2. Busca un notebook existente para importar o selecciona uno existente en el panel de búsqueda. Cuando importas un notebook, el original permanece sin cambios porque el archivo fuente del notebook se copia en la canalización.

    3. Para abrir el notebook importado, haz clic en Editar.

    4. Haz clic en Guardar.

    Preparación de datos

    1. Haz clic en Agregar tarea y, luego, selecciona Preparación de datos. Puedes crear una preparación de datos nueva o importar una existente.

    2. Opcional: En el panel Detalles de la tarea de preparación de datos, en el menú Ejecutar después de, selecciona una tarea que preceda a la preparación de datos.

    Crea una nueva preparación de datos

    1. Haz clic en el menú de flecha junto a Editar preparación de datos y selecciona En contexto o En una pestaña nueva.

    2. Busca una preparación de datos existente.

    3. Selecciona un nombre de preparación de datos y presiona Intro.

    4. Haz clic en Guardar.

    5. Opcional: Para cambiar el nombre de la preparación de datos, haz clic en el nombre de la preparación de datos en el panel de la canalización, haz clic en Editar preparación de datos, haz clic en el nombre en la parte superior de la pantalla y, luego, ingresa un nombre nuevo.

    Cómo importar una preparación de datos existente

    1. Haz clic en el menú desplegable de flecha junto a Editar preparación de datos y, luego, en Importar una copia.

    2. Busca una preparación de datos existente para importar o selecciona una existente en el panel de búsqueda. Cuando importas una preparación de datos, el original permanece sin cambios porque el archivo fuente de la preparación de datos se copia en la canalización.

    3. Para abrir la preparación de datos importada, haz clic en Editar.

    4. Haz clic en Guardar.

    Tabla

    1. Haz clic en Agregar tarea y, luego, selecciona Tabla.

    2. En el panel Crear nuevo, selecciona Tabla o Tabla incremental.

    3. Verifica el proyecto predeterminado para la tabla o selecciona uno nuevo.

    4. Verifica el conjunto de datos predeterminado para la tabla o selecciona uno nuevo.

    5. Ingresa un nombre para la tabla.

    6. En el panel Detalles de la tarea de tabla, haz clic en Abrir para abrir la tarea.

    7. Configura la tarea con los parámetros de configuración en Detalles > Configuración o en el bloque config del editor de código de la tabla.

      Para los cambios de metadatos, usa la pestaña Configuración. Esta pestaña te permite editar un valor específico en el bloque config desde el editor de código, como una cadena o un array, que tiene el formato de un objeto de JavaScript. Usar esta pestaña te ayuda a evitar errores de sintaxis y verificar que la configuración sea correcta.

      Opcional: En el menú Ejecutar después de, selecciona una tarea que preceda a tu tabla.

      También puedes definir los metadatos de la tarea de tu canalización en el bloque config del editor. Para obtener más información, consulta Crea tablas.

      El editor valida tu código y muestra el estado de validación.

    8. En Detalles > Consultas compiladas, consulta el código SQL compilado a partir del código SQLX.

    9. Haz clic en Ejecutar para ejecutar el código SQL en tu canalización.

    10. En Resultados de la consulta, inspecciona la vista previa de los datos.

    Ver

    1. Haz clic en Agregar tarea y, luego, selecciona Ver.

    2. En el panel Crear nuevo, selecciona Vista o Vista materializada.

    3. Verifica el proyecto predeterminado de la vista o selecciona uno nuevo.

    4. Verifica el conjunto de datos predeterminado de la vista o selecciona uno nuevo.

    5. Ingresa un nombre para la vista.

    6. En el panel Ver detalles de la tarea, haz clic en Abrir para abrir la tarea.

    7. Configura la tarea con los parámetros de configuración en Detalles > Configuración o en el bloque config del editor de código de la vista.

      Para los cambios de metadatos, usa la pestaña Configuración. Esta pestaña te permite editar un valor específico en el bloque config desde el editor de código, como una cadena o un array, que tiene el formato de un objeto de JavaScript. Usar esta pestaña te ayuda a evitar errores de sintaxis y verificar que la configuración sea correcta.

      Opcional: En el menú Ejecutar después de, selecciona una tarea que preceda a tu vista.

      También puedes definir los metadatos de la tarea de tu canalización en el bloque config del editor. Para obtener más información, consulta Cómo crear una vista con Dataform Core.

      El editor valida tu código y muestra el estado de validación.

    8. En Detalles > Consultas compiladas, consulta el código SQL compilado a partir del código SQLX.

    9. Haz clic en Ejecutar para ejecutar el código SQL en tu canalización.

    10. En Resultados de la consulta, inspecciona la vista previa de los datos.

Cómo editar una tarea de canalización

Para editar una tarea de la canalización, sigue estos pasos:

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

    Ir a BigQuery

  2. En el panel de la izquierda, haz clic en  Explorar:

    Botón destacado del panel Explorador.

    Si no ves el panel izquierdo, haz clic en  Expandir panel izquierdo para abrirlo.

  3. En el panel Explorador, expande tu proyecto, haz clic en Canalizaciones y, luego, selecciona una canalización.

  4. Haz clic en la tarea seleccionada.

  5. Para cambiar la tarea anterior, en el menú Ejecutar después de, selecciona una tarea que preceda a la tuya.

  6. Para editar el contenido de la tarea seleccionada, haz clic en Editar.

  7. En la nueva pestaña que se abre, edita el contenido de la tarea y, luego, guarda los cambios.

Borra una tarea de canalización

Para borrar una tarea de una canalización, sigue estos pasos:

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

    Ir a BigQuery

  2. En el panel de la izquierda, haz clic en  Explorar:

    Botón destacado del panel Explorador.

    Si no ves el panel izquierdo, haz clic en  Expandir panel izquierdo para abrirlo.

  3. En el panel Explorador, expande tu proyecto, haz clic en Canalizaciones y, luego, selecciona una canalización.

  4. Haz clic en la tarea seleccionada.

  5. En el panel Detalles de la tarea, haz clic en Borrar Borrar.

Cómo compartir una canalización

Para compartir una canalización, sigue estos pasos:

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

    Ir a BigQuery

  2. En el panel de la izquierda, haz clic en  Explorar:

    Botón destacado del panel Explorador.

    Si no ves el panel izquierdo, haz clic en  Expandir panel izquierdo para abrirlo.

  3. En el panel Explorador, expande tu proyecto, haz clic en Canalizaciones y, luego, selecciona una canalización.

  4. Haz clic en Compartir y, luego, selecciona Administrar permisos.

  5. Haz clic en Agregar usuario o grupo.

  6. En el campo Principales nuevas, ingresa el nombre de al menos un usuario o grupo.

  7. En Asignar roles, selecciona un rol.

  8. Haz clic en Guardar.

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

    Ir a BigQuery

  2. En el panel de la izquierda, haz clic en  Explorar:

    Botón destacado del panel Explorador.

    Si no ves el panel izquierdo, haz clic en  Expandir panel izquierdo para abrirlo.

  3. En el panel Explorador, expande tu proyecto, haz clic en Canalizaciones y, luego, selecciona una canalización.

  4. Haz clic en Compartir y, luego, selecciona Compartir vínculo. La URL de tu canalización se copia en el portapapeles de tu computadora.

Ejecutar una canalización

Cuando ejecutas una canalización, puedes optar por ejecutar todas las tareas de la canalización, seleccionar manualmente tareas específicas para ejecutar o ejecutar tareas con etiquetas seleccionadas.

Ejecuta todas las tareas en una canalización

Para ejecutar manualmente la versión actual de una canalización, selecciona una de las siguientes opciones:

Console

Para ejecutar todas las tareas de una canalización, haz lo siguiente:

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

    Ir a BigQuery

  2. En el panel de la izquierda, haz clic en  Explorar:

    Botón destacado del panel Explorador.

    Si no ves el panel izquierdo, haz clic en  Expandir panel izquierdo para abrirlo.

  3. En el panel Explorador, expande tu proyecto, haz clic en Canalizaciones y, luego, selecciona una canalización.

  4. Haz clic en  Ejecutar > Ejecutar todas las tareas. Si seleccionaste Ejecutar con mis credenciales de usuario para tu autenticación, debes autorizar tu Cuenta de Google (versión preliminar).

  5. Opcional: Para inspeccionar la ejecución, consulta las ejecuciones manuales anteriores.

API

Para ejecutar una canalización de forma manual, compila el espacio de trabajo predeterminado y usa el resultado de la compilación para crear una invocación de flujo de trabajo.

  1. Para crear un resultado de compilación para el espacio de trabajo predeterminado, usa el método projects.locations.repositories.compilationResults.create.

    Ejecuta la solicitud a la API con la siguiente información:

    curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -d '{
      "workspace": "projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID/workspaces/default"
   }' \
   "https://dataform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID/compilationResults"

    Reemplaza lo siguiente:

    • LOCATION: Es la Google Cloud región de tu repositorio, por ejemplo, us-central1. Para encontrar la ubicación del repositorio en la consola de Google Cloud , navega al panel Explorador, selecciona la canalización, abre la pestaña Configuración y haz clic en Abrir canalización en Dataform. La ubicación se encuentra en la URL con el formato /locations/LOCATION/.
    • PROJECT_ID: Es el identificador único de tu proyecto deGoogle Cloud .
    • REPOSITORY_ID: Es el identificador único de tu repositorio de Dataform, por ejemplo, my-secure-repo. Puedes encontrar el ID del repositorio en la consola de Google Cloud . Para ello, navega al panel Explorador, selecciona la canalización, abre la pestaña Configuración y consulta el campo ID del repositorio de Dataform.

  2. En el cuerpo de la respuesta, busca el campo name y copia su valor, por ejemplo, projects/my-project/locations/us-central1/repositories/my-repo/compilationResults/12345-67890.

  3. Activa la ejecución de la canalización con el método projects.locations.repositories.workflowInvocations.create.

    Ejecuta la solicitud a la API con la siguiente información:

    curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -d '{
      "compilationResult": "COMPILATION_RESULT"
   }' \
   "https://dataform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID/workflowInvocations"

    Reemplaza lo siguiente:

    • COMPILATION_RESULT: Es el nombre completo del recurso del resultado de la compilación que copiaste en el paso anterior.
    • LOCATION: Es la Google Cloud región de tu repositorio, por ejemplo, us-central1.
    • PROJECT_ID: Es el identificador único de tu proyecto deGoogle Cloud .
    • REPOSITORY_ID: Es el identificador único de tu repositorio de Dataform, por ejemplo, my-secure-repo.

Ejecuta las tareas seleccionadas en una canalización

Para ejecutar tareas seleccionadas en una canalización, haz lo siguiente:

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

    Ir a BigQuery

  2. En el panel de la izquierda, haz clic en  Explorar:

    Botón destacado del panel Explorador.

    Si no ves el panel izquierdo, haz clic en  Expandir panel izquierdo para abrirlo.

  3. En el panel Explorador, expande tu proyecto, haz clic en Canalizaciones y, luego, selecciona una canalización.

  4. Haz clic en  Ejecutar > Seleccionar tareas para ejecutar.

  5. En el panel Ejecutar, en la sección Autenticación, autoriza la ejecución con las credenciales de usuario de tu Cuenta de Google o una cuenta de servicio.

    • Para usar las credenciales de usuario de tu Cuenta de Google (versión preliminar), selecciona Ejecutar con credenciales de usuario.
    • Para usar una cuenta de servicio personalizada, selecciona Ejecutar con la cuenta de servicio seleccionada y, luego, elige una cuenta de servicio personalizada. Si necesitas crear una cuenta de servicio, haz clic en Cuenta de servicio nueva.

  6. Asegúrate de que esté seleccionada la opción Selección de tareas.

  7. En el menú Selecciona las tareas que deseas ejecutar, busca tareas específicas y selecciona las que quieras ejecutar.

    En la tabla Tareas, se enumeran las tareas que seleccionaste. Haz clic en el nombre de una tarea para abrirla directamente en el editor de SQL.

  8. Opcional: Configura las siguientes opciones de ejecución:

    • Incluir dependencias: Selecciona esta opción para ejecutar las tareas seleccionadas y sus dependencias.
    • Include dependents: Selecciona esta opción para ejecutar las tareas seleccionadas y sus dependencias transitivas downstream.
    • Ejecutar con actualización completa: Selecciona esta opción para volver a compilar todas las tablas desde cero.
    • Ejecutar como trabajo interactivo con alta prioridad (predeterminada): Selecciona esta opción para establecer la prioridad del trabajo de consulta de BigQuery. De forma predeterminada, BigQuery ejecuta las consultas como trabajos de consulta interactivos, que están diseñados para comenzar a ejecutarse lo más rápido posible. Si borras esta opción, las consultas se ejecutarán como trabajos de consultas por lotes, que tienen una prioridad más baja.

  9. Haz clic en Ejecutar. Si seleccionaste Ejecutar con credenciales del usuario como método de autenticación, debes autorizar tu Cuenta de Google (versión preliminar).

  10. Opcional: Para inspeccionar la ejecución, consulta las ejecuciones manuales anteriores.

Ejecuta tareas con etiquetas seleccionadas en una canalización

Para ejecutar tareas con etiquetas seleccionadas en una canalización, haz lo siguiente:

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

    Ir a BigQuery

  2. En el panel de la izquierda, haz clic en  Explorar:

    Botón destacado del panel Explorador.

    Si no ves el panel izquierdo, haz clic en  Expandir panel izquierdo para abrirlo.

  3. En el panel Explorador, expande tu proyecto, haz clic en Canalizaciones y, luego, selecciona una canalización.

  4. Haz clic en  Ejecutar > Ejecutar por etiqueta y, luego, realiza una de las siguientes acciones:

    • Haz clic en una etiqueta que quieras ejecutar.
    • Haz clic en  Seleccionar etiquetas para ejecutar.

  5. En el panel Ejecutar, en la sección Autenticación, autoriza la ejecución con las credenciales de usuario de tu Cuenta de Google o una cuenta de servicio.

    • Para usar las credenciales de usuario de tu Cuenta de Google (versión preliminar), selecciona Ejecutar con credenciales de usuario.
    • Para usar una cuenta de servicio personalizada, selecciona Ejecutar con la cuenta de servicio seleccionada y, luego, elige una cuenta de servicio personalizada. Si necesitas crear una cuenta de servicio, haz clic en Cuenta de servicio nueva.

  6. Asegúrate de que esté seleccionada la opción Selección de etiquetas.

  7. En el menú Selecciona las etiquetas que deseas ejecutar, busca etiquetas específicas y selecciona las que deseas ejecutar.

    En la tabla Tareas, se enumeran las tareas que seleccionaste. Haz clic en el nombre de una tarea para abrirla directamente en el editor de SQL.

  8. Opcional: Configura las siguientes opciones de ejecución:

    • Incluir dependencias: Selecciona esta opción para ejecutar las tareas seleccionadas y sus dependencias.
    • Include dependents: Selecciona esta opción para ejecutar las tareas seleccionadas y sus dependencias transitivas downstream.
    • Ejecutar con actualización completa: Selecciona esta opción para volver a compilar todas las tablas desde cero.
    • Ejecutar como trabajo interactivo con alta prioridad (predeterminada): Selecciona esta opción para establecer la prioridad del trabajo de consulta de BigQuery. De forma predeterminada, BigQuery ejecuta las consultas como trabajos de consulta interactivos, que están diseñados para comenzar a ejecutarse lo más rápido posible. Si borras esta opción, las consultas se ejecutarán como trabajos de consultas por lotes, que tienen una prioridad más baja.

  9. Haz clic en Ejecutar. Si seleccionaste Ejecutar con credenciales del usuario como método de autenticación, debes autorizar tu Cuenta de Google (versión preliminar).

  10. Opcional: Para inspeccionar la ejecución, consulta las ejecuciones manuales anteriores.

Autoriza tu Cuenta de Google

Para autenticar el recurso con las credenciales de usuario de tu Cuenta de Google, debes otorgar permiso de forma manual a las canalizaciones de BigQuery para obtener el token de acceso de tu Cuenta de Google y acceder a los datos de origen en tu nombre. Puedes otorgar la aprobación manual con la interfaz del diálogo de OAuth.

Solo debes otorgar permiso a las canalizaciones de BigQuery una vez.

Para revocar el permiso que otorgaste, sigue estos pasos:

  1. Ve a la página de tu Cuenta de Google.
  2. Haz clic en BigQuery Pipelines.
  3. Haga clic en Quitar acceso.

Si tu canalización contiene un notebook, también debes otorgar permiso de forma manual para que Colab Enterprise obtenga el token de acceso a tu Cuenta de Google y acceda a los datos de origen en tu nombre. Solo debes otorgar el permiso una vez. Puedes revocar este permiso en la página de la Cuenta de Google.

¿Qué sigue?