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

Ce document décrit les services et les API dont dépend BigQuery. Trusted Cloud by S3NS Elle 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 projet Trusted Cloud que vous créez. D'autres API sont automatiquement activées pour tous les projets Trusted Cloud qui utilisent BigQuery. Les autres services doivent être activés explicitement pour 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 projetTrusted Cloud  :

Service Quelles fonctionnalités en dépendent ? Conséquences de la désactivation de ce service
analyticshub.googleapis.com
  • 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 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 de nouveaux abonnements
bigqueryconnection.googleapis.com
  • 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
  • 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 : Vous pouvez généralement désactiver ce service une fois la migration des données terminée.

bigquerydatapolicy.googleapis.com
  • Vous ne pouvez pas gérer vos règles de masquage de données.
  • Les règles de masquage des données ne sont pas supprimées, mais les requêtes envoyées aux tables auxquelles le masquage des données est appliqué échouent.
bigqueryreservation.googleapis.com
  • 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
dataform.googleapis.com
  • 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 notebooks, les projets Dataform ou les pipelines planifiés existants s'arrêtent.
  • Tous les pipelines, requêtes enregistrées, notebooks Colab, canevas de données, préparations de données ou projets Dataform existants deviennent inaccessibles.
dataplex.googleapis.com
  • 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, ni accéder à ceux qui ont été créés précédemment.
  • Vous ne pouvez pas afficher les détails des composants 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.

Effet de la désactivation de l'API BigQuery

Si vous désactivez l'API BigQuery, les services suivants, qui en dépendent, seront également désactivés :

  • binaryauthorization.googleapis.com
  • container.googleapis.com
  • cloudapis.googleapis.com
  • dataprep.googleapis.com
  • servicebroker.googleapis.com
  • 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 Quelles fonctionnalités en dépendent ? Conséquences de la désactivation de ce service
aiplatform.googleapis.com
  • Vous ne pourrez pas exécuter vos notebooks.
  • Les modèles distants BigQuery ML existants cessent de fonctionner.
  • Vos notebooks existants restent accessibles et modifiables.
bigqueryunified.googleapis.com
  • Permet d'activer en un clic les services dépendants de BigQuery listés dans ce document, à l'exception des API cloudaicompanion, composer et datalineage.
  • Garantit 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 et 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
  • 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
  • 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
composer.googleapis.com
  • 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
  • La traçabilité des données n'est pas capturée pour votre projet.
  • Vous ne pouvez pas afficher le graphique de lignée.

Activer manuellement les composants de code BigQuery

Pour gérer les composants 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 activées automatiquement 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, de nouveaux dossiers Notebooks et Requêtes s'affichent 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 composants 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 de menu déroulant  à côté du signe +, pointez sur Notebook, puis sélectionnez Modèle BigQuery.

  3. 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.

  4. 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 composants 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.
  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 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.
  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.

Restreindre l'accès aux composants 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