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.

Importante: em março de 2024, as APIs com suporte aos recursos do BigQuery Studio foram ativadas automaticamente em todos os projetos do BigQuery. Esses novos projetos do BigQuery têm essas APIs ativadas por padrão. Para mais informações, consulte Ativação automática de APIs do BigQuery Studio.

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.

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

   Acessar o BigQuery

2. 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.

3. Clique em Conferir ações ao lado da consulta salva e em Compartilhar > Gerenciar permissões.

4. No painel Gerenciar permissões, clique em Adicionar usuário/grupo.

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

6. 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.
   Observação: o principal também precisa ter o papel de Usuário do BigQuery (roles/bigquery.user) para executar a consulta salva.

7. Opcional: para ver uma lista completa de papéis e configurações de compartilhamento avançadas, clique em Compartilhamento avançado.

8. Clique em Salvar.

9. 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.

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

   Acessar o BigQuery

2. 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.

3. Clique em Ver ações ao lado da consulta e em Compartilhar > Copiar link.

4. Compartilhe 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:

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

   Acessar o BigQuery

2. 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:

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

   Acessar o BigQuery

2. 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.

3. 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:

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

   Acessar o BigQuery

2. 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.

3. 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:

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

   Acessar o BigQuery

2. 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.

3. 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.

4. 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

1. 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.
2. Selecione o painel Atividade.
3. Clique em Ver ações ao lado da versão da consulta salva que você quer restaurar e, em seguida, clique em Restaurar.
4. Clique em Confirmar para confirmar a ação.

Painel de comparação

1. 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.
2. Selecione o painel Atividade.
3. 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.
4. Se quiser restaurar a versão anterior da consulta salva após a comparação, clique em Restaurar.
5. Clique em Confirmar para confirmar a ação.

Fazer o download de consultas salvas

Para fazer download de uma consulta salva, siga estas etapas:

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

   Acessar o BigQuery

2. 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.

3. Clique em Fazer download.

Excluir consulta salva

Para excluir uma consulta salva, siga estas etapas:

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

   Acessar o BigQuery

2. 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.

3. Clique em Ver ações ao lado da consulta salva e, em seguida, clique em Excluir.

4. Para confirmar a exclusão, digite delete na caixa de diálogo.

5. Clique em Excluir.

Consultas salvas clássicas

Descontinuadas: as consultas salvas, disponíveis na visualização do BigQuery Studio, vão substituir totalmente as consultas salvas clássicas até março de 2025. Para mais informações, acesse Descontinuação das consultas salvas clássicas. Para saber como migrar para consultas salvas, acesse Migrar consultas salvas clássicas.

Use as seções a seguir para saber como gerenciar consultas salvas clássicas.

Observação: se você não ativou o BigQuery Studio, as consultas salvas clássicas aparecerão na pasta Consultas salvas (NUMBER) do painel Explorer em vez da pasta Consultas (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.

1. 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.
2. Clique em Ver ações ao lado da consulta e clique em Gerar link.
3. Compartilhe o link com os usuários a quem você quer conceder acesso à consulta.

Migrar consultas salvas clássicas

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

   Acessar o BigQuery

2. No painel Explorer, expanda seu projeto e a pasta (clássica) de consultas e, se necessário, a pasta Consultas de projetos.

3. Clique no nome de uma consulta salva clássica para abri-la.

4. Clique em Salvar consulta (clássico) > Salvar consulta como....

5. Na caixa de diálogo Salvar consulta, digite um nome e escolha o local para a consulta.

6. Clique em Save.

Excluir consultas salvas clássicas

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

   Acessar o BigQuery

2. No painel Explorer, expanda seu projeto e a pasta (clássica) de consultas e, se necessário, a pasta Consultas de projetos.

3. Encontre a consulta salva clássica que você quer excluir.

4. Clique em Ver ações ao lado da consulta e, em seguida, clique em Excluir.

5. Para confirmar a exclusão, digite delete na caixa de diálogo.

6. Clique em Excluir.