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 IAM do BigQuery com as permissões obrigatórias.
  • Pública: as consultas salvas públicas permanecem visíveis para qualquer pessoa com o link de consulta.

Permissões

As seguintes permissões 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 do IAM bigquery.admin predefinido no nível do projeto 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 do IAM bigquery.admin e bigquery.user predefinidos no nível do projeto incluem 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 do IAM bigquery.admin predefinido no nível do projeto inclui permissões bigquery.savedqueries.update.
    • Para excluir uma consulta salva para envolvidos no projeto, é preciso ter permissões bigquery.savedqueries.delete. O papel do IAM bigquery.admin predefinido no nível do projeto inclui permissões bigquery.savedqueries.delete.
  • Consultas públicas salvas:
    • 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 a IU da Web do BigQuery

  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 do BigQuery.

    #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 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 privada

  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 copiar o link para a área de transferência. Como alternativa, você pode acessar 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

  2. Clique em Escrever consulta.

  3. Insira uma consulta SQL na área de texto Nova consulta. 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 Salvar consulta para abrir a caixa de diálogo Salvar consulta.

  5. Na caixa de diálogo Salvar consulta, digite um nome para a consulta salva, deixe a Visibilidade definida como Particular (visível somente para você) e clique em OK.

    Caixa de diálogo "Salvar consulta"

  6. Para ver a consulta salva, verifique se Histórico de consultas está selecionado na navegação à esquerda e clique em Consultas salvas na seção Consultas.

    Lista de consultas salvas

Como compartilhar uma consulta salva

Para compartilhar uma consulta, defina a visibilidade como Projeto ou Público quando você salvar a consulta. A visibilidade do projeto permite que membros dos papéis IAM do BigQuery predefinidos com as permissões obrigatórias vejam, 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 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 no nível do projeto

Para compartilhar uma consulta com outro membro do projeto:

Console

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

  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 do BigQuery.

    #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 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 copiar o link para a área de transferência. Como alternativa, você pode acessar 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

  2. Clique em Escrever consulta.

  3. Insira uma consulta SQL na área de texto Nova consulta. 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 Salvar consulta para abrir a caixa de diálogo Salvar consulta.

  5. Na caixa de diálogo Salvar consulta, insira um nome para a consulta salva, defina a Visibilidade como Projeto (os membros do projeto podem ver e editar) e clique em OK.

    Compartilhar projeto de consulta

  6. Para ver a consulta salva, verifique se Histórico de consultas está selecionado na navegação à esquerda e clique em Consultas de projeto na seção Consultas.

    Lista de consultas do projeto

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

    Consulta do projeto expandida

  8. Clique em Compartilhar link para acessar o link compartilhável e o copie 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 Nova consulta.

    Í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 pública salva usando o Console do GCP.

IU clássica

  1. Acesse a IU da Web do BigQuery.
    Acessar a IU da Web do BigQuery

  2. Clique em Escrever consulta.

  3. Insira uma consulta SQL na área de texto Nova consulta. 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 Salvar consulta para abrir a caixa de diálogo Salvar consulta.

  5. Na caixa de diálogo Salvar consulta, insira um nome para a consulta salva, defina a Visibilidade como Pública (qualquer pessoa com o link pode ver, mas não editar) e clique em OK.

    Compartilhar consulta pública

  6. Para ver a consulta salva, verifique se Histórico de consultas está selecionado na navegação à esquerda e clique em Consultas salvas na seção Consultas.

    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 Nova consulta.

    Í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 a IU da Web do BigQuery

  2. Clique em Consultas salvas na navegação à esquerda e clique em Consultas pessoais (para editar uma consulta privada) 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

  2. Clique em Histórico de consultas na navegação à esquerda e, na seção Consultas, clique em Consultas salvas (para editar uma consulta particular) ou em Consultas de projeto (para editar uma consulta no nível do projeto ou pública).

    Lista de consultas do projeto

  3. À direita da consulta, clique em Editar consulta.

    Botão "Editar consulta"

  4. Modifique a consulta.

  5. Clique em Salvar consulta para abrir a caixa de diálogo Salvar consulta.

  6. Na caixa de diálogo Salvar consulta, 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 a IU da Web do BigQuery

  2. Clique em Consultas salvas na navegação à esquerda e clique em Consultas pessoais (para excluir uma consulta privada) ou em Consultas de 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

  2. Clique em Histórico de consultas na navegação à esquerda.

  3. À direita da consulta, clique no botão Excluir consulta salva (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.