Utiliser l'extension Trusted Cloud pour Visual Studio Code

L'extension Trusted Cloud by S3NS Visual Studio Code (VS Code) vous permet d'effectuer les opérations suivantes dans VS Code :

  • Développer et exécuter des notebooks BigQuery.
  • Parcourir, inspecter et prévisualiser les ensembles de données BigQuery

Avant de commencer

  1. Dans votre terminal local, vérifiez que Python 3.11 ou une version ultérieure est installée sur votre système :

    python3 --version

  2. Installez la Google Cloud CLI.

  3. Dans votre terminal local, initialisez gcloud CLI :

    gcloud init

  4. Configurez un projet par défaut :

    gcloud config set project PROJECT_ID

    Remplacez PROJECT_ID par votre projet par défaut.

  5. Configurez les identifiants par défaut de l'application :

    gcloud auth application-default login

  6. Téléchargez et installez VS Code.

  7. Ouvrez VS Code, puis dans la barre d'activité, cliquez sur Extensions.

  8. Dans la barre de recherche, recherchez l'extension Jupyter, puis cliquez sur Install (Installer). Les fonctionnalités BigQuery de VS Code nécessitent l'extension Jupyter de Microsoft comme dépendance.

    Liste des extensions Jupyter dans la console VS Code.

Installer l'extension Trusted Cloud

  1. Ouvrez VS Code, puis dans la barre d'activité, cliquez sur Extensions.

  2. Dans la barre de recherche, recherchez l'extension Google Cloud Code, puis cliquez sur Installer.

    Extension Google Cloud Code dans la console VS Code.

  3. Si vous y êtes invité, redémarrez VS Code.

L'icône Google Cloud Code est désormais visible dans la barre d'activité.

Configurer l'extension

  1. Ouvrez VS Code, puis cliquez sur Google Cloud Code dans la barre d'activité.
  2. Ouvrez la section Notebooks BigQuery.
  3. Cliquez sur Se connecter à Google Cloud. Vous êtes redirigé pour vous connecter avec vos identifiants.
  4. Utilisez la barre des tâches de niveau supérieur de l'application pour accéder à Code > Paramètres > Paramètres > Extensions.
  5. Recherchez Google Cloud Code, puis cliquez sur l'icône Gérer pour ouvrir le menu.
  6. Sélectionnez Paramètres.
  7. Pour le paramètre Cloud Code : Projet, saisissez le nom du projetTrusted Cloud que vous souhaitez utiliser pour exécuter des notebooks et afficher des ensembles de données BigQuery.
  8. Pour le paramètre Cloud Code > Bêta : Région BigQuery, saisissez un emplacement BigQuery. L'extension affiche les ensembles de données de cet emplacement.

Développer des notebooks BigQuery

  1. Ouvrez VS Code, puis cliquez sur Google Cloud Code dans la barre d'activité.
  2. Ouvrez la section Notebooks BigQuery, puis cliquez sur Notebook BigQuery. Un fichier .ipynb contenant un exemple de code est créé et ouvert dans l'éditeur.

  3. Dans le nouveau notebook, cliquez sur Sélectionner le noyau, puis sélectionnez un noyau Python. Les notebooks BigQuery nécessitent un noyau Python local pour l'exécution. Vous pouvez créer un environnement virtuel ou en utiliser un existant.

    Interface de sélection du noyau dans la console VS Code.

  4. Si elle n'a pas encore été installée dans votre environnement virtuel, installez la bibliothèque cliente bigframes :

    1. Ouvrez la fenêtre Terminal.
    2. Exécutez la commande pip install bigframes.

Vous pouvez désormais écrire et exécuter du code dans votre notebook BigQuery.

Explorer et prévisualiser les ensembles de données BigQuery

  1. Ouvrez VS Code, puis cliquez sur Google Cloud Code dans la barre d'activité.
  2. Pour afficher les ensembles de données et les tables du projet et de la région que vous avez spécifiés, ouvrez la section Ensembles de données BigQuery. Les ensembles de données publics BigQuery sont également visibles.
  3. Pour ouvrir un nouvel onglet dans l'éditeur, cliquez sur le nom d'un tableau. Cet onglet contient les détails, le schéma et l'aperçu de la table.

Tarifs

L'extension Visual Studio Code est gratuite, mais les servicesTrusted Cloud (BigQuery, Dataproc, Cloud Storage) que vous utilisez vous sont facturés.

Étapes suivantes