Installer l'extension

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

Avant de commencer

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

Installer Antigravity et Python

Sur votre ordinateur local, installez Antigravity et Python.

  1. Installez et configurez Antigravity sur votre machine, ou mettez-le à jour vers la version 1.21.5 ou ultérieure.
  2. Installez Python.

Configurer Google Cloud

  1. Si ce n'est pas déjà fait, créez un projet Google Cloud .
  2. Activez la facturation.

Installer gcloud CLI

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

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

  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 Antigravity, demandez à votre administrateur de vous accorder les rôles IAM (Identity and Access Management) suivants sur le projet. Pour en savoir plus, consultez 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)
  • BigQuery Job user (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, aux 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 Antigravity, 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 Antigravity. Une fois l'extension correctement installée, l'icône Google Cloud Data Agent Kit est ajoutée à la barre d'activité.

Se connecter à Google Cloud Data Agent Kit

Ensuite, vous devez vous authentifier auprès de Google Cloud Data Agent Kit à l'aide du même compte que celui 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 (Kit d'agent de données Google Cloud : se connecter).

  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 connecté à votre compte Google, vous devez activer les API dans votre projetGoogle Cloud 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 :

  1. Dans la barre d'activité, cliquez sur l'icône Google Cloud Data Agent Kit.
  2. Développez Paramètres, puis cliquez sur Paramètres.
  3. Sélectionnez Common (Commun).
  4. Cliquez sur 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 la gcloud CLI, puis de vous reconnecter. Pour découvrir d'autres méthodes de diagnostic et de résolution des erreurs d'installation, consultez Résoudre les problèmes liés à l'extension Data Agent Kit pour Antigravity.

Étapes suivantes