Instalar a extensão

Com a extensão do Google Cloud Data Agent Kit para Visual Studio Code, é possível trabalhar com seus recursos de dados do Google Cloud no ambiente de desenvolvimento integrado (IDE) de sua preferência.

Antes de começar

Antes de instalar a extensão Data Agent Kit para VS Code, faça o seguinte:

Instalar o VS Code e o Python

Na sua máquina local, instale o Visual Studio Code e o Python.

  1. Instale e configure o Visual Studio Code. Se você já instalou, atualize para a versão mais recente.
  2. Instale o Python.

Configurar Google Cloud

  1. Se você ainda não tiver um, crie um projeto. Google Cloud
  2. Ative 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 credenciais padrão do aplicativo (ADC).

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

  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 as credenciais padrão do aplicativo:

    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 VS Code, 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 Revisar papéis necessários.

Dependendo do seu caso de uso, talvez você precise de outras funções, mas essas 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 VS Code, clique em Extensões ou pressione Ctrl/Cmd+Shift+X.
  2. Pesquisar por Google Cloud Data Agent Kit.
  3. Clique em Install (Instalar).
  4. Se solicitado, reinicie o VS Code. 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, autentique 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.

    Outra opção é pressionar Ctrl/Cmd+Shift+P para abrir a paleta de comandos, pesquisar e selecionar Kit do agente de dados do Google Cloud: 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 IDE.

Ativar APIs

Depois de fazer login na sua Conta do Google, você precisa ativar as APIs no seu projetoGoogle Cloud para todos os serviços que usa nos seus fluxos de trabalho de ciência 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 Kit do agente de dados do Google Cloud.
  2. Abra 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 faça login novamente. Para encontrar outros métodos de diagnóstico e resolução de erros de instalação, consulte Solução de problemas da extensão do Data Agent Kit para VS Code.

A seguir