Criar e gerenciar pastas

Pré-lançamento

Este recurso está sujeito aos "Termos da Oferta Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Observação: para enviar feedback ou pedir suporte sobre esse recurso, envie um e-mail para [e-mail].

O documento a seguir descreve como criar e gerenciar pastas no BigQuery. É possível usar pastas para organizar e controlar o acesso a recursos de código de arquivo único, como notebooks, consultas salvas, painéis de dados e arquivos de preparação de dados. O BigQuery oferece pastas de usuário para que as pessoas gerenciem os próprios recursos de código e pastas de equipe para gerenciar os recursos de código de uma equipe.

As pastas do BigQuery são desenvolvidas pelo Dataform.

Antes de criar pastas, saiba como elas funcionam no BigQuery lendo Organizar recursos de código com pastas.

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Funções exigidas

Para receber as permissões necessárias para concluir as tarefas neste documento, peça ao administrador para conceder a você os papéis apropriados do IAM no projeto, na pasta ou no recurso.

Para receber as permissões necessárias para usar o navegador de arquivos do BigQuery, peça ao administrador para conceder a você o papel de Usuário do BigQuery (roles/bigquery.user) ou Usuário do BigQuery Studio (roles/bigquery.studioUser) no projeto.

As permissões concedidas em uma pasta são propagadas para todos os arquivos e pastas contidos nela.

O seguinte se aplica aos arquivos e às pastas que os contêm:

Papel	Concedido em	Permissões e casos de uso
Proprietário do código (roles/dataform.codeOwner)	Arquivo ou pasta	Concede controle total sobre um recurso no sistema de arquivos e pastas. Um usuário com essa função pode realizar todas as ações, incluindo excluir o recurso, definir a política do IAM e movê-lo.
Editor de código (roles/dataform.codeEditor)	Arquivo ou pasta	Permite editar e gerenciar conteúdo. Um usuário com essa função pode adicionar conteúdo a pastas, editar arquivos e receber a política do IAM de um arquivo ou pasta. Essa função também é necessária na pasta de destino ao mover um recurso.
Comentarista de código (roles/dataform.codeCommenter)	Arquivo ou pasta	Permite fazer comentários em recursos ou pastas de código.
Visualizador de código (roles/dataform.codeViewer)	Arquivo ou pasta	Fornece acesso somente leitura. Um usuário com essa função pode consultar o conteúdo de arquivos e pastas.
Criador de código (roles/dataform.codeCreator)	Projeto	Concede permissão para criar novos arquivos e pastas em um projeto.

As seguintes funções são específicas para gerenciar pastas de equipe:

Papel	Concedido em	Permissões e casos de uso
Proprietário da pasta de equipe (roles/dataform.teamFolderOwner)	Pasta da equipe	Concede controle total sobre uma pasta de equipe no sistema de arquivos e pastas. Um usuário com essa função pode excluir a pasta de equipe e definir a política do IAM dela.
Colaborador da pasta de equipe (roles/dataform.teamFolderContributor)	Pasta da equipe	Permite o gerenciamento de conteúdo em uma pasta da equipe. Um usuário com essa função pode atualizar uma pasta de equipe.
Comentador da pasta da equipe (roles/dataform.teamFolderCommenter)	Pasta da equipe	Permite comentar em uma pasta da equipe e nos recursos de código que ela contém.
Leitor de pastas de equipe (roles/dataform.teamFolderViewer)	Pasta da equipe	Dá acesso somente leitura a uma pasta da equipe e ao conteúdo dela. Um usuário com essa função pode acessar uma pasta de equipe e receber a política do IAM dela.
Criador de pastas de equipe (roles/dataform.teamFolderCreator)	Projeto	Concede permissão para criar pastas de equipe em um projeto.

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para concluir as tarefas neste documento. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

• Criar uma pasta:
  • folders.create na pasta do usuário principal, na pasta da equipe ou no projeto
  • folders.addContents na pasta principal ou de equipe
• Recuperar as propriedades de uma pasta: folders.get na pasta
• Consultar o conteúdo de uma pasta ou pasta de equipe: folders.queryContents na pasta
• Atualizar uma pasta: folders.update na pasta
• Excluir uma pasta: folders.delete na pasta
• Acessar a política do IAM de uma pasta: folders.getIamPolicy na pasta
• Defina a política do IAM para uma pasta: folders.setIamPolicy na pasta
• Mover uma pasta:
  • folders.move na pasta que está sendo movida
  • folders.addContents na pasta de destino ou na pasta de equipe (não é necessário se a movimentação for para uma pasta raiz)
• Criar uma pasta de equipe: teamFolders.create no projeto
• Excluir uma pasta de equipe: teamFolders.delete na pasta de equipe
• Acessar a política do IAM de uma pasta de equipe: teamFolders.getIamPolicy na pasta de equipe
• Defina a política do IAM para uma pasta de equipe: teamFolders.setIamPolicy na pasta de equipe
• Recuperar as propriedades de uma pasta de equipe: teamFolders.get na pasta de equipe
• Atualizar uma pasta de equipe: teamFolders.update na pasta de equipe

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

Para ter acesso total a todas as pastas e arquivos do seu projeto, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

• Administrador do Dataform (roles/dataform.admin)
• Editor do Dataform (roles/dataform.editor)
• Leitor do Dataform (roles/dataform.viewer)

Acessar recursos

Siga estas etapas para conferir pastas e recursos de código no BigQuery:

1. Acessar a página do BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em Arquivos para abrir o navegador de arquivos:

   

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

3. Faça uma destas ações para ver pastas e recursos de código no projeto e na região de código selecionados:

   • Expanda o nó Usuário (seu endereço de e-mail) para ver as pastas e os arquivos que você criou.
   • Expanda o nó Pastas de equipe para ver todas as pastas de equipe a que você tem acesso.
   • Expanda o nó Compartilhados comigo para ver todas as pastas e arquivos que outros usuários compartilharam com você.

Mudar a região de código

É possível ter pastas e recursos de código em regiões de código diferentes. Siga estas etapas para mudar a região de código que você está visualizando:

1. Acessar a página do BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em Arquivos para abrir o navegador de arquivos:

   

3. Ao lado do nome do projeto, clique em Ver ações do painel de arquivos > Mudar região de código.

4. Selecione a região de código que você quer visualizar.

5. Clique em Salvar.

Criar uma pasta ou um recurso de código

Use este procedimento para criar qualquer um dos seguintes recursos:

• Uma pasta de usuário ou um recurso de código em qualquer nível.
• Uma subpasta em uma pasta de equipe.
• Um recurso de código na subpasta de uma pasta de equipe.

Para informações sobre como criar uma pasta de equipe, consulte Criar uma pasta de equipe.

Siga estas etapas para criar uma pasta ou um recurso de código no BigQuery:

1. Acessar a página do BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em Arquivos para abrir o navegador de arquivos:

   

3. Selecione o nó raiz do usuário ou a pasta em que você quer criar o recurso.

4. Clique em Ver ações > Criar e selecione o tipo de recurso que você quer criar.

5. No painel de criação de recursos, digite um nome para o novo recurso.

6. Clique em Salvar.

Criar uma pasta de equipe

Siga estas etapas para criar uma pasta de equipe no BigQuery:

1. Acessar a página do BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em Arquivos para abrir o navegador de arquivos:

   

3. Selecione o nó raiz da pasta de equipe.

4. Clique em Conferir ações > Criar pasta de equipe.

5. Na caixa de diálogo Criar pasta da equipe, digite um nome para a pasta.

6. Clique em Criar.

Fazer upload de um recurso de código

Siga estas etapas para fazer upload de um recurso de código no BigQuery:

1. Acessar a página do BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em Arquivos para abrir o navegador de arquivos:

   

3. Selecione a pasta em que você quer fazer upload do recurso de código.

4. Clique em Ver ações > Fazer upload e selecione o tipo de recurso de código que você quer enviar.

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

   • Clique no botão de opção Upload de arquivo e procure e selecione um arquivo local.
   • Clique no botão de opção URL e digite o URL de um arquivo de recurso de código que reside em um repositório do GitHub.

6. Digite um nome para o recurso de código.

7. Opcional: selecione uma região para armazenar o recurso de código. Se você selecionar uma região diferente do valor padrão, a região selecionada se tornará a região padrão em que todos os novos recursos de código serão criados daqui para frente.

8. Clique em Salvar.

Baixar um recurso de código

Siga estas etapas para baixar um recurso de código no BigQuery:

1. Acessar a página do BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em Arquivos para abrir o navegador de arquivos:

   

3. Selecione o recurso de código que você quer baixar.

4. Clique em Ver ações > Fazer o download.

Renomear uma pasta ou um recurso de código

Siga estas etapas para renomear uma pasta ou um recurso de código no BigQuery:

1. Acessar a página do BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em Arquivos para abrir o navegador de arquivos:

   

3. Selecione a pasta ou o recurso de código que você quer renomear.

4. Clique em Ver ações > Renomear.

5. Na caixa de diálogo de renomeação de recursos, digite um novo nome para o recurso.

6. Clique em Renomear.

Compartilhar uma pasta ou um recurso de código

Siga estas etapas para compartilhar uma pasta ou um recurso de código no BigQuery:

1. Acessar a página do BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em Arquivos para abrir o navegador de arquivos:

   

3. Selecione a pasta ou o recurso de código que você quer compartilhar.

4. No painel Permissões de compartilhamento, clique em Adicionar usuário/grupo.

5. No campo Novos principais, digite um principal..

6. Escolha uma destas opções:

   • Na lista Papel, selecione uma das seguintes opções para compartilhar um recurso de código, incluindo uma pasta de usuário:

     • roles/dataform.codeOwner: pode executar qualquer ação no recurso de código, incluindo excluir ou compartilhar.
     • roles/dataform.codeEditor: pode executar qualquer ação no recurso de código, exceto excluir ou compartilhar.
     • roles/dataform.codeCommenter: pode visualizar e comentar o recurso de código.
     • roles/dataform.codeViewer: pode visualizar o recurso de código.

   • Na lista Função, selecione uma das seguintes opções para compartilhar uma pasta de equipe:

     • roles/dataform.teamFolderOwner: pode executar qualquer ação na pasta da equipe, incluindo excluir ou compartilhar.
     • roles/dataform.teamFolderContributor: pode executar qualquer ação na pasta de equipe, exceto excluir ou compartilhar.
     • roles/dataform.teamFolderCommenter: pode visualizar e comentar na pasta de equipe e nos recursos de código que ela contém.
     • roles/dataform.teamFolderViewer: pode acessar a pasta de equipe e os recursos de código que ela contém.

7. Clique em Salvar.

8. Para retornar à página de informações do notebook, clique em Fechar.

Mover uma pasta ou um recurso de código

Siga estas etapas para mover uma pasta ou um recurso de código no BigQuery:

1. Acessar a página do BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em Arquivos para abrir o navegador de arquivos:

   

3. Selecione a pasta ou o recurso de código que você quer mover.

4. Clique em Ver ações > Mover.

5. Na caixa de diálogo "Mover recurso", selecione o usuário ou a pasta de equipe para onde você quer mover o recurso.

6. Clique em Mover.

Copiar uma pasta ou um recurso de código

Siga estas etapas para copiar uma pasta ou um recurso de código no BigQuery:

1. Acessar a página do BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em Arquivos para abrir o navegador de arquivos:

   

3. Selecione a pasta ou o recurso de código que você quer copiar.

4. Clique em Conferir ações > Copiar.

5. Na caixa de diálogo "Copiar recurso", selecione a pasta do usuário ou da equipe em que você quer copiar o recurso.

6. Clique em Copiar.

Excluir uma pasta ou um recurso de código

Siga estas etapas para excluir uma pasta ou um recurso de código no BigQuery:

1. Acessar a página do BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em Arquivos para abrir o navegador de arquivos:

   

3. Selecione a pasta ou o recurso de código que você quer excluir.

4. Clique em Ver ações > Excluir.

5. Na caixa de diálogo de exclusão de recursos, clique em Excluir.

A seguir

• Organizar recursos de código com pastas
• Criar notebooks
• Criar consultas salvas
• Criar telas de dados
• Criar preparações de dados