Use a extensão Trusted Cloud para Visual Studio Code

A extensão Trusted Cloud by S3NS Visual Studio Code (VS Code) permite fazer o seguinte no VS Code:

  • Desenvolver e executar notebooks do BigQuery.
  • Navegue, inspecione e visualize conjuntos de dados do BigQuery.

Antes de começar

  1. No seu terminal local, verifique se você tem o Python 3.11 ou mais recente instalado no seu 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 Extensões.

  8. Na 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 uma dependência.

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

Instalar a extensão Trusted Cloud

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

  2. Na 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 do 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 superior do aplicativo para acessar 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 Configurações.
  7. Na configuração Cloud Code: Projeto, insira o nome do projetoTrusted Cloud que você quer usar para executar notebooks e mostrar conjuntos de dados do BigQuery.
  8. Na configuração Cloud Code > Beta: região do BigQuery, 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 um exemplo de código é 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 existentes.

    A interface de seleção de kernel 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 é possível escrever e executar código no 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 ver 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 prévia da tabela.

Preços

A extensão do Visual Studio Code é gratuita, mas há cobranças pelos serviçosTrusted Cloud (BigQuery, Dataproc, Cloud Storage) que você usa.

A seguir