Erweiterung installieren

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

Hinweis

Bevor Sie die Data Agent Kit-Erweiterung für Antigravity installieren, führen Sie 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 anmelden. Die Erweiterung verwendet Anmeldedaten sowohl aus der gcloud CLI als auch aus den 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 ist in den Einstellungen der IDE-Erweiterung verfügbar.

  • 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 verwalten.

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

Die vordefinierten Rollen enthalten die Berechtigungen, die für die 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. Nach erfolgreicher Installation der Erweiterung wird das Symbol für das Google Cloud Data Agent Kit in der Aktivitätsleiste angezeigt.

Im Google Cloud Data Agent Kit anmelden

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

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

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

  2. Folgen Sie der Anleitung, um die Anmeldung abzuschließen.

    Eine Webseite wird angezeigt, auf der bestätigt wird, 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 IhremGoogle 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. Maximieren Sie die 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 vom 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 bei der Data Agent Kit-Erweiterung für Antigravity.

Nächste Schritte