Usar a Google Cloud extensão do Visual Studio Code

A Google Cloud extensão do Visual Studio Code (VS Code) permite fazer o seguinte no VS Code:

  • Desenvolver e executar notebooks do BigQuery.
  • Navegar, inspecionar e visualizar conjuntos de dados do BigQuery.

Antes de começar

  1. No seu terminal local, verifique se o Python 3.11 ou mais recente está instalado no sistema:

    python3 --version

  2. Instale a Google Cloud CLI.

  3. No seu terminal local, inicialize a CLI gcloud:

    gcloud init

  4. Configure um projeto padrão:

    gcloud config set project PROJECT_ID

    Substitua PROJECT_ID pelo projeto padrão.

  5. Configure as Application Default Credentials:

    gcloud auth application-default login

  6. Faça o download e instale o VS Code.

  7. Abra o VS Code e, na barra de atividades, clique em Extensões.

  8. Usando a barra de pesquisa, encontre a extensão Jupyter e clique em Instalar. Os recursos do BigQuery no VS Code exigem a extensão Jupyter da Microsoft como dependência.

    Uma lista de extensões do Jupyter no console do VS Code.

Instalar a Google Cloud extensão

  1. Abra o VS Code e, na barra de atividades, clique em Extensões.

  2. Usando a barra de pesquisa, encontre a extensão Google Cloud Code e clique em Instalar.

    A extensão do Google Cloud Code no console do VS Code.

  3. Se solicitado, reinicie o VS Code.

O ícone Google Cloud Code agora está visível na barra de atividades.

Configurar a extensão

  1. Abra o VS Code e, na barra de atividades, clique em Google Cloud Code.
  2. Abra a seção Notebooks do BigQuery.
  3. Clique em Fazer login no Google Cloud. Você será redirecionado para fazer login com suas credenciais.
  4. Use a barra de tarefas do aplicativo de nível superior para navegar até Código > Configurações > Configurações > Extensões.
  5. Encontre Google Cloud Code e clique no ícone Gerenciar para abrir o menu.
  6. Selecione Configurações.
  7. Para a configuração Cloud Code: Project, insira o nome do Google Cloud projeto que você quer usar para executar notebooks e mostrar conjuntos de dados do BigQuery.
  8. Para a configuração Cloud Code > Beta: BigQuery Region, insira um local do BigQuery. A extensão mostra conjuntos de dados desse local.

Desenvolver notebooks do BigQuery

  1. Abra o VS Code e, na barra de atividades, clique em Google Cloud Code.
  2. Abra a seção Notebooks do BigQuery e clique em Notebook do BigQuery. Um novo arquivo .ipynb contendo um exemplo de código é criado e aberto no editor.

  3. No novo notebook, clique em Selecionar kernel e selecione um kernel do Python. Os notebooks do BigQuery exigem um kernel Python local para execução. Você pode criar um novo ambiente virtual ou usar um dos ambientes atuais.

    A interface de seleção de kernel no console do VS Code.

  4. Se ainda não tiver sido instalada no ambiente virtual, instale a biblioteca de cliente bigframes:

    1. Abra a janela Terminal.
    2. Execute o comando pip install bigframes.

Agora você pode escrever e executar códigos no notebook do BigQuery.

Conhecer e visualizar conjuntos de dados do BigQuery

  1. Abra o VS Code e, na barra de atividades, clique em Google Cloud Code.
  2. Para conferir conjuntos de dados e tabelas do projeto e da região especificados, abra a seção Conjuntos de dados do BigQuery. Os conjuntos de dados públicos do BigQuery também ficam visíveis.
  3. Para abrir uma nova guia no editor, clique em qualquer nome de tabela. Essa guia contém os detalhes, o esquema e a visualização da tabela.

Preços

A extensão do Visual Studio Code é sem custo financeiro, mas você recebe cobranças por todos os Google Cloud serviços (BigQuery, Managed Service for Apache Spark, Cloud Storage) que usa.

A seguir