Erweiterung installieren

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

Hinweis

Bevor Sie die Data Agent Kit-Erweiterung für VS Code installieren, führen Sie die folgenden Schritte aus.

VS Code und Python installieren

Installieren Sie Visual Studio Code und Python auf Ihrem lokalen Computer.

  1. Installieren und richten Sie Visual Studio Code ein. Wenn Sie es bereits installiert haben, aktualisieren Sie es auf die neueste Version.
  2. Installieren Sie Python.

Einrichtung von Google Cloud

  1. Erstellen Sie ein Projekt Google Cloud , falls Sie noch keines haben.
  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 VS Code.
  2. Wenn Sie die gcloud CLI noch nicht installiert haben, folgen Sie den Schritten unter gcloud CLI installieren, um sie 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 VS Code 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 VS Code 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 VS Code 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