Se usó la API de Cloud Translation para traducir esta página.

Administra 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 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 Google Cloud proyecto que creas. Otras APIs se habilitan automáticamente para todos los Google Cloud proyectos que usan BigQuery. Los servicios restantes deben estar habilitados de forma explícita antes de que puedas usar su funcionalidad. Para obtener más información, consulta los siguientes recursos:

Este documento está dirigido a administradores.

Servicios habilitados de manera predeterminada

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

Servicio	Qué funciones dependen de ella	Efectos de inhabilitar este servicio
`analyticshub.googleapis.com`	Publica intercambios de datos Publica fichas y administra 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 ni fichas que creen otros proveedores. Las suscripciones creadas persisten, 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 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 de SQL	No puedes crear tareas ni evaluaciones de migración. Las tareas o evaluaciones existentes no están 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. Las políticas de enmascaramiento de datos no se borran, pero las consultas a las tablas con el enmascaramiento de datos aplicado fallan.
`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 las ranuras.
`bigquerystorage.googleapis.com`	Transferencia de datos por 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 se aprovechan de las siguientes funciones: Canales 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, las consultas guardadas, los notebooks de Colab, los lienzos de datos, las preparaciones de datos ni los proyectos de Dataform existentes.
`dataplex.googleapis.com`	Dataplex Universal Catalog proporciona capacidades de catalogación y administración de datos que usan las siguientes entidades: Explorador de recursos en BigQuery Studio Autocompletar en el editor de SQL de BigQuery Studio Búsqueda de fichas en 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 recursos de datos de BigQuery no está disponible. La búsqueda de fichas compartidas no está disponible. No puedes crear estadísticas de perfil, análisis de calidad de los datos ni sugerencias de consultas nuevas ni acceder a las creadas anteriormente. No puedes ver los detalles de los activos de datos en un gráfico de linaje. No puedes buscar recursos de datos en el lienzo de datos.

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 activan de forma simultánea. Google puede actualizar los servicios de esta colección, y esos servicios se habilitan automáticamente en los proyectos que tienen habilitada esta API. 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 ella	Efectos de inhabilitar este servicio
`aiplatform.googleapis.com`	Notebooks de Colab Modelos remotos de BigQuery ML	No podrás ejecutar tus notebooks. Los modelos remotos de BigQuery ML existentes dejan de funcionar. Podrás seguir editando tus notebooks existentes.
`bigqueryunified.googleapis.com`	Proporciona una 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 IA remotos, los trabajos de Apache Spark, SparkSQL y PySpark. El código fuente seguirá 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 Dataproc sin servidores. Usa procedimientos almacenados para Spark.	No puedes crear clústeres de Dataproc para ejecutar análisis de datos con código abierto. No puedes ejecutar cargas de trabajo de Dataproc Serverless. No puedes ejecutar Spark en cargas de trabajo de BigQuery.
`datastream.googleapis.com`	Proporciona captura de datos modificados y replicación a BigQuery.	Todos los flujos de datos están pausados 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. Obtén más información para desactivar Gemini en BigQuery.
`composer.googleapis.com`	Programa cargas de trabajo	Los DAGs existentes de Cloud Composer no aparecen en la página Programación y se detienen. Los entornos de Cloud Composer existentes 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 recursos 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 estas APIs habilitadas, 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, 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 elementos de código, sigue estos pasos:

Ve a la página de BigQuery.

Ir a BigQuery
En Studio, en la barra de pestañas del panel del editor, haz clic en la flecha desplegable junto al signo +, coloca el puntero sobre Notebook y, luego, selecciona Plantilla de BigQuery.
En el banner que aparece debajo de la barra de pestañas del panel de edición, haz clic en Habilitar.

Si no ves el banner, comprueba si tienes el rol de Propietario de IAM requerida.
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 elementos de código, en la sección Historial de versiones y uso compartido, haz clic en Habilitar.
2. Para habilitar los notebooks, en Notebooks de Python, haz clic en Habilitar todos.
3. Cuando se hayan habilitado las APIs, haz clic en Siguiente.
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 Creador.
- Para otorgar a los principales la capacidad de leer, editar y establecer permisos para todos los elementos de código compartidos con ellos, escribe sus nombres de usuario o grupo en el campo Propietario.
Haz clic en Siguiente.
Opcional: En la sección APIs adicionales, haz clic en Habilitar todo para habilitar las APIs que necesitas para crear procedimientos remotos de BigQuery usando BigQuery DataFrames.
Si eliges no habilitar las APIs adicionales, haz clic en Cerrar para cerrar el panel Habilitar funciones.

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 servicios Google Cloud , consulta Cómo habilitar o inhabilitar servicios.
Para obtener información sobre cómo administrar el acceso a la API a nivel detallado con restricciones de la política de la organización, consulta Cómo restringir 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.