Administra las dependencias de la API de BigQuery

Puedes administrar el comportamiento de BigQuery si comprendes cómo cada API afecta las funciones de Google Cloud que dependen de esas APIs. Algunos servicios de la API están habilitados de forma predeterminada en cada proyecto de Google Cloud que crees, mientras que otros se habilitan automáticamente para todos los proyectos de Google Cloud que usen BigQuery. Debes habilitar de forma explícita los servicios de la API restantes antes de poder usar su funcionalidad.

Inhabilitar una dependencia de forma incorrecta puede afectar la funcionalidad de BigQuery. Comprende estas dependencias para tomar decisiones fundamentadas cuando habilites o inhabilites servicios en tu proyecto de Google Cloud .

Servicios habilitados de manera predeterminada

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

Servicio	Nombre de la API	Qué funciones dependen de ella	Efectos de inhabilitar este servicio
BigQuery sharing	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 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
API de BigQuery Connection	bigqueryconnection.googleapis.com	Consultas federadas a datos almacenados fuera de BigQuery Tablas y conjuntos de datos externos Metastore de BigQuery	No puedes administrar conexiones externas. No puedes crear modelos remotos. No puedes crear funciones remotas. No puedes consultar tablas de BigLake ni tablas de objetos.
Servicio de migración de BigQuery	bigquerymigration.googleapis.com	Evaluación de la migración de datos Traducción de consultas en SQL	No puedes crear tareas de migración ni evaluaciones. 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.
Política de datos de BigQuery	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 enmascaramiento de datos aplicado fallan.
Servicio de transferencia de datos de BigQuery	bigquerydatatransfer.googleapis.com	Transferencias de datos programadas	No puedes administrar tus transferencias de datos programadas. Se detienen las transferencias de datos existentes.
API de BigQuery Reservation	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.
API de BigQuery Storage	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 (gRPC) para acceder a tus datos de BigQuery.
Dataform	dataform.googleapis.com	Dataform proporciona repositorios de código que se aprovechan con 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, las consultas guardadas, los notebooks de Colab, los lienzos de datos, las preparaciones de datos ni los proyectos de Dataform existentes.
Knowledge Catalog	dataplex.googleapis.com	Knowledge Catalog proporciona capacidades de catalogación y administración de datos que usan los siguientes roles: Explorador de recursos en BigQuery Studio Autocompletado 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 recursos de datos de BigQuery no está disponible. La búsqueda de fichas compartidas no está disponible. No puedes crear estadísticas de perfiles, análisis de calidad de los datos ni sugerencias de consultas nuevos ni acceder a los creados anteriormente. 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

Inhabilitar la API de BigQuery también inhabilita los siguientes servicios que dependen de ella:

• Autorización binaria (binaryauthorization.googleapis.com)
• Google Kubernetes Engine (container.googleapis.com)
• APIs deGoogle Cloud (cloudapis.googleapis.com)
• Dataprep de Trifacta (dataprep.googleapis.com)
• Agente de servicio abierto para Google Cloud (servicebroker.googleapis.com)
• Tejido de datos para telecomunicaciones (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 se requieren 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 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	Nombre de la API	Qué funciones dependen de ella	Efectos de inhabilitar este servicio
Vertex AI	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. Tus notebooks existentes seguirán estando disponibles para su edición.
API de BigQuery Unified	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 dependencias nuevas de BigQuery estén habilitadas en tu proyecto.	Las dependencias futuras no se habilitan automáticamente en tu proyecto.
Compute Engine	compute.googleapis.com	Google Compute Engine proporciona un entorno de ejecución para todas las funciones que proporcionan Managed Service para Apache Spark y Gemini Enterprise Agent Platform.	Se detienen los notebooks de Colab, los modelos de AA remotos, Apache Spark, SparkSQL y los trabajos de PySpark. El código fuente sigue disponible. Se inhabilita la API de Dataproc.
Managed Service para Apache Spark	dataproc.googleapis.com	Consulta datos con motores de código abierto, como Apache Spark. Usa Spark SQL o PySpark con Managed Service para Apache Spark. Usa procedimientos almacenados para Spark.	No puedes crear clústeres de Managed Service para Apache Spark para ejecutar análisis de datos de código abierto. No puedes ejecutar cargas de trabajo de Managed Service para Apache Spark. No puedes ejecutar cargas de trabajo de Spark en BigQuery.
Datastream	datastream.googleapis.com	Proporciona captura de datos modificados 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 de forma manual los siguientes servicios para que las funciones correspondientes estén disponibles:

Servicio	Nombre de la API	Qué funciones dependen de ella	Efectos de inhabilitar este servicio
API de Gemini para Google Cloud	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.
Managed Service para Apache Airflow	composer.googleapis.com	Programa cargas de trabajo	Los DAG existentes de Managed Service para Apache Airflow no aparecen en la página Programación y se detienen. Los entornos de Managed Airflow existentes dejan de funcionar y devuelven un estado de error.
API de Data Lineage	datalineage.googleapis.com	Captura y visualización del linaje de datos	No se captura el linaje de datos para 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 en 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 la 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 Notebook vacío.

3. Haz clic en Habilitar APIs.

   Si no ves esta opción, verifica 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, junto a API de BigQuery Unified, haz clic en Habilitar.
   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 las principales la capacidad de crear recursos de código, y leer, editar y establecer permisos para los recursos de código que crearon, escribe sus nombres de usuario o grupo en el campo Usuario de BigQuery Studio.
   • Para otorgar a las principales la capacidad de leer, editar y establecer permisos para todos los recursos de código compartidos con ellas, 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 aprender a administrar los servicios de Google Cloud , consulta Habilita e inhabilita servicios.
• Para aprender a administrar el acceso a la API de forma detallada con restricciones de la política de la organización, consulta Restringe el uso de recursos.
• Para aprender a 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.