Instalar a extensão

A extensão do Google Cloud Data Agent Kit para Antigravity permite trabalhar com seus Google Cloud recursos de dados no seu ambiente de desenvolvimento integrado preferido.

Antes de começar

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

Instalar o Antigravity e o Python

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

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

Configurar a forma de pagamento Google Cloud

Se você ainda não tiver um, crie um Google Cloud projeto.
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).

Abra o terminal na máquina local ou no Antigravity.
Se você ainda não tiver instalado a CLI gcloud, siga as etapas em Instalar a CLI gcloud para fazer o download e a instalação.
No terminal, execute gcloud init para inicializar a CLI gcloud:
```
gcloud init
```
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
```
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 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ários outros papéis, mas esses 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