Administra las dependencias de la API de BigQuery

En este documento, se describen los servicios y las APIs de los que depende BigQuery. Google Cloud También se explican los efectos en el comportamiento de BigQuery cuando inhabilitas esos servicios. Revisa este documento antes de habilitar o inhabilitar servicios en tu proyecto.

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

• Servicios habilitados de forma predeterminada
• Habilita e inhabilita servicios

Este documento está dirigido a los administradores.

Servicios habilitados de manera predeterminada

Los siguientes servicios están habilitados de forma predeterminada para cada proyecto nuevo deGoogle Cloud :

Servicio	Qué funciones dependen de él	Efectos de inhabilitar este servicio
analyticshub.googleapis.com	Publica intercambios de datos Publicar fichas y administrar suscripciones Salas limpias de datos	No puedes crear ni administrar intercambios de datos, fichas, salas limpias de datos ni suscripciones. No puedes buscar ni explorar intercambios o fichas que creen otros proveedores. Las suscripciones creadas persisten, pero no son accesibles. 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 administrar 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 en SQL	No puedes crear tareas ni evaluaciones de migración. No hay tareas ni evaluaciones existentes disponibles. Nota: Por lo general, puedes inhabilitar este servicio después de completar la migración de datos.
bigquerydatapolicy.googleapis.com	Enmascaramiento de datos	No puedes administrar tus políticas de enmascaramiento de datos. No se borran las políticas de enmascaramiento de datos, pero fallan las consultas a las tablas con el enmascaramiento de datos aplicado.
bigquerydatatransfer.googleapis.com	Transferencias de datos programadas	No puedes administrar tus transferencias de datos programadas. Se detienen las transferencias de datos existentes.
bigqueryreservation.googleapis.com	Administración de cargas de trabajo basada en la capacidad	No puedes crear ni administrar compromisos de capacidad, reservas ni asignaciones. No puedes supervisar el uso de las ranuras. La conmutación por error de recuperación ante desastres no está disponible. Se detiene el ajuste de escala automático de ranuras.
bigquerystorage.googleapis.com	Transferencia de datos de transmisión Carga de datos por lotes Captura de datos modificados	No puedes usar la API de Storage Read ni la API de Storage Write para acceder a tus datos de BigQuery.
dataform.googleapis.com	Dataform proporciona repositorios de código que aprovechan las siguientes funciones: Canalizaciones de BigQuery Consultas guardadas Notebooks de Colab Dataform Preparación de datos Lienzo de datos	No puedes crear canalizaciones, consultas guardadas, notebooks de Colab, lienzos de datos, preparaciones de datos ni proyectos de Dataform. Se detienen las canalizaciones, los notebooks o los proyectos de Dataform programados existentes. No se podrá acceder a las canalizaciones existentes, las consultas guardadas, los notebooks de Colab, los lienzos de datos, las preparaciones de datos ni los proyectos de Dataform.
dataplex.googleapis.com	Dataplex Universal Catalog proporciona capacidades de administración y catalogación de datos que utilizan los siguientes elementos: Explorador de recursos en BigQuery Studio Función de autocompletar en el editor de SQL de BigQuery Studio Búsqueda de fichas de BigQuery sharing (anteriormente Analytics Hub) Estadísticas del perfil Análisis de la calidad de los datos Visualización del linaje de datos Estadísticas de tablas y conjuntos de datos Lienzo de datos	La búsqueda de activos de datos de BigQuery no está disponible. La búsqueda de fichas para compartir no está disponible. No puedes crear nuevas estadísticas del perfil ni acceder a las que se crearon anteriormente, ni a los análisis de calidad de los datos ni a las sugerencias de consultas. No puedes ver los detalles de los recursos de datos en un grafo de linaje. No puedes buscar recursos de datos en el lienzo de datos.

Efecto de inhabilitar la API de BigQuery

Si inhabilitas la API de 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 de BigQuery Unified

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

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

Servicio	Qué funciones dependen de él	Efectos de inhabilitar este servicio
aiplatform.googleapis.com	Notebooks de Colab Modelos remotos de BigQuery ML	No podrás ejecutar tus notebooks. Dejarán de funcionar los modelos remotos de BigQuery ML existentes. Podrás seguir editando tus notebooks existentes.
bigqueryunified.googleapis.com	Proporciona la activación con un solo clic de los servicios dependientes de BigQuery que se enumeran en este documento, excepto las APIs de cloudaicompanion, composer y datalineage. Garantiza que las nuevas dependencias de BigQuery estén habilitadas en tu proyecto.	Las dependencias futuras no se habilitan 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 notebooks de Colab, los modelos de AA remotos y los trabajos de Apache Spark, SparkSQL y PySpark. El código fuente sigue estando disponible. Se inhabilita la API de Dataproc.
dataproc.googleapis.com	Consulta datos con motores de código abierto, como Apache Spark. Usa Spark SQL o PySpark con Google Cloud Serverless for Apache Spark. Usa procedimientos almacenados para Spark.	No puedes crear clústeres de Dataproc para ejecutar análisis de datos de código abierto. No puedes ejecutar cargas de trabajo de Serverless for Apache Spark. No puedes ejecutar Spark en cargas de trabajo de BigQuery.
datastream.googleapis.com	Proporciona captura de datos modificados y replicación en BigQuery.	Todos los flujos de datos están pausados y no son accesibles.

Servicios inhabilitados de forma predeterminada

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

Servicio	Qué funciones dependen de él	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. Obtén más información para desactivar Gemini en BigQuery.
composer.googleapis.com	Programa cargas de trabajo	Los DAG existentes de Cloud Composer no aparecen en la página Programación y se detienen. Los entornos existentes de Cloud Composer dejan de funcionar y muestran un estado de error.
datalineage.googleapis.com	Captura y visualización del linaje de datos	No se captura el linaje de datos de tu proyecto. No puedes ver el gráfico de linaje.

Habilita manualmente los elementos de código de BigQuery

Para administrar elementos de código en BigQuery, como notebooks y consultas guardadas, debes habilitar las siguientes APIs:

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

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

Antes de comenzar

Si deseas habilitar la administración de elementos de código de forma manual, debes tener el rol de propietario (roles/owner) de Identity and Access Management (IAM) .

Habilita manualmente los elementos de código de BigQuery

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

1. Ve a la página de BigQuery.

   Ir a BigQuery

2. En Studio, en la barra de pestañas del panel del editor, haz clic en la flecha desplegable junto al signo +, mantén el puntero sobre Notebook y, luego, selecciona Empty notebook.

3. Haz clic en Habilitar las API.

   Si no ves esta opción, comprueba si tienes el rol de propietario de IAM requerido (roles/owner). Si se abre un notebook vacío, significa que ya tienes habilitadas las APIs necesarias.

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

   1. Para habilitar todas las dependencias de BigQuery para la transmisión de datos, la programación y los notebooks, haz clic en Habilitar junto a API unificada de BigQuery.
   2. Opcional: Para elegir qué APIs habilitar, haz clic en Visualizar y habilitar APIs individuales y, luego, en Habilitar junto a cada API que quieras habilitar.
   3. Cuando se habiliten las APIs, haz clic en Siguiente.

5. Opcional: Configura los permisos del usuario en la sección Permisos:

   • Para otorgar a los principales la capacidad de crear elementos de código, y leer, editar y establecer permisos para los elementos de código que crearon, escribe sus nombres de usuario o grupo en el campo Usuario de BigQuery Studio.
   • Para otorgar a los principales la capacidad de leer, editar y establecer permisos para todos los recursos de código compartidos con ellos, escribe sus nombres de usuario o grupo en el campo Administrador de BigQuery Studio.

6. Haz clic en Siguiente.

7. Opcional: En la sección APIs adicionales, haz clic en Habilitar todo para habilitar las APIs que necesitas para crear procedimientos remotos de BigQuery con BigQuery DataFrames.

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

Restringe el acceso a los recursos de código

Para evitar la habilitación de APIs adicionales, configura la restricción de la política de la organización Restringir el uso de servicios del recurso. Puedes desactivar las APIs seleccionadas en cualquier momento.

Próximos pasos

• Para obtener información sobre cómo administrar los Google Cloud servicios, consulta Habilita e inhabilita servicios.
• Para obtener información sobre cómo administrar el acceso a la API a un nivel detallado con restricciones de políticas de la organización, consulta Restringe el uso de recursos.
• Para obtener información sobre cómo controlar el acceso a los servicios con roles y permisos de Identity and Access Management (IAM) para BigQuery, consulta Roles y permisos de IAM de BigQuery.