Gérer les dépendances de l'API BigQuery

Vous pouvez gérer le comportement de BigQuery en comprenant l'impact de chaque API sur les fonctionnalités Google Cloud qui en dépendent. Certains services d'API sont activés par défaut dans chaque projet Google Cloud que vous créez, tandis que d'autres sont automatiquement activés pour tous les projets Google Cloud qui utilisent BigQuery. Vous devez explicitement activer les services d'API restants avant de pouvoir utiliser leurs fonctionnalités.

La désactivation incorrecte d'une dépendance peut affecter les fonctionnalités de BigQuery. Comprenez ces dépendances pour prendre des décisions éclairées lorsque vous activez ou désactivez des services dans votre projet Google Cloud .

Services activés par défaut

Les services suivants sont activés par défaut pour chaque nouveau projetGoogle Cloud  :

Service	Nom de l'API	Quelles fonctionnalités en dépendent ?	Conséquences de la désactivation de ce service
BigQuery Sharing	analyticshub.googleapis.com	Publier des échanges de données Publier des fiches et gérer les abonnements Salles blanches de données	Vous ne pouvez pas créer ni gérer d'échanges de données, de fiches, de data clean rooms ni d'abonnements. Vous ne pouvez pas rechercher ni explorer les échanges ou les fiches créés par d'autres fournisseurs. Les abonnements créés sont conservés, mais ne sont pas accessibles. Les ensembles de données associés sont accessibles tant que l'API BigQuery est activée. Vous ne pouvez pas créer d'abonnements
API BigQuery Connection	bigqueryconnection.googleapis.com	Requêtes fédérées sur des données stockées en dehors de BigQuery Tables et ensembles de données externes Métastore BigQuery	Vous ne pouvez pas gérer les connexions externes. Vous ne pouvez pas créer de modèles distants. Vous ne pouvez pas créer de fonctions distantes. Vous ne pouvez pas interroger les tables BigLake ni les tables d'objets.
Service de migration BigQuery	bigquerymigration.googleapis.com	Évaluation de la migration des données Traduction de requêtes SQL	Vous ne pouvez pas créer de tâches ni d'évaluations de migration. Les tâches ou évaluations existantes ne sont pas disponibles. Remarque : En général, vous pouvez désactiver ce service une fois la migration des données terminée.
Règles de données BigQuery	bigquerydatapolicy.googleapis.com	Masquage des données	Vous ne pouvez pas gérer vos règles de masquage des données. Les règles de masquage des données ne sont pas supprimées, mais les requêtes sur les tables auxquelles le masquage des données est appliqué échouent.
Service de transfert de données BigQuery	bigquerydatatransfer.googleapis.com	Transferts de données planifiés	Vous ne pouvez pas gérer vos transferts de données planifiés. Les transferts de données existants s'arrêtent.
API BigQuery Reservation	bigqueryreservation.googleapis.com	Gestion des charges de travail basée sur la capacité	Vous ne pouvez pas créer ni gérer d'engagements de capacité, de réservations ni d'attributions. Vous ne pouvez pas surveiller l'utilisation des emplacements. Le basculement de reprise après sinistre n'est pas disponible. L'autoscaling des emplacements s'arrête.
API BigQuery Storage	bigquerystorage.googleapis.com	Ingestion de données en flux continu Chargement de données par lot Capture des données modifiées	Vous ne pouvez pas utiliser l'API Storage Read ni l'API Storage Write (gRPC) pour accéder à vos données BigQuery.
Dataform	dataform.googleapis.com	Dataform fournit des dépôts de code qui sont exploités par les fonctionnalités suivantes : Pipelines BigQuery Requêtes enregistrées Notebooks Colab Dataform Préparation des données Data Canvas	Vous ne pouvez pas créer de pipelines, de requêtes enregistrées, de notebooks Colab, de canevas de données, de préparations de données ni de projets Dataform. Les pipelines, notebooks ou projets Dataform planifiés existants s'arrêtent. Les pipelines, requêtes enregistrées, notebooks Colab, canevas de données, préparations de données ou projets Dataform existants deviennent inaccessibles.
Knowledge Catalog	dataplex.googleapis.com	Knowledge Catalog fournit des fonctionnalités de catalogage et de gouvernance des données utilisées par les éléments suivants : Explorateur de ressources dans BigQuery Studio Saisie semi-automatique dans l'éditeur SQL de BigQuery Studio Rechercher des fiches BigQuery Sharing (anciennement Analytics Hub) Statistiques du profil Analyses de la qualité des données Traçabilité des données Insights sur les tables et les ensembles de données Data Canvas	La recherche d'éléments de données BigQuery n'est pas disponible. La recherche de fiches de partage n'est pas disponible. Vous ne pouvez pas créer d'insights de profil, d'analyses de la qualité des données ni de suggestions de requêtes, ni accéder à ceux que vous avez créés précédemment. Vous ne pouvez pas afficher les détails d'un élément de données sur un graphique de traçabilité. Vous ne pouvez pas rechercher d'éléments de données dans le canevas de données.

Effet de la désactivation de l'API BigQuery

La désactivation de l'API BigQuery désactive également les services suivants qui en dépendent :

• Autorisation binaire (binaryauthorization.googleapis.com)
• Google Kubernetes Engine (container.googleapis.com)
• Google Cloud API (cloudapis.googleapis.com)
• Dataprep by Trifacta (dataprep.googleapis.com)
• Open Service Broker pour Google Cloud (servicebroker.googleapis.com)
• Telecom Data Fabric (telecomdatafabric.googleapis.com)

Services activés par l'API BigQuery Unified

L'API BigQuery Unified (bigqueryunified.googleapis.com) inclut une collection de services sélectionnés qui sont nécessaires au fonctionnement de diverses fonctionnalités BigQuery. Si vous activez l'API BigQuery Unified, tous ces services sont activés simultanément. Google peut mettre à jour les services de cette collection, et ces services sont automatiquement activés dans les projets pour lesquels cette API est activée. Vous pouvez désactiver des services et des API individuels.

Pour savoir comment activer bigqueryunified.googleapis.com, consultez Activer et désactiver des services.

Service	Nom de l'API	Quelles fonctionnalités en dépendent ?	Conséquences de la désactivation de ce service
Vertex AI	aiplatform.googleapis.com	Notebooks Colab Modèles distants BigQuery ML	Vous ne pourrez pas exécuter vos notebooks. Tous les modèles distants BigQuery ML existants cessent de fonctionner. Vos notebooks existants restent accessibles pour modification.
API BigQuery Unified	bigqueryunified.googleapis.com	Permet d'activer en un clic les services dépendants de BigQuery listés dans ce document, à l'exclusion des API cloudaicompanion, composer et datalineage. S'assure que les nouvelles dépendances BigQuery sont activées dans votre projet.	Les futures dépendances ne sont pas automatiquement activées dans votre projet.
Compute Engine	compute.googleapis.com	Google Compute Engine fournit un environnement d'exécution pour toutes les fonctionnalités fournies par Managed Service pour Apache Spark et Gemini Enterprise Agent Platform.	Les notebooks Colab, les modèles de ML distants, Apache Spark, SparkSQL et les jobs PySpark s'arrêtent. Le code source reste disponible. L'API Dataproc est désactivée.
Managed Service pour Apache Spark	dataproc.googleapis.com	Interrogez des données avec des moteurs Open Source tels qu'Apache Spark. Utilisez Spark SQL ou PySpark avec Managed Service pour Apache Spark. Utilisez des procédures stockées pour Spark.	Vous ne pouvez pas créer de clusters Managed Service pour Apache Spark pour exécuter des analyses de données Open Source. Vous ne pouvez pas exécuter de charges de travail Managed Service pour Apache Spark. Vous ne pouvez pas exécuter de charges de travail Spark dans BigQuery.
Datastream	datastream.googleapis.com	Fournit la capture des données modifiées et la réplication vers BigQuery.	Tous les flux de données sont suspendus et ne sont pas accessibles.

Services désactivés par défaut

Vous devez activer manuellement les services suivants pour que les fonctionnalités correspondantes soient disponibles :

Service	Nom de l'API	Quelles fonctionnalités en dépendent ?	Conséquences de la désactivation de ce service
API Gemini for Google Cloud	cloudaicompanion.googleapis.com	Fonctionnalités de Gemini dans BigQuery	Les fonctionnalités de complétion, de génération et d'explication de code cessent de fonctionner. En savoir plus sur la désactivation de Gemini dans BigQuery
Managed Service pour Apache Airflow	composer.googleapis.com	Planifier des charges de travail	Les DAG Managed Service pour Apache Airflow existants ne sont pas listés sur la page "Planification" et s'arrêtent. Les environnements Managed Airflow existants deviennent inopérants, cessent de fonctionner et renvoient un état d'erreur.
API Data Lineage	datalineage.googleapis.com	Capture et affichage de la traçabilité des données	La traçabilité des données n'est pas capturée pour votre projet. Vous ne pouvez pas afficher le graphique de traçabilité.

Activer manuellement les composants de code BigQuery

Pour gérer les éléments de code dans BigQuery, tels que les notebooks et les requêtes enregistrées, vous devez activer les API suivantes :

• L'API Compute Engine
• API Dataform
• API Vertex AI

Avant mars 2024, ces API n'étaient pas automatiquement activées par défaut. Si vous avez des scripts d'automatisation antérieurs à mars 2024 qui dépendent de l'état de ces API, vous devrez peut-être les mettre à jour. Si ces API sont déjà activées, vous verrez de nouveaux dossiers Notebooks et Requêtes s'afficher dans le volet Explorateur de BigQuery.

Avant de commencer

Pour activer manuellement la gestion des composants de code, vous devez disposer du rôle IAM (Identity and Access Management) Propriétaire (roles/owner).

Activer manuellement les composants de code BigQuery

Pour activer les dépendances d'API requises pour les éléments de code, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans Studio, dans la barre d'onglets du volet de l'éditeur, cliquez sur la flèche vers le bas à côté du signe +, placez le pointeur sur Notebook, puis sélectionnez Notebook vide.

3. Cliquez sur Activer les API.

   Si cette option ne s'affiche pas, vérifiez si vous disposez du rôle IAM Propriétaire (roles/owner) requis. Si un notebook vide s'ouvre, cela signifie que les API nécessaires sont déjà activées.

4. Dans la section API des fonctionnalités principales du volet Activer les fonctionnalités principales, réaliser les opérations suivantes :

   1. Pour activer toutes les dépendances BigQuery pour le streaming de données, la planification et les notebooks, cliquez sur Activer à côté de API BigQuery unifiée.
   2. Facultatif : Pour choisir les API à activer, cliquez sur Afficher et activer des API individuelles, puis sur Activer à côté de chaque API que vous souhaitez activer.
   3. Une fois les API activées, cliquez sur Suivant.

5. Facultatif : définissez les autorisations utilisateur dans la section Autorisations :

   • Pour permettre aux comptes principaux de créer des éléments de code, et de lire, modifier et définir des autorisations sur ces éléments, saisissez leur nom d'utilisateur ou de groupe dans le champ Utilisateur BigQuery Studio.
   • Pour autoriser les comptes principaux à lire, modifier et définir des autorisations pour tous les éléments de code partagés avec eux, saisissez leur nom d'utilisateur ou de groupe dans le champ Administrateur BigQuery Studio.

6. Cliquez sur Suivant.

7. Facultatif : dans la section API supplémentaires, cliquez sur Tout activer pour activer les API dont vous avez besoin pour créer des procédures à distance BigQuery à l'aide de BigQuery DataFrames.

8. Si vous avez choisi de ne pas activer les API supplémentaires, cliquez sur Fermer pour fermer le volet Activer les fonctionnalités essentielles.

Limiter l'accès aux éléments de code

Vous pouvez empêcher l'activation d'API supplémentaires en définissant la contrainte de règle d'administration Restreindre l'utilisation des services de ressources. Vous pouvez désactiver les API sélectionnées à tout moment.

Étape suivante

• Pour savoir comment gérer les services Google Cloud , consultez Activer et désactiver des services.
• Pour savoir comment gérer l'accès aux API de manière précise à l'aide de contraintes de règles d'administration, consultez Restreindre l'utilisation des ressources.
• Pour savoir comment contrôler l'accès aux services avec les rôles et autorisations Identity and Access Management (IAM) pour BigQuery, consultez Rôles et autorisations IAM BigQuery.