Gerenciar consultas salvas
Neste documento, descrevemos como gerenciar consultas salvas e consultas salvas clássicas.
Consultas salvas
Use as seções a seguir para aprender a gerenciar consultas salvas. As consultas salvas são recursos de código do BigQuery Studio com tecnologia do Dataform.
Permissões necessárias
Para gerenciar as consultas salvas, você precisa dos seguintes papéis do Identity and Access Management (IAM):
- Usuário de jobs do BigQuery(
roles/bigquery.jobUser
) - Usuário de sessão de leitura do BigQuery(
roles/bigquery.readSessionUser
) - Proprietário de código (
roles/dataform.codeOwner
)
Para mais informações sobre o IAM do BigQuery, consulte Controle de acesso com o IAM.
Conceder acesso a consultas salvas
Para conceder a outros usuários acesso a uma consulta salva, adicione esses usuários a um papel apropriado do IAM.
No console do Google Cloud, acesse a página do BigQuery.
No painel Explorer, expanda seu projeto e a pasta Consultas e, se necessário, a pasta Consultas compartilhadas. Encontre a consulta salva a que você quer conceder acesso.
Clique em > Gerenciar permissões.
Conferir ações ao lado da consulta salva e em CompartilharNo painel Gerenciar permissões, clique em Adicionar usuário/grupo.
No campo Novos principais, digite um principal..
Na lista Papel, selecione um dos seguintes papéis:
- Proprietário de código: pode executar qualquer ação na consulta salva, incluindo excluí-la ou compartilhá-la.
- Editor de código: pode editar a consulta.
- Leitor de código: pode visualizar a consulta.
Opcional: para ver uma lista completa de papéis e configurações de compartilhamento avançadas, clique em Compartilhamento avançado.
Clique em Salvar.
Para retornar às informações da consulta salvas, clique em Fechar.
Compartilhar consultas salvas
Para compartilhar uma consulta salva com outros usuários, gere e compartilhe um link para ela. Antes que os usuários possam ver a consulta salva que você compartilha, primeiro é necessário conceder a eles acesso a essa consulta.
Para executar uma consulta compartilhada, os usuários precisam ter acesso aos dados que a consulta acessa. Para mais informações, consulte Como conceder acesso a um conjunto de dados.
Se você planeja compartilhar uma consulta salva, considere incluir um comentário na consulta que descreva a finalidade dela.
No console do Google Cloud, acesse a página do BigQuery.
No painel Explorer, expanda seu projeto e a pasta Consultas e, se necessário, expanda a pasta Consultas compartilhadas. Encontre a consulta salva que você quer compartilhar.
Clique em > Copiar link.
Ver ações ao lado da consulta e em CompartilharCompartilhe o link com outros usuários.
Ver todas as consultas salvas
Para visualizar uma lista de todas as consultas salvas no seu projeto, faça o seguinte:
No console do Google Cloud, acesse a página do BigQuery.
No painel Explorer, clique em
Ver ações ao lado de Consultas e execute uma das seguintes ações: :
- Para abrir a lista na guia atual, clique em Mostrar tudo.
- Para abrir a lista em uma nova guia, clique em Mostrar tudo em > Nova guia.
- Para abrir a lista em uma guia dividida, clique em Mostrar tudo em > Dividir guia.
Ver metadados da consulta salva
Para conferir os metadados das consultas salvas, siga estas etapas:
No console do Google Cloud, acesse a página do BigQuery.
No painel Explorer, expanda seu projeto e a pasta Consultas e, se necessário, a pasta Consultas compartilhadas. Clique no nome da consulta salva com os metadados que você quer ver.
Confira o painel Resumo para ver informações sobre a consulta salva, como a região que ela usa e a data da última modificação.
Trabalhar com versões de consulta salvas
Use as seções a seguir para aprender a visualizar, comparar e restaurar versões de uma consulta salva.
Ver versões da consulta salvas
Para conferir as versões da consulta salvas, siga estas etapas:
No console do Google Cloud, acesse a página do BigQuery.
No painel Explorer, expanda seu projeto e a pasta Consultas e, se necessário, a pasta Consultas compartilhadas. Clique no nome da consulta salva com a atividade que você quer ver.
Clique na guia Atividade para ver uma lista das versões de consulta salvas em ordem decres cente por data.
Comparar versões de consultas salvas
Para comparar as versões de consulta salvas, siga estas etapas:
No console do Google Cloud, acesse a página do BigQuery.
No painel Explorer, expanda seu projeto e a pasta Consultas e, se necessário, a pasta Consultas compartilhadas. Clique no nome da consulta salva com as informações de versão que você quer comparar.
Na guia Atividade, clique em
Ver ações ao lado de uma versão de consulta salva e clique em Comparar. O painel de comparação é aberto, comparando a versão da consulta salva selecionada com a versão atual da consulta salva.Opcional: para comparar as versões inline em vez de em painéis separados, clique em Comparar e em Inline.
Restaurar uma versão de consulta salva
Use uma das seguintes opções para restaurar uma versão de consulta salva. Restaurar a partir do painel de comparação permite comparar a versão anterior da consulta salva com a versão atual antes de decidir se quer restaurá-la.
Painel de atividades
- No painel Explorer, expanda seu projeto e a pasta Consultas e, se necessário, a pasta Consultas compartilhadas. Clique no nome da consulta salva da qual você quer restaurar uma versão anterior.
- Selecione o painel Atividade.
- Clique em Ver ações ao lado da versão da consulta salva que você quer restaurar e, em seguida, clique em Restaurar.
- Clique em Confirmar para confirmar a ação.
Painel de comparação
- No painel Explorer, expanda seu projeto e a pasta Consultas e, se necessário, a pasta Consultas compartilhadas. Clique no nome da consulta salva da qual você quer restaurar uma versão anterior.
- Selecione o painel Atividade.
- Clique em Ver ações ao lado de uma versão de consulta salva e, em seguida, clique em Comparar. O painel de comparação é aberto, comparando a versão da consulta salva selecionada com a versão mais recente da consulta salva.
- Se quiser restaurar a versão anterior da consulta salva após a comparação, clique em Restaurar.
- Clique em Confirmar para confirmar a ação.
Fazer o download de consultas salvas
Para fazer download de uma consulta salva, siga estas etapas:
No console do Google Cloud, acesse a página do BigQuery.
No painel Explorer, expanda seu projeto e a pasta Consultas e, se necessário, a pasta Consultas compartilhadas. Clique no nome de uma consulta salva para abri-la.
Clique em Fazer download.
Excluir consulta salva
Para excluir uma consulta salva, siga estas etapas:
No console do Google Cloud, acesse a página do BigQuery.
No painel Explorer, expanda seu projeto e a pasta Consultas e, se necessário, a pasta Consultas compartilhadas. Encontre a consulta salva que você quer excluir.
Clique em
Ver ações ao lado da consulta salva e, em seguida, clique em Excluir.Para confirmar a exclusão, digite
delete
na caixa de diálogo.Clique em Excluir.
Consultas salvas clássicas
Use as seções a seguir para saber como gerenciar consultas salvas clássicas.
Compartilhar consultas salvas clássicas
É possível compartilhar consultas salvas clássicas que você concedeu ao projeto ou à visibilidade pública. A visibilidade do projeto permite que os participantes com as permissões necessárias visualizem, atualizem ou excluam a consulta. A visibilidade pública permite que qualquer pessoa com o link da consulta veja, mas não atualize nem exclua a consulta.
Para compartilhar uma consulta salva clássica com outros usuários, gere e compartilhe um link para ela.
Para executar uma consulta compartilhada, os usuários precisam ter acesso aos dados que a consulta acessa. Para mais informações, consulte Como conceder acesso a um conjunto de dados.
Se você planeja compartilhar uma consulta salva clássica, considere incluir um comentário na consulta que descreva a finalidade dela.
- No painel Explorer, expanda seu projeto e a pasta Consultas(clássicas) e, em seguida, encontre a consulta salva clássica que você quer compartilhar.
- Clique em Ver ações ao lado da consulta e clique em Gerar link.
- Compartilhe o link com os usuários a quem você quer conceder acesso à consulta.
Migrar consultas salvas clássicas
No console do Google Cloud, acesse a página do BigQuery.
No painel Explorer, expanda seu projeto e a pasta (clássica) de consultas e, se necessário, a pasta Consultas de projetos.
Clique no nome de uma consulta salva clássica para abri-la.
Clique em Salvar consulta (clássico) > Salvar consulta como....
Na caixa de diálogo Salvar consulta, digite um nome e escolha o local para a consulta.
Clique em Salvar.
Excluir consultas salvas clássicas
No console do Google Cloud, acesse a página do BigQuery.
No painel Explorer, expanda seu projeto e a pasta (clássica) de consultas e, se necessário, a pasta Consultas de projetos.
Encontre a consulta salva clássica que você quer excluir.
Clique em
Ver ações ao lado da consulta e, em seguida, clique em Excluir.Para confirmar a exclusão, digite
delete
na caixa de diálogo.Clique em Excluir.