Activer la gestion des composants de code

Vous pouvez enregistrer, partager et gérer les versions des composants de code (notebooks et requêtes enregistrées, par exemple). Ce document explique comment activer manuellement des composants de code, définir la région par défaut et accorder l'accès à d'autres utilisateurs.

Activation automatique des API BigQuery

Les API suivantes sont automatiquement activées pour tous les projets Google Cloud utilisant BigQuery :

Avant mars 2024, ces API n'étaient pas activées automatiquement. 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.

Ces API n'entraînent aucun coût supplémentaire. Les utilisateurs disposant d'autorisations Identity and Access Management pour utiliser les services activés sur les ressources correspondantes peuvent faire l'objet de frais, comme décrit dans la page Tarifs de BigQuery, sur la page Tarifs de Dataform, et les tarifs de Dataplex.

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.

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

Vous pouvez activer manuellement la gestion des composants de code BigQuery en activant les API suivantes :

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

Pour activer les éléments de code, procédez comme suit :

  1. Accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans la barre d'onglets du volet de l'éditeur, cliquez sur la flèche vers le bas à côté du signe +, puis sur Créer un notebook Python.

  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 éléments de code, sous 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 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 Propriétaire.
  6. Cliquez sur Suivant.

  7. Facultatif : cliquez sur Tout activer dans la section API supplémentaires 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.

Définir la région par défaut des composants de code

Tous les composants de code utilisent la même région par défaut. Pour définir la région par défaut des éléments de code, procédez comme suit :

  1. Accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le volet Explorateur, recherchez le projet dans lequel vous avez activé des éléments de code.

  3. Cliquez sur Afficher les actions à côté du projet, puis sur Modifier la région du code par défaut.

  4. Dans Région, sélectionnez la région que vous souhaitez utiliser pour les éléments de code.

  5. Cliquez sur Sélectionner.

Accorder l'accès à d'autres utilisateurs

Une fois que vous avez activé la gestion des composants de code, vous pouvez autoriser d'autres utilisateurs à accéder aux composants de code en leur attribuant les rôles Identity and Access Management appropriés. Pour en savoir plus, consultez les sections Accorder l'accès aux notebooks et Accorder l'accès aux requêtes enregistrées.

Étapes suivantes