Instalar a extensão

A extensão do Google Cloud Data Agent Kit permite trabalhar com seus Google Cloud recursos de dados no ambiente de desenvolvimento integrado (IDE) preferido.

Para instalar o plug-in do Data Agent Kit em vez da extensão do IDE ou além dela, consulte Instalar o plug-in do agente de codificação.

Antes de começar

Antes de instalar o Data Agent Kit, faça o seguinte.

Instalar o IDE e o Python

Na máquina local, instale o IDE e o Python.

  1. Instale e configure o IDE. Se ele já estiver instalado, atualize para a versão mais recente.
  2. Instale o Python.

Configurar a forma de pagamento Google Cloud

  1. Crie umprojeto Google Cloud se você ainda não tiver um.
  2. Ativar o faturamento.

Instalar a CLI gcloud

É necessário instalar e fazer login na Google Cloud CLI. A extensão usa credenciais da CLI gcloud e do Application Default Credentials (ADC).

  1. Abra o terminal na máquina local ou no IDE.
  2. Se você ainda não instalou a CLI gcloud, siga as etapas em Instalar a CLI gcloud para fazer o download e a instalação.

  3. No terminal, execute gcloud init para inicializar a CLI gcloud:

    gcloud init

  4. Execute o comando a seguir e siga as instruções para autenticar e configurar o Application Default Credentials:

    gcloud auth login && gcloud auth application-default login

  5. Atualize a CLI gcloud para a versão mais recente:

    gcloud components update

Funções exigidas

Para receber as permissões necessárias para usar o Data Agent Kit, peça ao administrador para conceder a você os seguintes papéis do Identity and Access Management (IAM) no projeto. Para mais informações, consulte Analisar as funções necessárias.

Dependendo do seu caso de uso, talvez sejam necessárias outras funções, mas esses papéis permitem instalar e configurar a extensão. A lista completa está disponível nas configurações da extensão do IDE.

  • Leitor de dados do BigQuery (roles/bigquery.dataViewer)
  • Usuário de jobs do BigQuery (roles/bigquery.jobUser)
  • Leitor de metadados do BigQuery (roles/bigquery.metadataViewer)
  • Usuário de sessão de leitura do BigQuery (roles/bigquery.readSessionUser)
  • Editor do Dataproc (roles/dataproc.editor)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Os papéis predefinidos contêm as permissões necessárias para usar a extensão. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

  • 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

Instalar a extensão

  1. No IDE, clique em Extensões ou pressione Ctrl/Cmd+Shift+X.
  2. Pesquisar por Google Cloud Data Agent Kit.
  3. Clique em Instalar.
  4. Se solicitado, reinicie o IDE. Depois que a extensão for instalada com sucesso, o ícone do Google Cloud Data Agent Kit será adicionado à barra de atividades.

Fazer login no Data Agent Kit do Google Cloud

Em seguida, autentique-se no Google Cloud Data Agent Kit usando a mesma conta que você usou para fazer login na CLI gcloud.

  1. Se a caixa de diálogo Fazer login não abrir automaticamente, procure um link de login do Google Cloud Data Agent Kit na barra de status perto da parte de baixo da janela do IDE e clique nele.

    Como alternativa, pressione Ctrl/Cmd+Shift+P para abrir a paleta de comandos, pesquise e selecione Google Cloud Data Agent Kit: fazer login.

  2. Siga as instruções e conclua o login.

    Uma página da Web confirmando que a autenticação foi concluída é exibida.

  3. Feche a página e retorne ao IDE.

Ativar APIs

Depois de fazer login na sua Conta do Google, é necessário ativar as APIs no seu Google Cloud projeto para todos os serviços usados nos seus fluxos de trabalho de ciência de dados ou engenharia de dados.

Para conferir a lista de APIs e as que já estão ativadas, faça o seguinte:

  1. Na barra de atividades, clique no ícone do Google Cloud Data Agent Kit.
  2. Expanda Configurações e clique em Configurações.
  3. Selecione Comum.
  4. Clique em APIs necessárias.

APIs a serem ativadas

  • 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

Resolver problemas

Se você tiver problemas, tente sair do Google Cloud Data Agent Kit e da CLI gcloud e fazer login novamente. Para encontrar outros métodos de diagnóstico e resolução de erros de instalação, consulte Solução de problemas.

A seguir