Erweiterung installieren

Mit der Google Cloud Data Agent Kit-Erweiterung für Antigravity können Sie mit Ihren Google Cloud Datenressourcen in Ihrer bevorzugten IDE arbeiten.

Hinweis

Führen Sie vor der Installation der Data Agent Kit-Erweiterung für Antigravity die folgenden Schritte aus.

Antigravity und Python installieren

Installieren Sie Antigravity und Python auf Ihrem lokalen Computer.

  1. Installieren und richten Sie Antigravity auf Ihrem Computer ein oder aktualisieren Sie es auf Version 1.21.5 oder höher.
  2. Installieren Sie Python.

Einrichtung von Google Cloud

  1. Falls Sie noch kein Projekt haben, erstellen Sie ein Google Cloud Projekt.
  2. Abrechnung aktivieren.

gcloud CLI installieren

Sie müssen die Google Cloud CLI installieren und sich darin anmelden. Die Erweiterung verwendet Anmeldedaten aus der gcloud CLI und Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC).

  1. Öffnen Sie das Terminal auf Ihrem lokalen Computer oder in Antigravity.
  2. Wenn Sie die gcloud CLI noch nicht installiert haben, folgen Sie der Anleitung unter gcloud CLI installieren, um die gcloud CLI herunterzuladen und zu installieren.

  3. Führen Sie im Terminal gcloud init aus, um die gcloud CLI zu initialisieren:

    gcloud init

  4. Führen Sie den folgenden Befehl aus und folgen Sie der Anleitung, um sich zu authentifizieren und Standardanmeldedaten für Anwendungen einzurichten:

    gcloud auth login && gcloud auth application-default login

  5. Aktualisieren Sie die gcloud CLI auf die neueste Version:

    gcloud components update

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen (Identity and Access Management) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zur Verwendung der Data Agent Kit-Erweiterung für Antigravity benötigen. Weitere Informationen finden Sie unter Erforderliche Rollen prüfen.

Je nach Anwendungsfall benötigen Sie möglicherweise zusätzliche Rollen. Mit diesen Rollen können Sie die Erweiterung jedoch installieren und einrichten. Die vollständige Liste finden Sie in den Einstellungen der IDE-Erweiterung.

  • BigQuery Datenbetrachter (roles/bigquery.dataViewer)
  • BigQuery-Jobnutzer (roles/bigquery.jobUser)
  • BigQuery Metadatenbetrachter (roles/bigquery.metadataViewer)
  • BigQuery Read Session-Nutzer (roles/bigquery.readSessionUser)
  • Dataproc-Bearbeiter (roles/dataproc.editor)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Die vordefinierten Rollen enthalten die Berechtigungen, die zur Verwendung der Erweiterung erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

  • 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

Erweiterung installieren

  1. Klicken Sie in Antigravity auf Erweiterungen oder drücken Sie Ctrl/Cmd+Shift+X.
  2. Suchen Sie nach Google Cloud Data Agent Kit.
  3. Klicken Sie auf Installieren.
  4. Starten Sie Antigravity neu, wenn Sie dazu aufgefordert werden. Nachdem die Erweiterung installiert wurde, wird das Google Cloud Data Agent Kit-Symbol der Aktivitätsleiste hinzugefügt.

In Google Cloud Data Agent Kit anmelden

Als Nächstes müssen Sie sich mit demselben Konto bei Google Cloud Data Agent Kit authentifizieren, mit dem Sie sich in der gcloud CLI angemeldet haben.

  1. Wenn sich das Dialogfeld Anmelden nicht automatisch öffnet, suchen Sie in der Statusleiste unten im IDE-Fenster nach einem Anmeldelink für Google Cloud Data Agent Kit und klicken Sie darauf.

    Alternativ können Sie Ctrl/Cmd+Shift+P drücken, um die Befehlspalette zu öffnen, und dann nach Google Cloud Data Agent Kit: Anmelden suchen und diese Option auswählen.

  2. Folgen Sie der Anleitung, um sich anzumelden.

    Eine Webseite bestätigt, dass die Authentifizierung abgeschlossen ist.

  3. Schließen Sie die Seite und kehren Sie zur IDE zurück.

APIs aktivieren

Nachdem Sie sich in Ihrem Google-Konto angemeldet haben, müssen Sie die APIs in Ihrem Google Cloud Projekt für alle Dienste aktivieren, die Sie für Ihre Data Science- oder Data Engineering-Workflows verwenden.

So rufen Sie die Liste der APIs auf und sehen, welche bereits aktiviert sind:

  1. Klicken Sie in der Aktivitätsleiste auf das Symbol Google Cloud Data Agent Kit.
  2. Erweitern Sie Einstellungen und klicken Sie dann auf Einstellungen.
  3. Wählen Sie Allgemein aus.
  4. Klicken Sie auf Erforderliche APIs.

Zu aktivierende APIs

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

Fehlerbehebung

Wenn Probleme auftreten, melden Sie sich von Google Cloud Data Agent Kit und der gcloud CLI ab und dann wieder an. Weitere Methoden zur Diagnose und Behebung von Installationsfehlern finden Sie unter Fehlerbehebung.

Nächste Schritte