Installer l'extension

L'extension Google Cloud Data Agent Kit pour Visual Studio Code vous permet de travailler avec vos Google Cloud ressources de données dans l'IDE de votre choix.

Avant de commencer

Avant d'installer l'extension Data Agent Kit pour VS Code, procédez comme suit.

Installer VS Code et Python

Sur votre machine locale, installez Visual Studio Code et Python.

  1. Installez et configurez Visual Studio Code. Si vous l'avez déjà installé, mettez-le à jour vers la dernière version.
  2. Installez Python.

Configurer Google Cloud

  1. Si vous n'en avez pas déjà un, créez un Google Cloud projet.
  2. Activez la facturation.

Installer gcloud CLI

Vous devez installer et vous connecter à Google Cloud CLI. L'extension utilise les identifiants de gcloud CLI et les identifiants par défaut de l'application (ADC).

  1. Ouvrez le terminal sur votre machine locale ou dans VS Code.
  2. Si vous n'avez pas encore installé gcloud CLI, suivez les étapes décrites dans Installer gcloud CLI pour télécharger et installer gcloud CLI.

  3. Dans le terminal, exécutez gcloud init pour initialiser gcloud CLI :

    gcloud init

  4. Exécutez la commande suivante et suivez les instructions pour vous authentifier et configurer les identifiants par défaut de l'application :

    gcloud auth login && gcloud auth application-default login

  5. Mettez à jour gcloud CLI vers la dernière version :

    gcloud components update

Rôles requis

Pour obtenir les autorisations nécessaires pour utiliser l'extension Data Agent Kit pour VS Code, demandez à votre administrateur de vous accorder les rôles IAM (Identity and Access Management) suivants sur le projet. Pour en savoir plus, consultez Examiner les rôles requis.

Selon votre cas d'utilisation, vous aurez peut-être besoin de rôles supplémentaires, mais ces rôles vous permettent d'installer et de configurer l'extension. La liste complète est disponible dans les paramètres de l'extension IDE.

  • Lecteur de données BigQuery (roles/bigquery.dataViewer)
  • Utilisateur de tâches BigQuery (roles/bigquery.jobUser)
  • Lecteur de métadonnées BigQuery (roles/bigquery.metadataViewer)
  • Utilisateur de sessions de lecture BigQuery (roles/bigquery.readSessionUser)
  • Éditeur Dataproc (roles/dataproc.editor)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Les rôles prédéfinis contiennent les autorisations requises pour utiliser l'extension. Pour afficher les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

  • bigquery.config.get
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.jobs.create
  • bigquery.readsessions.create
  • bigquery.readsessions.getData
  • bigquery.readsessions.update
  • bigquery.tables.createSnapshot
  • bigquery.tables.export
  • bigquery.tables.get
  • bigquery.tables.getIamPolicy
  • bigquery.tables.list
  • bigquery.tables.replicateData
  • dataform.locations.get
  • dataform.locations.list
  • dataform.repositories.create
  • dataform.repositories.list
  • dataplex.projects.search
  • dataproc.clusters.use
  • dataproc.operations.get
  • dataproc.sessions.create
  • dataproc.sessions.delete
  • dataproc.sessions.get
  • dataproc.sessions.list
  • dataproc.sessions.terminate
  • dataproc.sessionTemplates.create
  • dataproc.sessionTemplates.delete
  • dataproc.sessionTemplates.get
  • dataproc.sessionTemplates.list
  • dataproc.sessionTemplates.update
  • resourcemanager.projects.get

Installer l'extension

  1. Dans VS Code, cliquez sur Extensions ou appuyez sur Ctrl/Cmd+Shift+X.
  2. Recherchez Google Cloud Data Agent Kit.
  3. Cliquez sur Installer.
  4. Si vous y êtes invité, redémarrez VS Code. Une fois l'extension installée, l'icône Google Cloud Data Agent Kit est ajoutée à la barre d'activité.

Se connecter à Google Cloud Data Agent Kit

Vous devez ensuite vous authentifier auprès de Google Cloud Data Agent Kit à l'aide du même compte que celui que vous avez utilisé pour vous connecter à gcloud CLI.

  1. Si la boîte de dialogue Se connecter ne s'ouvre pas automatiquement, recherchez un lien de connexion Google Cloud Data Agent Kit dans la barre d'état en bas de la fenêtre de l'IDE, puis cliquez dessus.

    Vous pouvez également appuyer sur Ctrl/Cmd+Shift+P pour ouvrir la palette de commandes, rechercher et sélectionner Google Cloud Data Agent Kit: Sign in.

  2. Suivez les instructions et terminez la connexion.

    Une page Web confirmant que l'authentification est terminée s'affiche.

  3. Fermez la page et revenez à l'IDE.

Activer les API

Une fois que vous êtes connecté à votre compte Google, vous devez activer les API de votre Google Cloud projet pour tous les services que vous utilisez pour vos workflows de science des données ou d'ingénierie des données.

Pour afficher la liste des API et celles qui sont déjà activées, procédez comme suit :

  1. Dans la barre d'activité, cliquez sur l'icône Google Cloud Data Agent Kit.
  2. Développez Settings (Paramètres), puis cliquez sur Settings (Paramètres).
  3. Sélectionnez Common (Commun).
  4. Cliquez sur Required APIs (API requises).

API à activer

  • API AlloyDB
  • API BigLake
  • API BigQuery
  • API Cloud Composer
  • API Cloud Dataplex
  • API Cloud Resource Manager
  • API Cloud Spanner
  • Cloud SQL
  • API Cloud SQL Admin
  • API Cloud Storage
  • API Dataproc
  • API Dataproc Release Manager
  • API Vertex AI

Résoudre les problèmes

Si vous rencontrez des problèmes, essayez de vous déconnecter de Google Cloud Data Agent Kit et de gcloud CLI, puis de vous reconnecter. Pour connaître d'autres méthodes de diagnostic et de résolution des erreurs d'installation, consultez Résoudre les problèmes.

Étape suivante