Como usar a tela de modelagem visual

Pré-lançamento: esse recurso está sujeito aos Termos da oferta pré-GA na seção Termos gerais de serviço dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Se você encontrar um problema ou tiver feedback durante o acesso antecipado do canvas de modelagem visual, informe o problema para [e-mail].

O canvas de modelagem visual no Looker permite que você se conecte a fontes de dados do BigQuery para criar e editar modelos de dados do LookML usando um canvas interativo de arrastar e soltar. Com o canvas de modelagem visual, é possível mesclar tabelas visualmente, definir dimensões e medidas, visualizar os resultados da consulta em tempo real e publicar análises sem escrever código LookML.

Componentes do canvas

O canvas de modelagem visual inclui os seguintes componentes do espaço de trabalho e guias de navegação:

• Banco de dados Fontes : uma barra lateral pesquisável que mostra os conjuntos de dados, tabelas e visualizações de banco de dados disponíveis na conexão ativa
• Canvas visual graph_4: o espaço de trabalho principal em que você arrasta tabelas, organiza nós de tabelas e define relações de mesclagem
• Código LookML code: um painel que mostra o código LookML gerado que está por trás do seu modelo visual
• Visualização de dados table_chart: um painel inferior recolhível que mostra uma visualização de consulta em tempo real (LIMIT 100) do conjunto de dados mesclado
• Editor de campos edit_attributes: um painel para adicionar, renomear e personalizar dimensões e medidas

Antes de começar

Para usar o canvas de modelagem visual, você precisa ter o seguinte:

• Uma instância do Looker que executa a versão 26.14 ou mais recente, configurada por um admin do Looker para ativar as análises de autoatendimento
• Uma conexão de banco de dados do BigQuery configurada com as seguintes definições:
  • Configurada com o escopo Todos os projetos na guia Bancos de dados da página Conexões
  • Configurada para autenticação com OAuth
• Uma conta de usuário do Looker com a create_self_service_from_table permissão
• Uma Conta do Google com os seguintes papéis do IAM para as tabelas de destino do BigQuery:
  • bigquery.jobUser
  • bigquery.dataViewer

Criar um modelo visual

As seções a seguir mostram as etapas para criar um novo modelo de dados usando o canvas de modelagem visual:

1. Conectar ao seu banco de dados
2. Adicionar tabelas ao canvas
3. Definir relações e mesclagens
4. Adicionar e configurar medidas e dimensões
5. Visualizar seus dados em tempo real
6. Conferir o LookML do seu modelo
7. Publicar seu modelo em uma análise

Conectar ao seu banco de dados

Para se conectar ao seu banco de dados, siga estas etapas:

1. No Looker, clique no botão Criar na navegação principal.
2. Selecione Fonte de dados.
3. Na caixa de diálogo Criar fonte de dados, selecione a guia Conectar ao banco de dados.
4. Escolha uma conexão de banco de dados no menu suspenso Conexão do BigQuery.
5. Especifique seu projeto:
   • Selecione Selecionar na lista para escolher entre os projetos disponíveis na conexão.
   • Selecione Inserir manualmente para digitar o ID do projeto diretamente.
6. Especifique se quer incluir todas as tabelas ou selecionar tabelas específicas:
   • Selecione Incluir todos os conjuntos de dados e tabelas neste projeto selecionado para começar com um canvas vazio. No canvas vazio, você pode adicionar tabelas da sua lista de fontes.
   • Selecione Escolher uma tabela específica para especificar um único conjunto de dados e tabela a serem adicionados ao canvas. O canvas de modelagem visual será aberto no editor de campos e carregará os campos da tabela selecionada. Você pode clicar em Canvas visual graph_4 na barra de navegação para ver a tabela no canvas. Você pode adicionar outras tabelas da sua lista de fontes.
7. Clique em Continuar para abrir o canvas de modelagem visual.

Adicionar tabelas ao canvas

Para adicionar tabelas ao canvas e começar a modelar seus dados, siga estas etapas:

1. Na barra lateral do banco de dados Fontes, navegue ou pesquise os conjuntos de dados, tabelas ou visualizações que você quer modelar.
2. Arraste cada tabela da barra lateral para o canvas.
3. Reposicione os nós da tabela no canvas para organizar o layout do modelo de dados.

Quando você arrasta uma tabela para o canvas, o canvas de modelagem visual a representa como um nó de tabela. O canvas mostra o nome da tabela e o ID do projeto e do conjunto de dados do BigQuery. A primeira tabela adicionada ao canvas é marcada como Visualização de base.

Definir relações e mesclagens

Quando você adiciona mais de uma tabela ao canvas, o canvas de modelagem visual procura nomes de colunas correspondentes (por exemplo, order_id em orders e order_items) e propõe automaticamente uma linha de conexão de mesclagem entre as tabelas.

Para modificar ou criar relações entre tabelas no seu banco de dados, siga estas etapas:

1. Clique na linha de conexão de mesclagem entre dois nós de tabela para abrir o painel Configuração de mesclagem. Configure a mesclagem no painel Configuração de mesclagem :
   • Tipo de mesclagem: selecione o tipo de mesclagem (Externa à esquerda, Interna ou Externa completa). Por padrão, o Looker usa uma mesclagem externa à esquerda.
   • Relacionamento (cardinalidade): selecione o tipo de relacionamento (Um para um, Um para muitos, Muitos para um ou Muitos para muitos).
   • Cláusula de mesclagem: revise as chaves de mesclagem sugeridas automaticamente ou adicione condições de mesclagem personalizadas. É possível especificar várias condições de mesclagem (como orders.id = order_items.order_id AND orders.date = order_items.date).
2. Resolver erros de mesclagem: se uma mesclagem criar um caminho SQL inválido ou uma referência circular, a linha de conexão ficará vermelha com uma dica explicativa. Ajuste as chaves de mesclagem ou a cardinalidade do relacionamento para resolver o erro.
3. Se você tiver mudado as configurações de mesclagem, clique em Aplicar para aplicar as mudanças à mesclagem.

Adicionar e configurar medidas e dimensões

O canvas de modelagem visual configura automaticamente dimensões e medidas para suas tabelas e permite adicionar cálculos personalizados. Por padrão, o canvas de modelagem visual cria uma medida do tipo count ou sum para campos numéricos, mantendo os campos com nomes que contêm ID, Key ou Code como dimensões numéricas. Quando você define um relacionamento Um para muitos, o canvas de modelagem visual aplica automaticamente a lógica de agregação simétrica para evitar erros de cálculo de valores duplicados e de distribuição de dados.

Não é possível excluir um campo gerado. Você só pode ocultá-lo selecionando Ocultar no menu de engrenagem do campo no editor de campos ou clicando no ícone Editar editar do campo e selecionando a caixa de seleção Ocultar este campo das análises e visualizações.

Para conferir os campos de uma tabela, selecione o nó da tabela no canvas e clique em Editar campos.

No editor de campos, é possível realizar as seguintes tarefas:

• Editar uma dimensão
• Editar uma medida
• Criar uma dimensão personalizada
• Criar uma medida personalizada

Editar uma dimensão

Para editar uma dimensão, siga estas etapas:

1. No canvas de modelagem visual, selecione um nó de tabela no canvas e clique em Editar campos para abrir o editor de campos.
2. No editor de campos, clique na guia Dimensões.
3. Encontre a dimensão que você quer editar e clique no ícone Editar editar do campo para abrir a caixa de diálogo Editar dimensão.
4. Atualize qualquer um dos seguintes campos (o campo Tipo de dados é somente leitura):
   • Formato: selecione uma opção de formatação no menu suspenso.
   • Nome: edite o nome usado para identificar a dimensão no LookML e nas expressões.
   • Marcador: edite o marcador que aparece nas análises e visualizações.
   • + Adicionar descrição: clique nessa opção para inserir ou editar uma descrição opcional da dimensão.
   • Ocultar este campo das análises e visualizações: selecione ou desmarque essa caixa de seleção para ocultar ou mostrar a dimensão.
5. Clique em Salvar.

Editar uma medida

Para editar uma medida, siga estas etapas:

1. No canvas de modelagem visual, selecione um nó de tabela no canvas e clique em Editar campos para abrir o editor de campos.
2. No editor de campos, clique na guia Medidas.
3. Encontre a medida que você quer editar e clique no ícone Editar editar do campo para abrir a caixa de diálogo Editar medida.

4. Atualize qualquer um dos seguintes campos:

   Observação: Para medidas de contagem, só é possível editar Marcador, Formato, Descrição e Ocultar este campo das análises e visualizações.
   • Campo a ser medido: selecione o campo que você quer agregar no menu suspenso.
   • Tipo de medida: selecione o tipo de agregação (como Soma, Contagem, Média, Mínimo ou Máximo) no menu suspenso.
   • Marcador: edite o marcador que aparece nas análises e visualizações.
   • Guia "Filtros": em Restringir resultados, selecione um campo no menu suspenso Nome do filtro e especifique um Valor do filtro. Use os botões + e - para adicionar ou remover condições de filtro.
   • Guia "Detalhes do campo": selecione uma opção de formatação no menu suspenso Formato e insira uma Descrição opcional (até 255 caracteres).
   • Ocultar este campo das análises e visualizações: selecione ou desmarque essa caixa de seleção para ocultar ou mostrar a medida.

5. Clique em Salvar.

Criar uma dimensão personalizada

Para criar uma dimensão personalizada usando uma expressão do Looker, siga estas etapas:

1. No canvas de modelagem visual, selecione um nó de tabela no canvas e clique em Editar campos para abrir o editor de campos.
2. No editor de campos do canvas de modelagem visual, clique em Adicionar dimensão para abrir a caixa de diálogo Criar dimensão.
3. Na caixa do editor de expressões, insira uma expressão do Looker que defina a dimensão ou clique em Me ajude a escrever uma expressão com o Gemini para gerar uma expressão.
4. Selecione uma opção de formatação no menu suspenso Formato.
5. Insira um Nome e um Marcador para a dimensão.
6. Opcional: clique em + Adicionar descrição para inserir ou editar uma descrição da dimensão.
7. Opcional: selecione a caixa de seleção Ocultar este campo das análises e visualizações para ocultar a dimensão.
8. Clique em Salvar.

Criar uma medida personalizada

Para criar uma medida personalizada, siga estas etapas:

1. No canvas de modelagem visual, selecione um nó de tabela no canvas e clique em Editar campos para abrir o editor de campos.
2. No editor de campos, clique na guia Medidas e em Adicionar medida para abrir a caixa de diálogo Criar medida.
3. Selecione o campo que você quer agregar no menu suspenso Campo a ser medido.
4. No menu suspenso Tipo de medida, selecione o tipo de agregação que você quer realizar no campo Campo a ser medido.
5. Insira um Marcador para a medida.
6. Configure condições de filtro opcionais ou detalhes de formatação:
   • Guia "Filtros": em Restringir resultados, selecione um campo no menu suspenso Nome do filtro e especifique um Valor do filtro. Use os botões + e - para adicionar ou remover condições de filtro.
   • Guia "Detalhes do campo": selecione uma opção de formatação no menu suspenso Formato e insira uma Descrição opcional (até 255 caracteres).
7. Opcional: selecione a caixa de seleção Ocultar este campo das análises e visualizações para ocultar a medida.
8. Clique em Salvar.

Visualizar seus dados em tempo real

Siga estas etapas para verificar a saída de dados do seu modelo:

1. No canvas de modelagem visual, clique na guia Visualização de dados table_chart na barra de navegação.
2. Clique em uma tabela no canvas para selecionar campos dessa tabela.
3. No painel de visualização de dados, clique no menu suspenso Visualizar colunas.

4. No menu suspenso, selecione os campos da tabela que você quer consultar e clique em Visualizar.

   O canvas de modelagem visual vai consultar seu banco de dados e mostrar os resultados da consulta em uma tabela no painel de visualização de dados.

5. Inspecione os dados para garantir que não ocorram distribuição de dados de linha não intencional ou registros descartados.

6. Atualize as mesclagens ou os campos conforme necessário e clique em Atualizar esquema no painel de visualização de dados para atualizar a tabela.

Conferir o LookML

Clique na guia Código LookML code para inspecionar o LookML gerado para seu modelo. O LookML para modelos visuais é somente leitura. Se você quiser editar campos e mesclagens, use o canvas de modelagem visual.

Publicar seu modelo em uma análise

Para salvar seu modelo, clique no botão Explorar dados no canvas de modelagem visual.

O Looker gera os arquivos de modelo LookML subjacentes e salva as coordenadas de layout do canvas. Seu modelo agora está publicado e pronto para ser consultado.

Acessar modelos visuais

Os modelos visuais publicados aparecem na navegação do Looker em Analisar na seção Análises de autoatendimento.

Para consultar um modelo visual, siga estas etapas:

1. No Looker, clique em Analisar na navegação principal.
2. Em Análises de autoatendimento, selecione o nome da análise do seu modelo.
3. Selecione dimensões e medidas no seletor de campos, adicione filtros e execute consultas para criar visualizações e blocos de painel.

Editar um modelo visual

Para modificar um modelo criado com o canvas de modelagem visual, siga estas etapas:

1. No Looker, clique em Analisar no menu de navegação principal.
2. Em Análises de autoatendimento, abra a análise do modelo que você quer editar.
3. Selecione Editar modelo no seletor de campos da análise para abrir o canvas de modelagem visual. Se você estiver usando a experiência clássica de análise, selecione Editar modelo no menu de engrenagem da análise.
4. Faça as mudanças no canvas de modelagem visual (como adicionar tabelas, atualizar cláusulas de mesclagem ou criar novas medidas).
5. Clique em Explorar dados para atualizar o modelo.

Observação: se vários usuários editarem o mesmo modelo visual, a versão salva mais recentemente será mantida.

Excluir um modelo visual

Para excluir um modelo visual, siga estas etapas:

1. No Looker, clique em Analisar no menu de navegação principal.
2. Em Análises de autoatendimento, abra a análise do modelo que você quer editar.
3. Selecione Editar modelo no seletor de campos da análise para abrir o canvas de modelagem visual. Se você estiver usando a experiência clássica de análise, selecione Editar modelo no menu de engrenagem da análise.
4. No canvas de modelagem visual, selecione Excluir no menu de três pontos.