Installare l'estensione

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

Per installare il plug-in Data Agent Kit anziché o in aggiunta all'estensione IDE, consulta Installare il plug-in dell'agente di codifica.

Prima di iniziare

Prima di installare Data Agent Kit:

Installa l'IDE e Python

Installa l'IDE e Python sulla tua macchina locale.

  1. Installa e configura l'IDE. Se è 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.

Installa gcloud CLI

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

  1. Apri il terminale sulla tua macchina locale o nell'IDE.
  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 Data Agent Kit, chiedi all'amministratore di concederti i seguenti ruoli Identity and Access Management (IAM) nel 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 Gestire 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. Nell'IDE, 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 l'IDE. Una volta installata correttamente 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 Accedi 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 dell'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: Accedi.

  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:

  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 Cloud Composer
  • API Cloud Dataplex
  • API Cloud 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