Criar e usar espaços de trabalho

Este documento mostra como trabalhar com espaços de trabalho no BigQuery, incluindo as seguintes tarefas:

• Como criar espaços de trabalho
• Como excluir espaços de trabalho
• Como trabalhar com arquivos em espaços de trabalho
• Como realizar o controle de versões em arquivos em espaços de trabalho

Antes de começar

Crie um repositório do BigQuery, caso ainda não tenha feito isso.

Funções exigidas

O acesso aos espaços de trabalho é determinado pelas funções concedidas no repositório pai. Para mais informações, consulte Papéis necessários.

Criar um espaço de trabalho

A criação do espaço de trabalho é processada de maneira diferente dependendo se você está usando um repositório do BigQuery ou de terceiros.

Criar um espaço de trabalho em um repositório do BigQuery

Para criar um novo espaço de trabalho em um repositório do BigQuery, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório em que você quer criar um espaço de trabalho.

4. No editor, clique em Adicionar espaço de trabalho.

5. No painel Criar espaço de trabalho, no campo ID do espaço de trabalho, insira um ID exclusivo para o espaço de trabalho.

   Os IDs só podem incluir números, letras, hifens e sublinhados.

6. Clique em Criar.

Criar um espaço de trabalho em um repositório de terceiros

Para criar um novo espaço de trabalho em um repositório de terceiros, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório em que você quer criar um espaço de trabalho.

4. No editor, clique em Adicionar espaço de trabalho. O painel Criar espaço de trabalho será aberto.

5. Escolha o botão de opção Filial remota existente ou Nova filial, dependendo se você quer usar uma filial atual ou nova para o espaço de trabalho.

6. Especifique a ramificação a ser usada:

   1. Se você escolheu o botão de opção Existing remote branch, escolha uma ramificação no campo Remote branch.

   2. Se você escolheu o botão de opção New branch, digite um nome de ramificação no campo Workspace ID. O nome da ramificação criada no repositório de terceiros é o mesmo do ID do espaço de trabalho do BigQuery.

      Os IDs só podem incluir números, letras, hifens e sublinhados.

7. Clique em Criar.

Criar um diretório em um espaço de trabalho

Para criar um diretório em um espaço de trabalho, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório que contém o espaço de trabalho com que você quer trabalhar.

4. No editor, localize o espaço de trabalho e clique em Abrir.

   Isso abre o painel do espaço de trabalho:

   

5. Clique na opção add Adicionar.

6. Clique em Criar no repositório > Diretório.

7. No campo Adicionar um caminho de diretório, digite um caminho de diretório.

8. Clique em Criar diretório.

Trabalhar com arquivos em um espaço de trabalho

Você pode criar novos arquivos em um espaço de trabalho ou fazer upload de arquivos existentes.

É possível criar ou fazer upload dos seguintes tipos de arquivos para um repositório:

• Consultas SQL
• Notebooks Python
• Telas de dados
• Preparação de dados
• Arquivos de qualquer outro tipo

Criar um arquivo

Para criar um arquivo em um espaço de trabalho, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório que contém o espaço de trabalho com que você quer trabalhar.

4. No editor, localize o espaço de trabalho e clique em Abrir.

   Isso abre o painel do espaço de trabalho:

   

5. Escolha uma destas opções:

   • Clique na opção add Adicionar.
   • Selecione um diretório e clique na opção more_vert Ações.

6. Clique em Criar no repositório e selecione o tipo de arquivo que você quer criar.

7. No campo Nome, digite um nome de arquivo.

8. Opcional: no campo Diretório pai, digite o caminho do diretório em que o arquivo será criado.

9. Clique em Salvar.

Faça upload de um arquivo

Para fazer upload de um arquivo em um espaço de trabalho, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório que contém o espaço de trabalho com que você quer trabalhar.

4. No editor, localize o espaço de trabalho e clique em Abrir.

   Isso abre o painel do espaço de trabalho:

   

5. Escolha uma destas opções:

   • Clique na opção add Adicionar.
   • Selecione um diretório e clique na opção more_vert Ações.

6. Clique em Fazer upload no repositório e selecione o tipo de arquivo que você quer enviar.

7. No painel de upload, faça o seguinte:

   • No campo Fazer upload do arquivo, clique em Procurar, selecione um arquivo e clique em Abrir.
   • No campo URL, digite o URL do arquivo.

8. Opcional: no campo Diretório pai, digite o caminho do diretório em que o arquivo será criado.

9. Clique em Fazer upload.

Excluir um arquivo

Para excluir um arquivo de um espaço de trabalho, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório que contém o espaço de trabalho com que você quer trabalhar.

4. No editor, localize o espaço de trabalho e clique em Abrir.

   Isso abre o painel do espaço de trabalho:

   

5. Selecione o arquivo que você quer excluir, clique na opção more_vert Ações e, em seguida, em Excluir.

6. Clique em Excluir.

Usar o controle de versões com um arquivo

Esta seção mostra como usar o controle de versão no BigQuery para acompanhar os arquivos nos espaços de trabalho.

O BigQuery usa o Git para acompanhar cada mudança feita nos arquivos de um repositório. Em um repositório do BigQuery, você interage diretamente com o repositório do Git. Em um repositório conectado, você interage com a ramificação padrão do repositório remoto que você configurou ao conectar o repositório.

O BigQuery mostra opções de controle de versão com base no status das mudanças no seu espaço de trabalho. Por exemplo, o BigQuery mostra a opção de confirmação somente quando há mudanças locais não confirmadas no seu espaço de trabalho. Quando os arquivos no seu espaço de trabalho são uma cópia exata da versão padrão ou da ramificação padrão, o BigQuery mostra o status Atualizado.

O BigQuery mostra as seguintes opções de controle de versão:

Confirmar as alterações X

Confirme o número X de alterações locais no seu espaço de trabalho ou arquivos alterados selecionados. O BigQuery mostra as mudanças não confirmadas.

Enviar para ramificação padrão

Envie as alterações confirmadas para a ramificação padrão. Essa opção estará disponível em um repositório se você não tiver alterações não confirmadas no seu espaço de trabalho e se houver confirmações não enviadas.

Enviar para your-branch-name

Envie as alterações confirmadas para your-branch-name. Essa opção está disponível em um repositório conectado a um repositório Git de terceiros se você não tiver mudanças não confirmadas no seu espaço de trabalho. O nome da ramificação remota no repositório de terceiros é igual ao ID do espaço de trabalho do BigQuery.

Extrair da ramificação padrão

Atualize seus espaços de trabalho com as mudanças recentes da ramificação padrão. Essa opção estará disponível em um repositório se você não tiver mudanças não confirmadas no seu espaço de trabalho.

Extrair de your-branch-name

Atualize seu espaço de trabalho com as mudanças recentes de your-branch-name. Essa opção está disponível em um repositório conectado a um repositório Git de terceiros se você não tiver mudanças não confirmadas no seu espaço de trabalho. O nome da ramificação remota no repositório de terceiros é o mesmo do ID do espaço de trabalho do BigQuery.

Reverter para a última confirmação

Restaure os arquivos no seu espaço de trabalho para o estado do último commit.

Extrair mudanças

Se o espaço de trabalho não estiver sincronizado com o repositório, o BigQuery vai mostrar a opção Pull.

Para extrair as mudanças do repositório para o espaço de trabalho, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório que contém o espaço de trabalho com que você quer trabalhar.

4. No editor, localize o espaço de trabalho e clique em Abrir.

   Isso abre o painel do espaço de trabalho:

   

5. No painel do espaço de trabalho, faça o seguinte:

   1. Se você estiver em um repositório do BigQuery, clique em Extrair da ramificação padrão.

   2. Se você estiver em um repositório conectado a um repositório Git de terceiros, faça uma das seguintes ações:

      1. Clique em Extrair da ramificação padrão para extrair da ramificação padrão do repositório de terceiros.
      2. Clique em Extrair de your-branch-name para extrair da ramificação do repositório de terceiros que corresponde ao espaço de trabalho atual.

Fazer commit

Depois que você faz uma mudança em um espaço de trabalho, o BigQuery mostra a opção Commit. Você pode confirmar todas as mudanças locais ou arquivos selecionados. Os arquivos que você adicionou ou modificou são identificados com um ponto azul ao lado deles no painel do espaço de trabalho.

Para confirmar as mudanças do seu espaço de trabalho no repositório, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório que contém o espaço de trabalho com que você quer trabalhar.

4. No editor, localize o espaço de trabalho e clique em Abrir.

   Isso abre o painel do espaço de trabalho:

   

5. No painel do espaço de trabalho, clique em Confirmar alterações X.

6. No painel Commit changes, faça o seguinte:

   1. Selecione os arquivos alterados que você quer confirmar.

      Se você não selecionar nenhum arquivo, o BigQuery vai confirmar todas as mudanças locais. É possível filtrar arquivos alterados por estado, nome e caminho.

   2. No campo Adicionar uma mensagem de confirmação, digite uma descrição para a confirmação.

   3. Clique em Confirmar todas as alterações ou Confirmar alterações X.

      O nome do botão depende da seleção de arquivos a serem confirmados.

Enviar mudanças

O BigQuery mostra a opção Push depois que você confirma as mudanças.

Para enviar as mudanças do espaço de trabalho para o repositório, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório que contém o espaço de trabalho com que você quer trabalhar.

4. No editor, localize o espaço de trabalho e clique em Abrir.

   Isso abre o painel do espaço de trabalho:

   

5. No painel do espaço de trabalho, faça o seguinte:

   1. Se você estiver em um repositório do BigQuery, clique em Enviar para a ramificação padrão.

   2. Se você estiver em um repositório conectado a um repositório Git de terceiros, faça uma das seguintes ações:

      1. Clique em Enviar para a ramificação padrão para enviar para a ramificação padrão do repositório de terceiros.
      2. Clique em Enviar para your-branch-name para enviar para a ramificação do repositório de terceiros que corresponde ao espaço de trabalho atual.

Reverter alterações não confirmadas

Para reverter as mudanças não confirmadas, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório que contém o espaço de trabalho com que você quer trabalhar.

4. No editor, localize o espaço de trabalho e clique em Abrir.

   Isso abre o painel do espaço de trabalho:

   

5. No painel do espaço de trabalho, clique no menu suspenso arrow_drop_down da seta no botão de controle de versão e, em seguida, clique em Reverter para a última confirmação.

Resolver conflitos de mesclagem

Um conflito de mesclagem pode acontecer quando uma mudança local no seu espaço de trabalho é incompatível com uma mudança feita na branch padrão do repositório. Conflitos de mesclagem geralmente ocorrem quando vários usuários editam o mesmo arquivo simultaneamente.

Geralmente, você encontra um conflito de mesclagem ao fazer o pull de uma ramificação depois que outro usuário fez um push de uma mudança conflitante para a mesma ramificação. Para resolver um conflito de mesclagem, edite o arquivo afetado.

O exemplo de código a seguir mostra um conflito de mesclagem exibido em um arquivo SQL:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

Para resolver um conflito de mesclagem, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório que contém o espaço de trabalho com que você quer trabalhar.

4. No editor, localize o espaço de trabalho e clique em Abrir.

   Isso abre o painel do espaço de trabalho:

   

5. Selecione o arquivo afetado e faça as alterações escolhidas.

6. Confirmar as mudanças.

7. Opcional: alterações de push.

Conferir histórico de confirmação

Para conferir o histórico de confirmações, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, abra a pasta Repositories.

3. Selecione o repositório que contém o espaço de trabalho com que você quer trabalhar.

4. No editor, localize o espaço de trabalho e clique em Abrir.

   Isso abre o painel do espaço de trabalho:

   

5. No painel do espaço de trabalho, clique no menu suspenso arrow_drop_down da seta no botão de controle de versão e depois em Ver histórico de confirmações.

Excluir um espaço de trabalho

Para excluir um espaço de trabalho e todo o conteúdo dele, siga estas etapas:

1. No Console do Google Cloud, acesse a página BigQuery.

   Ir para o BigQuery

2. No painel Explorer, clique na pasta Repositories.

3. No painel Git Repositories, selecione o espaço de trabalho que você quer excluir.

4. Clique na opção more_vert Ações e em Excluir.

5. Clique em Excluir.

A seguir

• Saiba como criar repositórios.