Installare l'estensione

L'estensione Google Cloud Data Agent Kit per Visual Studio Code ti consente di lavorare con le tue risorse di dati Google Cloud nel tuo IDE preferito.

Prima di iniziare

Prima di installare l'estensione Data Agent Kit per VS Code, procedi nel seguente modo.

Installare VS Code e Python

Sulla tua macchina locale, installa Visual Studio Code e Python.

  1. Installa e configura Visual Studio Code. Se l'hai già installato, aggiornalo all'ultima versione.
  2. Installa Python.

Configura Google Cloud

  1. Se non ne hai già uno, crea un Google Cloud progetto.
  2. Abilita fatturazione.

Installa gcloud CLI

Devi installare Google Cloud CLI e accedere. L'estensione utilizza le credenziali sia di gcloud CLI sia delle credenziali predefinite dell'applicazione (ADC).

  1. Apri il terminale sulla macchina locale o in VS Code.
  2. Se non hai mai installato gcloud CLI, segui i passaggi descritti in Installa gcloud CLI per scaricare e installare gcloud CLI.

  3. Nel terminale, esegui gcloud init per inizializzare gcloud CLI:

    gcloud init

  4. Esegui questo comando e segui le istruzioni per autenticarti e configurare le credenziali predefinite dell'applicazione:

    gcloud auth login && gcloud auth application-default login

  5. Aggiorna gcloud CLI all'ultima versione:

    gcloud components update

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per utilizzare l'estensione Data Agent Kit per VS Code, chiedi all'amministratore di concederti i seguenti ruoli IAM (Identity and Access Management) sul progetto. Per saperne di più, consulta Ruoli richiesti per la revisione.

A seconda del tuo caso d'uso, potresti aver bisogno di ruoli aggiuntivi, ma questi ruoli ti consentono di installare e configurare l'estensione. L'elenco completo è disponibile nelle impostazioni dell'estensione IDE.

  • Visualizzatore dati BigQuery (roles/bigquery.dataViewer)
  • Utente job BigQuery (roles/bigquery.jobUser)
  • Visualizzatore metadati BigQuery (roles/bigquery.metadataViewer)
  • BigQuery Read Session User (roles/bigquery.readSessionUser)
  • Editor Dataproc (roles/dataproc.editor)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

I ruoli predefiniti contengono le autorizzazioni necessarie per utilizzare l'estensione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

  • 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

Installare l'estensione

  1. In VS Code, fai clic su Estensioni o premi Ctrl/Cmd+Shift+X.
  2. Cerca Google Cloud Data Agent Kit.
  3. Fai clic su Installa.
  4. Se richiesto, riavvia VS Code. Una volta installata correttamente l'estensione, l'icona di Google Cloud Data Agent Kit viene aggiunta alla barra delle attività.

Accedi a Google Cloud Data Agent Kit

Successivamente, devi autenticarti in Google Cloud Data Agent Kit utilizzando lo stesso account che hai utilizzato per accedere a gcloud CLI.

  1. Se la finestra di dialogo accesso non si apre automaticamente, cerca un link di accesso a Google Cloud Data Agent Kit nella barra di stato vicino alla parte inferiore della finestra IDE e fai clic sul link.

    In alternativa, puoi premere Ctrl/Cmd+Shift+P per aprire la tavolozza dei comandi, cercare e selezionare Google Cloud Data Agent Kit: Sign in.

  2. Segui le istruzioni e completa l'accesso.

    Viene visualizzata una pagina web che conferma che l'autenticazione è stata completata.

  3. Chiudi la pagina e torna all'IDE.

Abilita API

Dopo aver eseguito l'accesso al tuo Account Google, devi attivare le API nel tuo progettoGoogle Cloud per tutti i servizi che utilizzi per i tuoi flussi di lavoro di data science o data engineering.

Per visualizzare l'elenco delle API e quelle già abilitate, procedi nel seguente modo:

  1. Nella barra delle attività, fai clic sull'icona Google Cloud Data Agent Kit.
  2. Espandi Impostazioni e poi fai clic su Impostazioni.
  3. Seleziona Comuni.
  4. Fai clic su API richieste.

API da abilitare

  • 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

Risoluzione dei problemi

Se riscontri problemi, prova a uscire da Google Cloud Data Agent Kit e da gcloud CLI, quindi accedi di nuovo. Per trovare altri metodi per diagnosticare e risolvere gli errori di installazione, consulta Risolvere i problemi relativi all'estensione Data Agent Kit per VS Code.

Passaggi successivi