Use a extensão do Google Cloud para o Visual Studio Code

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

  • Desenvolva e execute notebooks do BigQuery.
  • Navegue, inspecione e visualize conjuntos de dados do BigQuery.

Antes de começar

  1. No terminal local, verifique se você tem o Python 3.11 ou mais recente instalado no sistema:

    python3 --version

  2. Instale a CLI do Google Cloud.

  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 Extensions.

  8. Usando a barra de pesquisa, encontre a extensão Jupyter e clique em Install. 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 extensão Google Cloud

  1. Abra o VS Code e, na barra de atividades, clique em Extensions.

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

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

  3. Se solicitado, reinicie o VS Code.

O ícone do Google Cloud Code agora aparece 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 o Google Cloud Code e clique no ícone Gerenciar para abrir o menu.
  6. Selecione Settings.
  7. Na configuração Cloud Code: Project, insira o nome do projeto doGoogle Cloud que você quer usar para executar notebooks e mostrar conjuntos de dados do BigQuery.
  8. Na 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 com o código de exemplo é criado e aberto no editor.

  3. No novo notebook, clique em Selecionar kernel e escolha 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 já existentes.

    Interface do kernel selecionado no console do VS Code.

  4. Se ela ainda não tiver sido instalada no seu 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ódigo no seu notebook do BigQuery.

Analisar 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 os conjuntos de dados e as 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 são visíveis.
  3. Para abrir uma nova guia no editor, clique em qualquer nome de tabela. Essa guia contém os detalhes da tabela, o esquema e a visualização.

Preços

A extensão do Visual Studio Code é gratuita, mas você vai receber cobranças pelos serviços doGoogle Cloud (BigQuery, Dataproc e Cloud Storage) que usar.

A seguir