Cette page a été traduite par l'API Cloud Translation.

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

Ce document décrit les services et les API sur lesquels BigQuery dépend. Google Cloud Il explique également les effets sur le comportement de BigQuery lorsque vous désactivez ces services. Consultez ce document avant d'activer ou de désactiver des services dans votre projet.

Certains services sont activés par défaut dans chaque Google Cloud projet que vous créez. D'autres API sont automatiquement activées pour tous les Google Cloud projets qui utilisent BigQuery. Les services restants doivent être explicitement activés avant que vous puissiez utiliser leurs fonctionnalités. Pour en savoir plus, consultez les ressources suivantes :

Ce document s'adresse aux administrateurs.

Services activés par défaut

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

Service	Quelles fonctionnalités en dépendent ?	Conséquences de la désactivation de ce service
`analyticshub.googleapis.com`	Publier des échanges de données Publier des fiches et gérer les abonnements Data clean rooms	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 places de marché ou les fiches créées par d'autres fournisseurs. Les abonnements créés persistent, 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
`bigqueryconnection.googleapis.com`	Requêtes fédérées sur les données stockées en dehors de BigQuery Tables et ensembles de données externes Métadisque 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.
`bigquerymigration.googleapis.com`	Évaluation de la migration de données Traduction des 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.
`bigquerydatapolicy.googleapis.com`	Masquage des données	Vous ne pouvez pas gérer vos stratégies de masquage de 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.
`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.
`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 pour accéder à vos données BigQuery.
`dataform.googleapis.com`	Dataform fournit des dépôts de code exploités par les fonctionnalités suivantes: Pipelines BigQuery Requêtes enregistrées Notebooks Colab Dataform Préparation des données Canevas de données	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. Tous les pipelines existants, les requêtes enregistrées, les notebooks Colab, les canevas de données, les préparations de données ou les projets Dataform deviennent inaccessibles.
`dataplex.googleapis.com`	Dataplex Universal 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 Recherche de fiches dans BigQuery Sharing (anciennement Analytics Hub) Insights sur le profil Analyses de la qualité des données Affichage de la traçabilité des données Insights sur les tables et les ensembles de données Canevas de données	La recherche d'assets de données BigQuery n'est pas disponible. La recherche de fiches à partager 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 précédemment créés, ni y accéder. Vous ne pouvez pas voir les détails des éléments de données dans un graphique de traçabilité. Vous ne pouvez pas rechercher d'éléments de données dans le canevas de données.

Services activés par l'API BigQuery Unified

L'API BigQuery Unified (bigqueryunified.googleapis.com) inclut une sélection de services requis pour le 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. 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 la section Activer et désactiver des services.

Service	Quelles fonctionnalités en dépendent ?	Conséquences de la désactivation de ce service
`aiplatform.googleapis.com`	Notebooks Colab Modèles distants BigQuery ML	Vous ne pourrez plus exécuter vos notebooks. Tous les modèles distants BigQuery ML existants cessent de fonctionner. Vous pourrez toujours modifier vos notebooks existants.
`bigqueryunified.googleapis.com`	Fournit une activation en un clic des services dépendants de BigQuery listés dans ce document, à l'exception des API cloudaicompanion, composer et datalineage. Assurez-vous 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.googleapis.com`	Google Compute Engine fournit un environnement d'exécution pour toutes les fonctionnalités fournies par Dataproc et Vertex AI.	Les notebooks Colab, les modèles ML à distance, les tâches Apache Spark, SparkSQL et PySpark s'arrêtent. Le code source reste disponible. L'API Dataproc est désactivée.
`dataproc.googleapis.com`	Interrogez des données à l'aide de moteurs Open Source tels qu'Apache Spark. Utilisez Spark SQL ou PySpark avec Dataproc sans serveur. Utilisez des procédures stockées pour Spark.	Vous ne pouvez pas créer de clusters Dataproc pour exécuter des analyses de données Open Source. Vous ne pouvez pas exécuter de charges de travail Dataproc sans serveur. Vous ne pouvez pas exécuter Spark dans les charges de travail BigQuery.
`datastream.googleapis.com`	Fournit la capture et la réplication des données modifiées dans 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	Quelles fonctionnalités en dépendent ?	Conséquences de la désactivation de ce service
`cloudaicompanion.googleapis.com`	Fonctionnalités de Gemini dans BigQuery	Les fonctionnalités de complétion, de génération et d'explication du code ne fonctionnent plus. Découvrez comment désactiver Gemini dans BigQuery.
`composer.googleapis.com`	Planifier des charges de travail	Les DAG Cloud Composer existants ne sont pas listés sur la page "Planification" et s'arrêtent. Les environnements Cloud Composer existants deviennent inopérants, cessent de fonctionner et renvoient un état d'erreur.
`datalineage.googleapis.com`	Capture et visualisation de la traçabilité des données	La lignée des données n'est pas capturée pour votre projet. Vous ne pouvez pas afficher le graphique de la lignée.

Activer manuellement les composants de code BigQuery

Pour gérer des éléments de code dans BigQuery, tels que des notebooks et des 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 vous avez déjà activé ces API, de nouveaux dossiers Notebooks et Requêtes s'affichent dans le volet Explorer 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:

Accédez à la page BigQuery.

Accéder à BigQuery
Dans Studio, dans la barre d'onglets du volet de l'éditeur, cliquez sur la flèche du menu déroulant à côté du signe +, maintenez le pointeur sur Notebook (Notebook), puis sélectionnez BigQuery template (Modèle BigQuery).
Dans la bannière qui s'affiche sous la barre d'onglets du volet de l'éditeur, cliquez sur Activer.

Si la bannière ne s'affiche pas, vérifiez si vous disposez du rôle IAM Propriétaire requis.
Dans la section API des fonctionnalités principales du volet Activer les fonctionnalités, réaliser les opérations suivantes :
1. Pour activer l'historique des versions et le partage des éléments de code, dans la section Historique des versions et partage, cliquez sur Activer.
2. Pour activer les notebooks, sous Notebooks Python, cliquez sur Tout activer.
3. Une fois les API activées, cliquez sur Suivant.
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 Créateur.
- 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 Propriétaire.
Cliquez sur Suivant.
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.
Si vous avez choisi de ne pas activer les API supplémentaires, cliquez sur Fermer pour fermer le volet Activer les fonctionnalités.

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 Google Cloud services, consultez la page Activer et désactiver des services.
Pour savoir comment gérer l'accès aux API de manière précise avec des contraintes de règles d'administration, consultez la section Restreindre l'utilisation des ressources.
Pour découvrir comment contrôler l'accès aux services à Identity and Access Management'aide de rôles et d'autorisations IAM pour BigQuery, consultez la page Rôles et autorisations IAM BigQuery.