Como salvar e compartilhar consultas

Esta página descreve como salvar e compartilhar consultas. As consultas salvas ou compartilhadas contêm somente a consulta em si, o que significa que:

  • Uma consulta compartilhada fornece apenas o texto da consulta. Ainda será necessário um acesso apropriado para consultar os dados. Uma vantagem de salvar apenas o texto da consulta é a possibilidade de compartilhá-la mesmo incompleta ou inválida, e usá-la como modelo para outros usuários completarem ou personalizarem.

  • A única opção retida por uma consulta salva é "SQL Version", que determina se a consulta usa o SQL legado ou padrão.

Existem três tipos de consultas salvas:

  • Particular: as consultas salvas particulares permanecem visíveis apenas para o usuário que as criou.
  • Para envolvidos no projeto: as consultas salvas para envolvidos no projeto permanecem visíveis para os membros dos papéis predefinidos do Cloud IAM do BigQuery com as permissões obrigatórias.
  • Pública: as consultas públicas salvas são visíveis para qualquer pessoa com o link da consulta.

Permissões

As permissões a seguir do Cloud IAM são obrigatórias para criar, ver, atualizar e excluir consultas salvas:

  • Consultas salvas particulares:
    • A criação de consultas salvas particulares não requer permissões especiais. É possível salvar uma consulta particular em qualquer projeto, mas somente você poderá ver, atualizar ou excluir a consulta.
  • Consultas salvas para envolvidos no projeto:
    • Para criar uma consulta salva para envolvidos no projeto, é preciso ter permissões bigquery.savedqueries.create. O papel predefinido bigquery.admin inclui permissões bigquery.savedqueries.create.
    • Para ver uma consulta salva para envolvidos no projeto, é preciso ter permissões bigquery.savedqueries.get e bigquery.savedqueries.list. Os papéis predefinidos bigquery.admin e bigquery.user incluem as permissões bigquery.savedqueries.get e bigquery.savedqueries.list.
    • Para atualizar uma consulta salva para envolvidos no projeto, é preciso ter permissões bigquery.savedqueries.update. O papel predefinido bigquery.admin inclui permissões bigquery.savedqueries.update.
    • Para excluir uma consulta salva para envolvidos no projeto, é preciso ter permissões bigquery.savedqueries.delete. O papel predefinido bigquery.admin inclui permissões bigquery.savedqueries.delete.
  • Consultas salvas públicas:
    • A criação de consultas públicas não requer permissões especiais. É possível salvar uma consulta pública em qualquer projeto, mas somente você poderá atualizar ou excluir a consulta. Qualquer pessoa com o link pode ver uma consulta salva pública.

Para mais informações sobre papéis do IAM no BigQuery, consulte Controle de acesso.

Como criar uma consulta salva particular

Quando você salva uma consulta e define a visibilidade como Particular, a consulta pode ser visualizada, atualizada ou excluída apenas por você.

Para criar uma consulta compartilhada particular:

Console

  1. Abra a IU da Web do BigQuery no Console do GCP.
    Acessar o Console do GCP

  2. Clique em Escrever nova consulta.

  3. Insira uma consulta SQL válida na área de texto do Editor de consultas. Por exemplo, use a consulta do Guia de início rápido da IU da Web.

    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10
  4. Clique em Salvar consulta.

  5. Na caixa de diálogo Salvar consulta, insira um nome para sua consulta, defina a Visibilidade como Pessoal (editável somente por você) e clique em Salvar.

    Salvar consulta particular

  6. Para ver sua consulta salva, clique em Consultas salvas. A página de Consultas pessoais deve estar aberta por padrão.

  7. Clique no nome da consulta salva para expandi-la.

  8. Clique em Compartilhar URL de consulta para acessar o link compartilhável e copiá-lo para a área de transferência. Como alternativa, acesse o link por meio do ícone do botão Compartilhamento de link acima da área de texto do Editor de consultas.

  9. Compartilhe o link com outro membro da sua equipe.

IU clássica

  1. Acesse a IU da Web do BigQuery.
    Acessar a IU da Web do BigQuery (em inglês)

  2. Clique em Compose query.

  3. Insira uma consulta SQL na área de texto New Query. Por exemplo, use a consulta do início rápido da IU da Web clássica.

    #standardSQL
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10
  4. Clique em Save Query para abrir a caixa de diálogo Save Query.

  5. Na caixa de diálogo Save Query, insira um nome para a consulta salva, deixe Visibility definida como Private (Visible only to you) e clique em OK.

    Caixa de diálogo "Salvar consulta"

  6. Para ver a consulta salva, verifique se Query History está selecionado na navegação à esquerda e clique em Saved Queries na seção Queries.

    Lista de consultas salvas

Como compartilhar uma consulta salva

Para compartilhar uma consulta, defina a visibilidade como Projeto ou Pública ao salvar a consulta. Com a visibilidade do projeto, os membros dos papéis predefinidos do Cloud IAM do BigQuery que têm as permissões obrigatórias podem ver, atualizar ou excluir 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 executar a consulta, os usuários precisam ter acesso aos dados acessados por ela. Para mais informações, consulte Como controlar o acesso a conjuntos de dados.

Ao compartilhar uma consulta, inclua um comentário que a descreva, como mostrado no exemplo a seguir.

Como criar uma consulta salva para envolvidos no projeto

Para compartilhar uma consulta com outro membro do projeto:

Console

  1. Abra a IU da Web do BigQuery no Console do GCP.
    Acessar o Console do GCP

  2. Clique em Escrever nova consulta.

  3. Insira uma consulta SQL do BigQuery válida na área de texto do editor de consultas. Por exemplo, use a consulta do Guia de início rápido da IU da Web.

    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10
  4. Clique em Salvar consulta.

  5. Na caixa de diálogo Salvar consulta, insira um nome para sua consulta, defina a Visibilidade como Projeto (editável pelos membros do projeto) e clique em Salvar.

    Salvar projeto de consulta

  6. Para ver sua consulta salva, clique em Consultas salvas no painel de navegação à esquerda e clique em Consultas do projeto.

    Guia de consultas do projeto

  7. Clique no nome da consulta salva para expandi-la.

  8. Clique em Compartilhar URL de consulta para acessar o link compartilhável e copiá-lo para a área de transferência. Como alternativa, acesse o link por meio do ícone do botão Compartilhamento de link acima da área de texto do Editor de consultas.

  9. Compartilhe o link com outro membro da sua equipe.

IU clássica

  1. Acesse a IU da Web do BigQuery.
    Acessar a IU da Web do BigQuery (em inglês)

  2. Clique em Compose Query.

  3. Insira uma consulta SQL na área de texto New Query. Por exemplo, use a consulta do início rápido da IU da Web clássica.

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10
  4. Clique em Save Query para abrir a caixa de diálogo Save Query.

  5. Na caixa de diálogo Save Query, insira um nome para a consulta salva, defina Visibility como Project (Project members can view and edit) e clique em OK.

    Compartilhar projeto de consulta

  6. Para ver a consulta salva, verifique se Query History está selecionado na navegação à esquerda e clique em Project Queries na seção Queries.

    Lista de consultas do projeto

  7. Clique no nome da consulta salva para expandi-la.

    Consulta do projeto expandida

  8. Clique em Share Link para acessar o link compartilhável e copiá-lo para a área de transferência.

    Link de compartilhamento de consulta do projeto

    Se preferir, acesse-o pelo ícone de link acima da área de texto New Query.

    Ícone de link da consulta

  9. Compartilhe o link com outro membro da sua equipe.

Como criar uma consulta salva pública

Para compartilhar uma consulta com qualquer pessoa:

Console

Atualmente, não é possível criar uma consulta salva pública usando o Console do GCP.

IU clássica

  1. Acesse a IU da Web do BigQuery.
    Acessar a IU da Web do BigQuery (em inglês)

  2. Clique em Compose Query.

  3. Insira uma consulta SQL na área de texto New Query. Por exemplo, use a consulta do início rápido da IU da Web clássica.

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10
  4. Clique em Save Query para abrir a caixa de diálogo Save Query.

  5. Na caixa de diálogo Save Query, insira um nome para a consulta salva, defina Visibility como Public (Anyone with the link can view, but not edit) e clique em OK.

    Compartilhar consulta pública

  6. Para ver a consulta salva, verifique se Query History está selecionado na navegação à esquerda e clique em Saved Queries na seção Queries.

    Lista de consultas públicas salvas

  7. Clique no nome da consulta salva pública para expandi-la.

    Consulta pública expandida

  8. Clique em Compartilhar link para acessar o link compartilhável e copiá-lo para a área de transferência.

    Link de compartilhamento de consulta pública

    Se preferir, acesse-o pelo ícone de link acima da área de texto New Query.

    Ícone de link da consulta pública

  9. Compartilhe o link.

Como atualizar consultas salvas

Para atualizar uma consulta salva:

Console

  1. Abra a IU da Web do BigQuery no Console do GCP.
    Acessar o Console do GCP

  2. Clique em Consultas salvas na navegação à esquerda e clique em Consultas pessoais (para editar uma consulta particular) ou em Consultas de projeto (para editar uma consulta para envolvidos no projeto). Clique na sua consulta para expandi-la.

  3. À direita da consulta, clique em Abrir consulta no editor.

    Atualizar consulta

  4. Modifique a consulta.

  5. Clique em Salvar consulta para atualizar a consulta sem alterar o nome. Se você quiser alterar o nome, clique na seta para baixo ao lado de Salvar consulta e selecione Salvar como, fazendo atualizações na caixa de diálogo conforme necessário.

IU clássica

  1. Acesse a IU da Web do BigQuery.
    Acessar a IU da Web do BigQuery (em inglês)

  2. Clique em Query History na navegação à esquerda e, na seção Queries, clique em Saved Queries (para editar uma consulta particular) ou em Project Queries (para editar uma consulta para envolvidos no projeto ou pública).

    Lista de consultas do projeto

  3. À direita da consulta, clique em Edit Query.

    Botão "Editar consulta"

  4. Modifique a consulta.

  5. Clique em Save Query para abrir a caixa de diálogo Save Query.

  6. Na caixa de diálogo Save Query, deixe o nome inalterado e clique em OK.

Como excluir consultas salvas

Para excluir uma consulta salva:

Console

  1. Abra a IU da Web do BigQuery no Console do GCP.
    Acessar o Console do GCP

  2. Clique em Consultas salvas na navegação à esquerda e clique em Consultas pessoais (para excluir uma consulta particular) ou em Consultas do projeto (para excluir uma consulta para envolvidos no projeto). Clique na sua consulta para expandi-la.

  3. Clique em Excluir à direita da consulta.

    Excluir consulta

  4. Quando solicitado, clique em Excluir para confirmar.

IU clássica

  1. Acesse a IU da Web do BigQuery.
    Acessar a IU da Web do BigQuery (em inglês)

  2. Clique em Query History na navegação à esquerda.

  3. À direita da consulta, clique no botão Delete saved query (X).

  4. Quando solicitado, clique em OK para confirmar.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.