Installare l'estensione

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

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 alla versione più recente.
  2. Installa Python.

Configura Google Cloud

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

Installare gcloud CLI

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

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

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

    gcloud init

  4. Esegui il comando seguente e segui le istruzioni per autenticare e configurare le credenziali predefinite dell'applicazione:

    gcloud auth login && gcloud auth application-default login

  5. Aggiorna gcloud CLI alla versione più recente:

    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 Identity and Access Management (IAM) sul progetto. Per saperne di più, consulta Esaminare i ruoli obbligatori.

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)
  • Dataproc Editor (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 l'estensione, l'icona Google Cloud Data Agent Kit viene aggiunta alla barra delle attività.

Accedere a Google Cloud Data Agent Kit

Dopodiché, 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 di 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 su di esso.

    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.

Abilitare le API

Dopo aver eseguito l'accesso al tuo Account Google, devi abilitare le API nel tuo Google Cloud progetto per tutti i servizi che utilizzi per i 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 Comune.
  4. Fai clic su API richieste.

API da abilitare

  • API AlloyDB
  • API BigLake
  • API BigQuery
  • API Composer
  • API Cloud Dataplex
  • API Resource Manager
  • API Cloud Spanner
  • Cloud SQL
  • API Cloud SQL Admin
  • API Storage Cloud
  • 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 e poi ad accedere di nuovo. Per trovare altri metodi per diagnosticare e risolvere gli errori di installazione, consulta Risoluzione dei problemi.

Passaggi successivi