Criar e gerenciar espaços de trabalho

Visualizar

Este produto ou recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Observação : para enviar feedback ou fazer perguntas relacionadas a esse recurso em pré-lançamento, entre em contato com [e-mail].

Ao usar os repositórios do BigQuery para controlar as versões dos seus arquivos, use espaços de trabalho para editar o código nesses repositórios. Neste documento, mostramos como criar, excluir e gerenciar arquivos em um espaço de trabalho.

Para uma experiência de controle de versões baseada em pastas, recomendamos o uso de repositórios Git do BigQuery Studio. Com essa integração, é possível trabalhar com ramificações do Git diretamente no navegador de arquivos do BigQuery Studio e clonar vários repositórios de uma só vez, sem gerenciar espaços de trabalho separados.

Antes de começar

Se você ainda não tiver feito isso, crie um repositório do BigQuery.

Funções exigidas

O acesso aos espaços de trabalho é determinado pelos papéis concedidos 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 é tratada 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.

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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 de desenvolvimento, no campo ID do espaço de trabalho, insira um ID exclusivo para o espaço de trabalho.

   Os IDs podem incluir apenas 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.

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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 de desenvolvimento será aberto.

5. Escolha o botão de opção Ramificação remota atual ou Nova ramificação, dependendo se você quer usar uma ramificação 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 Ramificação remota atual, escolha uma ramificação atual no campo Ramificação remota.

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

      Os IDs podem incluir apenas 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.

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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

4. Localize o espaço de trabalho e clique em Abrir.

   Isso abre o espaço de trabalho no painel Controle de origem.

5. Clique em Abrir menu de criação.

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

É possível criar arquivos em um espaço de trabalho ou fazer upload de arquivos.

É possível criar ou fazer upload dos seguintes tipos de arquivos em 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.

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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

4. Localize o espaço de trabalho e clique em Abrir.

   Isso abre o espaço de trabalho no painel Controle de origem.

5. Clique em Abrir menu de criação.

6. Clique em Criar no repositório e, em seguida, no 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 você quer criar o arquivo.

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.

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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

4. Localize o espaço de trabalho e clique em Abrir.

   Isso abre o espaço de trabalho no painel Controle de origem.

5. Clique em Abrir menu de criação.

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

7. No painel de upload, siga um destes procedimentos:

   • No campo Upload de 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 você quer criar o arquivo.

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.

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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

4. Localize o espaço de trabalho e clique em Abrir.

   Isso abre o espaço de trabalho no painel Controle de origem.

5. Selecione o arquivo que você quer excluir, clique em Ver ações e, em seguida, clique em Excluir.

6. Clique em Excluir para confirmar.

Usar o controle de versões com um arquivo

Nesta seção, mostramos como usar o controle de versões no BigQuery para acompanhar os arquivos nos espaços de trabalho.

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

O BigQuery exibe opções de controle de versões com base no status das mudanças no seu espaço de trabalho. Por exemplo, o BigQuery exibe a opção de commit 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 ramificação padrão, o BigQuery exibe o status Atualizado.

O BigQuery exibe as seguintes opções de controle de versões:

Confirmar X alteração

Confirma o número X de mudanças locais no seu espaço de trabalho ou nos arquivos modificados selecionados. O BigQuery exibe as alterações não confirmadas.

Enviar para ramificação padrão

Envie as mudanças confirmadas para a 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 e houver confirmações não enviadas.

Enviar para your-branch-name

Envie as mudanças 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 é igual ao 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 estiver fora de sincronia com o repositório, o BigQuery vai exibir a opção Pull.

Para extrair 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.

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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

4. Localize o espaço de trabalho e clique em Abrir.

   Isso abre o espaço de trabalho no painel Controle de origem.

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 o seguinte:

      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 alteração em um espaço de trabalho, o BigQuery exibe a opção Commit. Você pode confirmar todas as mudanças locais ou os 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.

Observação: por padrão, o BigQuery usa o endereço de e-mail do usuário autenticado Google Cloud para o autor do commit, mas a API Dataform permite definir um endereço de e-mail personalizado para o autor do commit. Esse comportamento é semelhante ao comando git commit --author e afeta apenas o histórico de commits do Git. A identidade do autor do commit não é verificada criptograficamente.

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

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

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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

4. Localize o espaço de trabalho e clique em Abrir.

   Isso abre o espaço de trabalho no painel Controle de origem.

5. No painel do espaço de trabalho, clique em Confirmar X mudanças.

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

   1. Selecione os arquivos alterados para fazer commit.

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

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

   3. Clique em Fazer commit de todas as mudanças ou em Fazer commit de X mudanças.

      O nome do botão depende da seleção de arquivos para commit.

Enviar mudanças

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

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

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

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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

4. Localize o espaço de trabalho e clique em Abrir.

   Isso abre o espaço de trabalho no painel Controle de origem.

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 o seguinte:

      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 alterações não confirmadas, siga estas etapas:

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

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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

4. Localize o espaço de trabalho e clique em Abrir.

   Isso abre o espaço de trabalho no painel Controle de origem.

5. No painel do espaço de trabalho, clique no menu suspenso de seta no botão de controle de versões e em Reverter para o último commit.

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 ramificação padrão do seu repositório. Os conflitos de mesclagem geralmente ocorrem quando vários usuários editam o mesmo arquivo simultaneamente.

Normalmente, um conflito de mesclagem ocorre quando você faz pull de uma ramificação depois que outro usuário enviou uma alteração conflitante para a mesma ramificação. É necessário resolver um conflito de mesclagem manualmente editando 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.

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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

4. Localize o espaço de trabalho e clique em Abrir.

   Isso abre o espaço de trabalho no painel Controle de origem.

5. Selecione o arquivo afetado e edite-o com as mudanças escolhidas.

6. Fazer commit das mudanças.

7. Opcional: enviar as mudanças.

Conferir histórico de confirmação

Para ver o histórico de commits, siga estas etapas:

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

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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

4. Localize o espaço de trabalho e clique em Abrir.

   Isso abre o espaço de trabalho no painel Controle de origem.

5. No painel do espaço de trabalho, clique na seta suspensa no botão de controle de versões e em Ver histórico de commits.

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.

   Acessar o BigQuery

2. No painel à esquerda, clique em Controle de origem.

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

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

4. Localize seu espaço de trabalho e clique em Abrir ações > Excluir.

5. Clique em Excluir.

A seguir

• Saiba como gerenciar código com repositórios Git do BigQuery Studio.
• Saiba como criar repositórios.