Usar o modelador visual de gráficos do BigQuery

Para pedir suporte ou enviar feedback sobre esse recurso, envie um e-mail para bq-graph-preview-support@google.com.

Este documento descreve como usar o modelador de gráficos visuais no BigQuery Studio para definir nós e arestas das tabelas do BigQuery, além de como editar e consultar dados de gráficos. Também é possível criar um gráfico usando a instrução CREATE PROPERTY GRAPH.

Funções exigidas

Para receber as permissões necessárias para criar e consultar grafos, peça ao administrador para conceder a você o papel do IAM de Editor de dados do BigQuery (roles/bigquery.dataEditor) no conjunto de dados em que você cria as tabelas de nós, de arestas e o grafo. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Criar um gráfico

Para criar um gráfico usando o modelador visual, siga estas etapas:

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

    Acessar o BigQuery

  2. Para abrir a galeria, na barra de guias do editor, clique na seta ao lado de Consulta SQL e clique em Gráfico.

  3. No campo Nome do gráfico, insira um nome para o gráfico.

  4. No campo Destino do gráfico no conjunto de dados, faça o seguinte:

  5. Selecione as tabelas que você quer usar como fontes de dados.

  6. Clique em Criar. O BigQuery cria o recurso de gráfico e leva você ao modelador visual.

Ver um gráfico

Para ver um gráfico, siga estas etapas:

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

    Acessar o BigQuery

  2. No painel de navegação, clique em Explorer:

  3. No painel Explorer, expanda o projeto e clique em Conjuntos de dados.

  4. Clique no conjunto de dados que contém seu gráfico.

  5. Clique na guia Gráficos.

  6. Selecione o gráfico que você quer ver.

Editar um gráfico

Depois de criar um gráfico, use o modelador visual para adicionar, editar ou remover nós e arestas. As seções a seguir descrevem como editar um gráfico.

Gerenciar nós

Esta seção descreve como gerenciar nós de gráficos.

Adicionar um nó

Para adicionar um nó, siga estas etapas. As mudanças feitas só serão aplicadas quando você publicar as alterações.

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

    Acessar o BigQuery

  2. No painel de navegação, clique em Explorer:

  3. No painel Explorer, expanda o projeto e clique em Conjuntos de dados.

  4. Clique no conjunto de dados que contém seu gráfico.

  5. Clique na guia Gráficos.

  6. Selecione o gráfico que você quer editar.

  7. Na barra de ações do gráfico, clique em Novo nó.

  8. No painel Adicionar nó, clique em Adicionar tabela.

  9. No painel Selecionar tabela, escolha a tabela do conjunto de dados que você quer adicionar e clique em Adicionar.

  10. Clique em Editar chave principal.

  11. Selecione os campos que você quer usar como chaves primárias e clique em Adicionar.

  12. Opcional: clique em Adicionar rótulo.

    1. No campo Nome, insira um nome para o rótulo.
    2. No campo Descrição, insira uma descrição do rótulo.
    3. No campo Sinônimos, insira até oito sinônimos.
    4. Clique em Add property.

    5. No painel Selecionar campos, escolha todas as propriedades que você quer adicionar ao rótulo.

      Opcional: você pode adicionar um campo personalizado com uma métrica. Para mais informações, consulte Medidas de gráfico.

    6. Clique em Adicionar.

    7. Clique em Concluído.

  13. Clique em Concluído.

Editar um nó

Para editar um nó, siga estas etapas. As mudanças feitas só serão aplicadas quando você publicar as alterações.

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

    Acessar o BigQuery

  2. No painel de navegação, clique em Explorer:

  3. No painel Explorer, expanda o projeto e clique em Conjuntos de dados.

  4. Clique no conjunto de dados que contém seu gráfico.

  5. Clique na guia Gráficos.

  6. Selecione o gráfico que você quer editar.

  7. No gráfico, selecione o nó que você quer editar.

  8. Na janela de nó, clique em Editar.

  9. No painel Editar nó, clique em Editar chave primária.

  10. Selecione os campos que você quer usar como chaves primárias e clique em Adicionar.

  11. Opcional: clique em Adicionar rótulo.

    1. No campo Nome, insira um nome para o rótulo.
    2. No campo Descrição, insira uma descrição do rótulo.
    3. No campo Sinônimos, insira até oito sinônimos.
    4. Clique em Add property.
    5. No painel Selecionar campos, escolha todas as propriedades que você quer adicionar ao rótulo.
    6. Clique em Adicionar.
    7. Opcional: clique em Adicionar métrica para incluir um campo personalizado com uma métrica, conforme descrito em Métricas de gráfico.
    8. Clique em Concluído.

  12. Clique em Concluído.

Remover um nó

Para remover um nó, siga estas etapas. As mudanças feitas só serão aplicadas quando você publicar as alterações.

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

    Acessar o BigQuery

  2. No painel de navegação, clique em Explorer:

  3. No painel Explorer, expanda o projeto e clique em Conjuntos de dados.

  4. Clique no conjunto de dados que contém seu gráfico.

  5. Clique na guia Gráficos.

  6. Selecione o gráfico que você quer editar.

  7. No gráfico, selecione o nó a ser removido.

  8. Na janela de nó, clique em Remover.

  9. Clique em Excluir.

Gerenciar arestas

Esta seção descreve como gerenciar arestas de gráficos.

Adicionar uma borda

Para adicionar uma aresta, siga estas etapas. As mudanças feitas só serão aplicadas quando você publicar as alterações.

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

    Acessar o BigQuery

  2. No painel de navegação, clique em Explorer:

  3. No painel Explorer, expanda o projeto e clique em Conjuntos de dados.

  4. Clique no conjunto de dados que contém seu gráfico.

  5. Clique na guia Gráficos.

  6. Selecione o gráfico que você quer editar.

  7. Na barra de ações do gráfico, clique em Nova aresta.

  8. No painel Adicionar aresta, clique em Adicionar tabela.

  9. No painel Selecionar tabela, escolha a tabela que você quer usar como fonte de dados e clique em Adicionar.

  10. Na lista Nó de origem, selecione o nó que você quer usar como origem.

  11. Clique em Adicionar colunas referenciadas no nó.

    1. Selecione os campos que você quer referenciar.
    2. Clique em Adicionar.

  12. Na lista Nó de destino, selecione o nó que você quer usar como destino.

  13. Clique em Adicionar colunas referenciadas no nó.

    1. Selecione os campos que você quer referenciar.
    2. Clique em Adicionar.

  14. Clique em Adicionar colunas referenciadas na borda.

    1. Selecione os campos que você quer referenciar. O número de colunas e os tipos de dados dessas colunas de extremidade precisam corresponder às colunas referenciadas selecionadas para os nós de origem e destino.
    2. Clique em Adicionar.

  15. Opcional: clique em Adicionar rótulo.

    1. No campo Nome, insira um nome para o rótulo.
    2. No campo Descrição, insira uma descrição do rótulo.
    3. No campo Sinônimos, insira até oito sinônimos.
    4. Clique em Add property.
    5. No painel Selecionar campos, escolha todas as propriedades que você quer adicionar ao rótulo.
    6. Clique em Adicionar.
    7. Opcional: clique em Adicionar métrica para incluir um campo personalizado com uma métrica, conforme descrito em Métricas de gráfico.
    8. Clique em Concluído.

  16. Clique em Concluído.

Editar uma borda

Para editar uma aresta, siga estas etapas. As mudanças feitas só serão aplicadas quando você publicar as alterações.

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

    Acessar o BigQuery

  2. No painel de navegação, clique em Explorer:

  3. No painel Explorer, expanda o projeto e clique em Conjuntos de dados.

  4. Clique no conjunto de dados que contém seu gráfico.

  5. Clique na guia Gráficos.

  6. Selecione o gráfico que você quer editar.

  7. No gráfico, selecione a aresta que você quer editar.

  8. Na janela de nó, clique em Editar.

  9. No painel Editar aresta, na lista Nó de origem, selecione o nó que você quer usar como origem.

  10. Clique em Adicionar colunas referenciadas no nó.

    1. Selecione os campos que você quer referenciar.
    2. Clique em Adicionar.

  11. Na lista Nó de destino, selecione o nó que você quer usar como destino.

  12. Clique em Adicionar colunas referenciadas no nó.

    1. Selecione os campos que você quer referenciar.
    2. Clique em Adicionar.

  13. Clique em Adicionar colunas referenciadas na borda.

    1. Selecione os campos que você quer referenciar. O número de colunas e os tipos de dados dessas colunas de extremidade precisam corresponder às colunas referenciadas selecionadas para os nós de origem e destino.
    2. Clique em Adicionar.

  14. Opcional: clique em Adicionar rótulo.

    1. No campo Nome, insira um nome para o rótulo.
    2. No campo Descrição, insira uma descrição do rótulo.
    3. No campo Sinônimos, insira até oito sinônimos.
    4. Clique em Add property.
    5. No painel Selecionar campos, escolha todas as propriedades que você quer adicionar ao rótulo.
    6. Clique em Adicionar.
    7. Opcional: clique em Adicionar métrica para incluir um campo personalizado com uma métrica, conforme descrito em Métricas de gráfico.
    8. Clique em Concluído.

  15. Clique em Concluído.

Remover uma borda

Para remover uma aresta, siga estas etapas. As mudanças feitas só serão aplicadas quando você publicar as alterações.

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

    Acessar o BigQuery

  2. No painel de navegação, clique em Explorer:

  3. No painel Explorer, expanda o projeto e clique em Conjuntos de dados.

  4. Clique no conjunto de dados que contém seu gráfico.

  5. Clique na guia Gráficos.

  6. Selecione o gráfico que você quer editar.

  7. No gráfico, selecione a aresta que você quer remover.

  8. Na janela de nó, clique em Remover.

  9. Confirme a exclusão.

Publicar mudanças no gráfico

Para salvar as modificações, publique-as no recurso de gráfico. Siga estas etapas:

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

    Acessar o BigQuery

  2. No painel de navegação, clique em Explorer:

  3. No painel Explorer, expanda o projeto e clique em Conjuntos de dados.

  4. Clique no conjunto de dados que contém seu gráfico.

  5. Clique na guia Gráficos.

  6. Selecione o gráfico que você quer editar.

  7. Depois de terminar a edição, clique em Publicar.

  8. Revise a instrução CREATE PROPERTY GRAPH no painel Publicar gráfico e clique em Publicar.

A seguir