Modelar seus dados no LookML

O LookML e o ambiente de desenvolvimento integrado do Looker permitem definir modelos de dados, dimensões e relações reutilizáveis com base nas tabelas do banco de dados. Neste guia de início rápido, você vai criar um arquivo de modelo e um arquivo de visualização, configurar uma Análise e testar uma nova dimensão usando o projeto de exemplo do LookML no Looker (Google Cloud Core). Você também vai aprender a ativar o Modo de Desenvolvimento, navegar no ambiente de desenvolvimento integrado do Looker e usar a Ajuda rápida.

Antes de começar

Para acompanhar este guia de início rápido, você vai precisar do seguinte:

  • Acesso a uma instância do Looker (Google Cloud Core):

Funções exigidas

Para concluir este guia de início rápido, você precisa do papel apropriado do Identity and Access Management (IAM) e do Looker.

Papéis do Identity and Access Management

O administrador do Looker (Google Cloud Core) concede acesso ao aplicativo do Looker (Google Cloud Core) pelo sistema do Identity and Access Management do Google Cloud.

Para receber a permissão necessária para acessar o aplicativo do Looker (Google Cloud Core), peça ao administrador para conceder a você o papel do IAM de Usuário da instância do Looker (roles/looker.instanceUser) no projeto do Google Cloud que contém a instância do Looker (Google Cloud Core). Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a permissão looker.instances.login, que é necessária para acessar o aplicativo do Looker (Google Cloud Core).

Também é possível receber essa permissão com papéis personalizados ou outros papéis predefinidos.

Permissões do Looker

Você precisa de uma conta de usuário do Looker com a função de administrador do Looker ou a permissão develop.

Ativar o Modo de Desenvolvimento

Os projetos do Looker podem existir em um dos dois modos: Modo de Produção e Modo de Desenvolvimento. O Modo de Desenvolvimento permite que você faça mudanças nos arquivos do LookML e tenha uma prévia de como elas vão afetar o conteúdo na sua instância sem afetar o ambiente de produção (o que os outros usuários veem). Para mais informações, consulte a página de documentação Modo de desenvolvimento e modo de produção.

Neste guia de início rápido, você vai usar o Modo de Desenvolvimento para fazer mudanças nos arquivos do LookML e testá-las em uma Análise.

Para ativar o Modo de Desenvolvimento, siga estas etapas:

  1. Na página inicial do Looker (Google Cloud Core), clique no ícone do Menu principal do Looker para abrir o menu de navegação principal, se ainda não estiver aberto.
  2. Selecione o botão de alternância Modo de Desenvolvimento na parte de baixo do menu.

Quando o Modo de Desenvolvimento está ativado, o Looker mostra o banner Modo de Desenvolvimento na parte de cima da tela.

Um projeto do LookML é uma coleção de arquivos LookML que informam ao Looker como se conectar ao banco de dados, como consultar os dados e como apresentá-los na interface do usuário. Neste guia de início rápido, você vai usar o projeto de exemplo do LookML que é configurado automaticamente nas instâncias do Looker (Google Cloud Core).

Para acessar os arquivos de amostra do projeto do LookML no ambiente de desenvolvimento integrado do Looker, siga estas etapas:

  1. Clique no ícone do Menu principal do Looker e selecione Desenvolver, se o menu Desenvolver ainda não estiver sendo exibido.
  2. No menu Desenvolver, selecione sample_thelook_ecommerce.

O Looker vai abrir o painel Navegador de arquivos do ambiente de desenvolvimento integrado do Looker e mostrar os arquivos de amostra do projeto do LookML.

Criar uma pasta de projeto

Para manter os arquivos criados neste guia de início rápido separados dos outros arquivos no projeto de exemplo do LookML, crie uma nova pasta de projeto para os arquivos do guia de início rápido.

Para criar uma pasta no projeto, siga estas etapas:

  1. No painel Navegador de arquivos do ambiente de desenvolvimento integrado do Looker, clique no ícone Adicionar arquivo ou pasta na parte de cima do painel e selecione a opção Criar pasta no menu Adicionar arquivo ou pasta.
  2. Para o nome da nova pasta, digite quickstart.

  3. Clique em Criar.

O Looker adiciona a nova pasta ao painel Navegador de arquivos no ambiente de desenvolvimento integrado do Looker.

Mais informações sobre as pastas do ambiente de desenvolvimento integrado

Para saber mais sobre como usar pastas no seu projeto do LookML, consulte as seguintes páginas da documentação:

Criar um arquivo de modelo do LookML

Um arquivo de modelo do LookML especifica uma conexão de banco de dados e o conjunto de análises do Looker que usam essa conexão. Uma Análise é um ponto de partida para os usuários consultarem seus dados no Looker depois que eles são modelados no LookML (consulte Como visualizar e interagir com Análises no Looker).

Para criar um novo arquivo de modelo no seu projeto do LookML, siga estas etapas:

  1. No painel Navegador de arquivos do ambiente de desenvolvimento integrado do Looker, selecione o menu de três pontos Opções de pasta para a pasta quickstart que você criou no procedimento Criar uma nova pasta de projeto.
  2. No menu Opções de pasta, selecione Criar modelo.
  3. Na caixa de diálogo Criar arquivo, insira o nome quickstart_practice para o novo arquivo e clique em Criar. O Looker cria o arquivo quickstart_practice.model na pasta quickstart e abre o novo arquivo no ambiente de desenvolvimento integrado do Looker. O ponto azul ao lado do arquivo no painel Navegador de arquivos indica que o arquivo é novo.
  4. No painel Navegador de arquivos, clique na pasta quickstart para expandi-la e ver o arquivo quickstart_practice.model.
  5. No ambiente de desenvolvimento integrado do Looker, clique no arquivo quickstart_practice.model para abri-lo, se ainda não estiver aberto.

O arquivo quickstart_practice.model contém um exemplo de LookML que pode ser usado como ponto de partida para seu projeto. Por enquanto, você pode manter o arquivo como está. Mais adiante no guia de início rápido, você vai criar Análises no seu arquivo de modelo.

Mais informações sobre arquivos de modelo

Para criar seus próprios arquivos de modelo no futuro, observe os seguintes recursos:

Criar um novo arquivo de visualização do LookML

No LookML, uma visualização corresponde a uma única tabela no seu banco de dados ou a uma única tabela derivada. O arquivo de visualização especifica a tabela no banco de dados que será consultada e os campos (dimensões e medições) que serão incluídos dessa tabela. Depois de definir um campo no arquivo de visualização, use o operador de substituição $ para referenciar o campo em outras partes do LookML. Isso permite definir o campo em um único local e usá-lo em vários lugares no projeto do LookML.

Há várias maneiras de criar um novo arquivo de visualização, mas a mais fácil é deixar que o Looker gere automaticamente um arquivo de visualização com base em uma tabela do banco de dados.

Para que o Looker gere um novo arquivo de visualização, siga estas etapas:

  1. No painel Navegador de arquivos do ambiente de desenvolvimento integrado do Looker, selecione o menu de três pontos Opções de pasta para a pasta quickstart que você criou no procedimento Criar uma nova pasta de projeto.
  2. Selecione Criar visualização com base na tabela no menu Opções de pasta.
  3. Na página Criar visualização da tabela, clique no campo de entrada Inserir db personalizado e digite bigquery-public-data:

    A caixa de diálogo "Criar visualizações com base em tabelas".

  4. Pressione Enter para ver os conjuntos de dados públicos do BigQuery.

  5. Role a lista até encontrar o conjunto de dados thelook_ecommerce.

  6. Clique no conjunto de dados thelook_ecommerce para expandi-lo.

  7. Selecione a tabela order_items.

  8. Clique no botão Criar visualizações na parte de baixo da página.

O Looker mostra o arquivo de visualização order_items no ambiente de desenvolvimento integrado (IDE) do Looker. No painel do navegador de arquivos, a pasta quickstart é expandida, e o arquivo de visualização order_items é exibido com um ponto azul para indicar que é um arquivo novo.

Mais informações sobre arquivos de visualização

Para criar seus próprios arquivos de visualização no futuro, observe os seguintes recursos:

Ajuda rápida do ambiente de desenvolvimento integrado do Looker

Você criou um arquivo de modelo e um arquivo de visualização do LookML. Nas próximas etapas deste guia de início rápido, você vai começar a editar esses arquivos. Antes de começar a editar, conheça o recurso de Ajuda rápida do ambiente de desenvolvimento integrado do Looker. O painel Ajuda rápida oferece explicações e opções para o local atual do cursor nos arquivos do LookML:

  • No painel do editor do ambiente de desenvolvimento integrado, clique nos campos e parâmetros nos arquivos do LookML para que o painel Ajuda rápida mostre as opções e os subparâmetros compatíveis com esse elemento do LookML.
  • No painel Ajuda rápida, clique no nome de um parâmetro para abrir a página de documentação do Looker sobre ele.

Se o painel Ajuda rápida ainda não estiver aberto, clique no ícone Ajuda rápida no ambiente de desenvolvimento integrado do Looker:

Criar Análises para suas visualizações

Depois de realizar os procedimentos Criar um novo arquivo de modelo do LookML e Criar um novo arquivo de visualização do LookML, você pode definir uma Análise para o novo arquivo de visualização. Assim, você pode usar o Looker para consultar os dados que modelou no arquivo de visualização.

As Análises geralmente são definidas em um arquivo de modelo. É possível criar um arquivo de análise separado, mas, para os fins deste guia de início rápido, você vai criar a análise no arquivo de modelo.

No arquivo do LookML em que você define uma Análise, use o parâmetro include para referenciar o arquivo de visualização na definição da Análise. Este procedimento orienta você nessas etapas.

Para criar uma Análise para o arquivo de visualização order_items, siga estas etapas:

  1. No ambiente de desenvolvimento integrado do Looker, abra o arquivo quickstart_practice.model.
  2. No arquivo quickstart_practice.model, substitua a linha que contém o parâmetro include por esta:

    include: "/quickstart/order_items.view"
    
  3. Adicione uma nova linha abaixo do parâmetro include e insira o seguinte LookML: none explore: order_items {}

  4. Clique no botão Salvar alterações na parte de cima do ambiente de desenvolvimento integrado do Looker.

Esta Análise é o exemplo mais básico de uma Análise que permite aos usuários consultar a visualização order_items. A partir desse ponto de partida, você pode criar sua Análise de várias maneiras.

Mais informações sobre as Análises

Para criar suas próprias Análises no futuro e desenvolver suas Análises, observe os seguintes recursos:

Criar um campo

Depois de criar os arquivos de visualização na seção Criar um novo arquivo de visualização do LookML deste guia de início rápido, você poderá ver os campos que o Looker criou automaticamente. Quando você cria um arquivo de visualização com base em uma tabela de banco de dados, o Looker cria automaticamente dimensões, grupos de dimensões e medidas:

  • Uma dimensão é um campo que representa um atributo, fato ou valor que os usuários podem selecionar no seletor de campo em uma Análise e que pode ser usado para filtrar uma consulta. Se o campo não estiver dentro de uma função de agregação, como SUM, COUNT etc., ele será uma dimensão. O Looker cria automaticamente uma dimensão para cada coluna na tabela do banco de dados.
  • Um grupo de dimensões é usado para criar um conjunto de dimensões com base em tempo ou duração de uma só vez. Por exemplo, o grupo de dimensão de uma coluna de carimbo de data/hora vai conter dimensões individuais para data, mês, trimestre, hora, semana e ano. O Looker cria automaticamente um grupo de dimensão para os campos baseados em tempo que detecta na tabela do banco de dados.
  • Uma medição é um campo em uma Análise que representa informações mensuráveis sobre seus dados, como somas, contagens etc. Uma medição é declarada em um arquivo de visualização e pode ser de um tipo agregado ou não agregado. O Looker cria automaticamente uma medição de type:count para o arquivo de visualização, que é o equivalente a um COUNT(*) em SQL.

Nesta seção, você vai aprender a adicionar manualmente sua própria dimensão ao arquivo de visualização order_items.

Para criar manualmente uma nova dimensão no arquivo de visualização order_items, siga estas etapas:

  1. Abra o arquivo quickstarts/order_items.view, se ainda não estiver aberto: no painel Navegador de arquivos do ambiente de desenvolvimento integrado do Looker, clique na pasta quickstart para expandi-la e, em seguida, clique no arquivo order_items.view para abri-lo.
  2. No arquivo quickstarts/order_items.view, crie uma nova linha antes do primeiro parâmetro dimension.
  3. Na nova linha, comece a digitar dimension. Conforme você digita, o ambiente de desenvolvimento integrado do Looker exibe uma lista de possíveis parâmetros que começam com o texto digitado.

    • Use as teclas de seta para navegar na lista de sugestões até a opção dimension.
    • Pressione Enter para inserir o parâmetro selecionado no LookML. O Looker vai inserir um novo parâmetro dimension na nova linha que você criou.
  4. Para dar um nome à nova dimensão, clique no ambiente de desenvolvimento integrado antes de {} e digite shipped_to_delivered_days.

  5. Clique dentro de {} e pressione Enter para criar uma nova linha dentro de {}.

  6. Conclua o LookML para a nova dimensão (você pode copiar e colar o LookML a seguir ou inseri-lo manualmente para ver como o ambiente de desenvolvimento integrado do Looker fornece orientações):

    dimension: shipped_to_delivered_days {
      group_label: "Other Dates"
      type: duration_day
      sql_start: ${shipped_raw} ;;
      sql_end: ${delivered_raw} ;;
    }
    
  7. Na parte de cima do ambiente de desenvolvimento integrado do Looker, clique no botão Salvar alterações.

O Looker vai salvar o arquivo de visualização com a nova dimensão. Para as novas linhas no arquivo, o ambiente de desenvolvimento integrado do Looker vai sombrear os números das linhas em verde.

Mais informações sobre os campos do LookML

Para criar seus próprios campos no futuro, observe os seguintes recursos:

  • Para informações sobre os campos do LookML em geral, consulte a página de documentação Referência de campos do LookML.
  • Para informações sobre os tipos de dimensões, filtros e parâmetros que podem ser criados em um arquivo de visualização, consulte a página de documentação Tipos de dimensões, filtros e parâmetros.
  • Para informações sobre os tipos de medições que podem ser criadas em um arquivo de visualização, consulte a página de documentação Tipos de medições.

Ver e testar as mudanças na interface do Looker

Se você realizou o procedimento Criar Análises para suas visualizações para criar uma Análise para o arquivo de visualização order_items, poderá ver sua nova dimensão na interface de Análise do Looker.

Para ver e testar as mudanças na Análise na interface do Looker, siga estas etapas:

  1. No arquivo quickstarts/order_items.view no ambiente de desenvolvimento integrado do Looker, clique no ícone de seta Ver ações do arquivo ao lado do nome do arquivo de visualização na parte de cima do painel do editor de arquivos e selecione a opção Analisar itens de pedido - quickstart_practice.

    O menu "Ver ações do arquivo", com a opção "Analisar itens de pedido - quickstart_practice" selecionada.

  2. No seletor de campos da Análise Order Items, clique no rótulo do grupo Other Dates para expandi-lo e, em seguida, clique na dimensão Shipped to Delivered Days para adicioná-la à Análise. Você também pode pesquisar a dimensão digitando Shipped to Delivered Days na caixa de pesquisa do seletor de campo.

  3. No seletor de campos da Análise Order Items, clique no rótulo do grupo Shipped Date para expandi-lo e, em seguida, clique na dimensão Date para adicioná-la à Análise.

  4. No seletor de campos da Análise Order Items, clique no rótulo do grupo Delivered Date para expandi-lo e, em seguida, clique na dimensão Date para adicioná-la à Análise.

  5. Clique no botão Executar na parte de cima da Análise.

O Looker vai executar a consulta e mostrar os resultados na seção Dados da Análise. Em cada linha, verifique se o valor em Dias entre o envio e a entrega dos itens do pedido mostra o número correto de dias entre o valor de Data de envio dos itens do pedido e o valor de Data de entrega dos itens do pedido.

Validar o LookML

Para este guia de início rápido, não é necessário validar o LookML. No entanto, no futuro, quando você criar seus próprios projetos para modelar dados, será bom conhecer as ferramentas do Looker para validar o LookML.

Ao editar o LookML, o ambiente de desenvolvimento integrado do Looker vai alertar você sobre erros de sintaxe não resolvidos em um único arquivo (consulte a página de documentação Visão geral do ambiente de desenvolvimento integrado do Looker). Também é possível realizar uma validação completa do modelo, que vai verificar se há erros no LookML. Consulte a página de documentação Como validar o LookML para mais informações.

Fazer commit das mudanças

Neste guia de início rápido, você vai usar uma conexão do Git pré-configurada para o projeto de exemplo do LookML. No entanto, no futuro, quando você criar seus próprios projetos para modelar dados, será necessário configurar uma conexão do Git para o projeto.

Conforme você faz mudanças nos arquivos do projeto do LookML, o ambiente de desenvolvimento integrado do Looker mostra diferentes operações para o botão do Git no canto superior direito. O botão mostra diferentes operações para orientar você no processo de validação do LookML e implantação das mudanças na produção.

Os arquivos do LookML e a Análise que você acessou neste guia de início rápido estão disponíveis apenas na sua ramificação pessoal do Git no Modo de Desenvolvimento. Se você quiser disponibilizar esse modelo para outros usuários na sua instância do Looker (Google Cloud Core), confirme as mudanças, mescle o branch e implante o branch de produção.

Para este guia de início rápido, não implante as mudanças na produção. Em vez disso, você vai excluir esses arquivos, conforme descrito no procedimento de limpeza.

Limpar

Para maximizar o desempenho do Looker, não implante modelos desnecessários na produção. Para manter uma ramificação pessoal limpa do Git e evitar a implantação acidental desses arquivos na produção, conclua as etapas a seguir para excluir os arquivos criados neste guia de início rápido:

  1. Clique no ícone do Menu principal do Looker e selecione Desenvolver, se o menu Desenvolver ainda não estiver sendo exibido.
  2. No menu Desenvolver, selecione sample_thelook_ecommerce.
  3. No painel Navegador de arquivos do ambiente de desenvolvimento integrado do Looker, selecione o menu de três pontos Opções de pasta para a pasta quickstart que você criou no procedimento Criar uma nova pasta de projeto.
  4. Selecione Excluir no menu Opções da pasta.
  5. Na janela Excluir pasta, clique em Excluir.

O Looker exclui a pasta quickstart e todo o conteúdo dela.

A seguir