Instalar a extensão

A extensão do Google Cloud Data Agent Kit para o IDE do Antigravity permite trabalhar com seus Google Cloud recursos de dados no ambiente de desenvolvimento integrado de sua preferência.

Antes de começar

Antes de instalar a extensão do Data Agent Kit para o IDE do Antigravity, faça o seguinte.

Instalar o IDE do Antigravity e o Python

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

  1. Instale e configure o Antigravity na sua máquina ou atualize para a versão 1.21.5 ou mais recente.
  2. Instale o Python.

Configure 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 do Antigravity.
  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 a extensão do Data Agent Kit para o IDE do Antigravity, peça ao administrador para conceder a você os seguintes papéis de 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 ambiente de desenvolvimento integrado.

  • 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 do Antigravity, clique em Extensões ou pressione Ctrl/Cmd+Shift+X.
  2. Pesquise Google Cloud Data Agent Kit.
  3. Clique em Instalar.
  4. Se solicitado, reinicie o IDE do Antigravity. Depois que a extensão for instalada, o ícone do Google Cloud Data Agent Kit será adicionado à barra de atividades.

Fazer login no Google Cloud Data Agent Kit

Em seguida, é necessário autenticar o 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 ambiente de desenvolvimento integrado 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 volte ao ambiente de desenvolvimento integrado.

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