Gestionar las dependencias de la API de BigQuery

En este documento se describen los Google Cloud servicios y las APIs de los que depende BigQuery. También se explica cómo afecta al comportamiento de BigQuery cuando inhabilitas esos servicios. Consulta este documento antes de habilitar o inhabilitar servicios en tu proyecto.

Algunos servicios están habilitados de forma predeterminada en todos los proyectos que creas. Google Cloud Otras APIs se habilitan automáticamente en todos los proyectos de Google Cloud que usan BigQuery. Los servicios restantes deben habilitarse explícitamente para poder usar sus funciones. Para obtener más información, consulta los siguientes recursos:

• Servicios habilitados de forma predeterminada
• Habilitar e inhabilitar servicios

Este documento está dirigido a administradores.

Servicios habilitados de forma predeterminada

Los siguientes servicios están habilitados de forma predeterminada en todos los proyectos nuevos:Google Cloud

Servicio	Qué funciones dependen de ella	Efectos de inhabilitar este servicio
analyticshub.googleapis.com	Publicar intercambios de datos Publicar fichas y gestionar suscripciones Salas blancas de datos	No puedes crear ni gestionar intercambios de datos, fichas, salas blancas de datos ni suscripciones. No puedes buscar ni explorar mercados o fichas que creen otros proveedores. Las suscripciones creadas se conservan, pero no se puede acceder a ellas. Se puede acceder a los conjuntos de datos vinculados siempre que la API de BigQuery esté habilitada. No puedes crear suscripciones nuevas
bigqueryconnection.googleapis.com	Consultas federadas a datos almacenados fuera de BigQuery Tablas y conjuntos de datos externos Metastore de BigQuery	No puedes gestionar las conexiones externas. No puedes crear modelos remotos. No puedes crear funciones remotas. No puedes consultar tablas de BigLake ni tablas de objetos.
bigquerymigration.googleapis.com	Evaluación de la migración de datos Traducción de consultas de SQL	No puedes crear tareas ni evaluaciones de migración. No hay tareas ni evaluaciones disponibles. Nota: Normalmente, puedes inhabilitar este servicio después de completar la migración de datos.
bigquerydatapolicy.googleapis.com	Anonimización de datos	No puedes gestionar tus políticas de enmascaramiento de datos. Las políticas de enmascaramiento de datos no se eliminan, pero las consultas a tablas con enmascaramiento de datos aplicado fallan.
bigqueryreservation.googleapis.com	Gestión de cargas de trabajo basada en la capacidad	No puedes crear ni gestionar compromisos de capacidad, reservas ni asignaciones. No puedes monitorizar el uso de las ranuras. La conmutación por error de recuperación tras desastres no está disponible. El autoescalado de ranuras se detiene.
bigquerystorage.googleapis.com	Ingestión de datos de streaming Carga de datos por lotes Captura de datos de cambios	No puedes usar la API Storage Read ni la API Storage Write para acceder a tus datos de BigQuery.
dataform.googleapis.com	Dataform proporciona repositorios de código que utilizan las siguientes funciones: Pipelines de BigQuery Consultas guardadas Cuadernos de Colab Dataform Preparación de datos Lienzo de datos	No puedes crear flujos de trabajo, consultas guardadas, cuadernos de Colab, lienzos de datos, preparaciones de datos ni proyectos de Dataform. Se detienen los flujos de procesamiento, los cuadernos o los proyectos de Dataform programados. No se podrá acceder a las canalizaciones, las consultas guardadas, los cuadernos de Colab, los lienzos de datos, las preparaciones de datos ni los proyectos de Dataform.
dataplex.googleapis.com	Dataplex Universal Catalog proporciona funciones de catalogación y gobernanza de datos que utilizan los siguientes elementos: Explorador de recursos en BigQuery Studio Autocompletar en el editor de SQL de BigQuery Studio Buscar fichas de uso compartido de BigQuery (antes Analytics Hub) Estadísticas del perfil Analizar la calidad de los datos Ver el linaje de datos Estadísticas de tablas y conjuntos de datos Lienzo de datos	La búsqueda de recursos de datos de BigQuery no está disponible. No se puede buscar en las fichas compartidas. No podrás crear ni acceder a las estadísticas de perfil, los análisis de calidad de los datos ni las sugerencias de consultas que hayas creado anteriormente. No puede ver los detalles de los recursos de datos en un gráfico de linaje. No puedes buscar recursos de datos en el lienzo de datos.

Efecto de inhabilitar la API de BigQuery

Si inhabilita la API BigQuery, también se inhabilitarán los siguientes servicios, que dependen de ella:

• binaryauthorization.googleapis.com
• container.googleapis.com
• cloudapis.googleapis.com
• dataprep.googleapis.com
• servicebroker.googleapis.com
• telecomdatafabric.googleapis.com

Servicios habilitados por la API BigQuery Unified

La API BigQuery Unified (bigqueryunified.googleapis.com) incluye una colección de servicios seleccionados que son necesarios para que funcionen varias funciones de BigQuery. Si habilitas la API unificada de BigQuery, todos estos servicios se activarán simultáneamente. Google puede actualizar los servicios de esta colección, y esos servicios se habilitan automáticamente en los proyectos en los que esta API esté habilitada. Puedes inhabilitar servicios y APIs concretos.

Para obtener instrucciones sobre cómo habilitar bigqueryunified.googleapis.com, consulta Habilitar e inhabilitar servicios.

Servicio	Qué funciones dependen de ella	Efectos de inhabilitar este servicio
aiplatform.googleapis.com	Cuadernos de Colab Modelos remotos de BigQuery ML	No podrás ejecutar tus cuadernos. Los modelos remotos de BigQuery ML dejarán de funcionar. Podrás seguir editando los cuadernos que ya tengas.
bigqueryunified.googleapis.com	Permite activar con un solo clic los servicios dependientes de BigQuery que se indican en este documento, excepto las APIs cloudaicompanion, composer y datalineage. Asegura que las nuevas dependencias de BigQuery estén habilitadas en tu proyecto.	Las dependencias futuras no se habilitarán automáticamente en tu proyecto.
compute.googleapis.com	Google Compute Engine proporciona un entorno de ejecución para todas las funciones que ofrecen Dataproc y Vertex AI.	Se detienen los cuadernos de Colab, los modelos de aprendizaje automático remotos y las tareas de Apache Spark, SparkSQL y PySpark. El código fuente sigue estando disponible. La API de Dataproc se inhabilita.
dataproc.googleapis.com	Consulta datos con motores de código abierto, como Apache Spark. Usa Spark SQL o PySpark con Google Cloud Serverless para Apache Spark. Usa procedimientos almacenados para Spark.	No puedes crear clústeres de Dataproc para ejecutar analíticas de datos de código abierto. No puedes ejecutar cargas de trabajo de Serverless para Apache Spark. No puedes ejecutar Spark en cargas de trabajo de BigQuery.
datastream.googleapis.com	Proporciona captura de datos de cambios y replicación en BigQuery.	Todos los flujos de datos se pausan y no se puede acceder a ellos.

Servicios inhabilitados de forma predeterminada

Debes habilitar manualmente los siguientes servicios para que las funciones correspondientes estén disponibles:

Servicio	Qué funciones dependen de ella	Efectos de inhabilitar este servicio
cloudaicompanion.googleapis.com	Funciones de Gemini en BigQuery	Las funciones de finalización, generación y explicación de código dejan de funcionar. Consulta más información sobre cómo desactivar Gemini en BigQuery.
composer.googleapis.com	Programar cargas de trabajo	Los DAGs de Cloud Composer no aparecen en la página Programación y se detienen. Los entornos de Cloud Composer dejan de funcionar y devuelven un estado de error.
datalineage.googleapis.com	Captura y visualización del linaje de los datos	No se ha registrado el linaje de datos de tu proyecto. No puedes ver el gráfico de linaje.

Habilitar manualmente los recursos de código de BigQuery

Para gestionar recursos de código en BigQuery, como cuadernos y consultas guardadas, debes habilitar las siguientes APIs:

• API de Compute Engine
• API Dataform
• API de Vertex AI

Antes de marzo del 2024, estas APIs no estaban habilitadas automáticamente de forma predeterminada. Si tienes secuencias de comandos de automatización anteriores a marzo del 2024 que dependían del estado de estas APIs, es posible que tengas que actualizarlas. Si ya tienes estas APIs habilitadas, verás las carpetas Notebooks y Queries en el panel Explorador de BigQuery.

Antes de empezar

Para habilitar manualmente la gestión de recursos de código, debes tener el rol Propietario (roles/owner) de Gestión de Identidades y Accesos (IAM).

Habilitar manualmente los recursos de código de BigQuery

Para habilitar las dependencias de API necesarias para los recursos de código, sigue estos pasos:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En Studio, en la barra de pestañas del panel del editor, haz clic en el arrow_drop_down menú desplegable de flecha situado junto al signo +, coloca el puntero sobre Notebook y, a continuación, selecciona Plantilla de BigQuery.

3. En el banner que aparece debajo de la barra de pestañas del panel del editor, haz clic en Habilitar.

   Si no ves el banner, comprueba si tienes el rol Propietario de IAM.

4. En el panel Habilitar funciones, en la sección APIs de funciones principales, haz lo siguiente:

   1. Para habilitar el historial de versiones y el uso compartido de recursos de código, en la sección Historial de versiones y uso compartido, haz clic en Habilitar.
   2. Para habilitar los cuadernos, en Cuadernos de Python, haz clic en Habilitar todo.
   3. Cuando las APIs estén habilitadas, haz clic en Siguiente.

5. Opcional: Define los permisos de usuario en la sección Permisos:

   • Para conceder a los principales la capacidad de crear recursos de código y de leer, editar y definir permisos para los recursos de código que hayan creado, escribe sus nombres de usuario o de grupo en el campo Creador.
   • Para conceder a las entidades principales la capacidad de leer, editar y definir permisos para todos los recursos de código compartidos con ellas, escribe sus nombres de usuario o de grupo en el campo Propietario.

6. Haz clic en Siguiente.

7. Opcional: En la sección APIs adicionales, haga clic en Habilitar todas para habilitar las APIs que necesite para crear procedimientos remotos de BigQuery mediante BigQuery DataFrames.

8. Si has decidido no habilitar las APIs adicionales, haz clic en Cerrar para cerrar el panel Habilitar funciones.

Restringir el acceso a recursos de código

Para evitar que se habiliten APIs adicionales, puedes definir la restricción de la política de la organización Restrict Resource Service Usage. Puedes desactivar las APIs seleccionadas en cualquier momento.

Siguientes pasos

• Para saber cómo gestionar los Google Cloud servicios, consulta el artículo Habilitar e inhabilitar servicios.
• Para saber cómo gestionar el acceso a las APIs de forma granular con restricciones de políticas de organización, consulta el artículo sobre cómo restringir el uso de recursos.
• Para saber cómo controlar el acceso a los servicios con roles y permisos de gestión de identidades y accesos (IAM) en BigQuery, consulta el artículo sobre los roles y permisos de gestión de identidades y accesos de BigQuery.