Modelar seus dados no LookML

Aprenda a usar o LookML e o IDE do Looker para modelar seus dados de maneira estruturada e reutilizável.

A maneira mais fácil de modelar seus dados no Looker é fazer com que ele mesmo gere automaticamente arquivos LookML com base nas tabelas do seu banco de dados. Você pode praticar isso com o guia de início rápido Gerar um modelo com dados de amostra e conferir o procedimento completo na página de documentação Como gerar um modelo LookML.

O objetivo deste guia de início rápido é mostrar como adicionar arquivos do LookML manualmente ao projeto e criar novos elementos do LookML manualmente para personalizar o projeto de acordo com seus dados e necessidades específicas. Neste guia de início rápido, você vai aprender a criar manualmente um arquivo de modelo e de visualização do LookML, criar uma Análise para sua visualização, criar uma nova dimensão no arquivo de visualização e testar a nova medida na interface da Análise. Este guia de início rápido também vai ensinar a ativar o modo de desenvolvimento, navegar pelo ambiente de desenvolvimento integrado do Looker e usar o recurso de ajuda rápida do ambiente de desenvolvimento integrado do Looker. Este guia de início rápido também vai fornecer links para a documentação relevante para saber mais sobre esses temas.

Como ponto de partida, este guia de início rápido usa o exemplo de projeto do LookML, que é configurado automaticamente nas instâncias do Looker (núcleo do Google Cloud).

Antes de começar

Para acompanhar este tutorial, você vai precisar do seguinte:

Ativar o Modo de desenvolvimento

Os projetos do Looker podem existir em um dos dois modos: de produção e de desenvolvimento. O modo de desenvolvimento permite fazer alterações nos arquivos do LookML e ter 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 outros usuários veem). Consulte a página de documentação Modo de desenvolvimento e modo de produção para mais informações.

Neste guia de início rápido, você vai usar o modo de desenvolvimento para fazer alterações nos arquivos do LookML e testar essas mudanças em uma análise detalhada.

Para ativar o modo de desenvolvimento, siga estas etapas:

  1. Na página inicial do Looker (Google Cloud Core), clique no ícone Menu principal do Looker para abrir o menu de navegação principal, se ele ainda não estiver aberto.
  2. Selecione a opção 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 que informam ao Looker como se conectar ao banco de dados, como consultar e apresentar os dados na interface do usuário. Neste guia de início rápido, você vai usar o exemplo de projeto do LookML, que é configurado automaticamente nas instâncias do Looker (núcleo do Google Cloud).

Para navegar até os arquivos de projeto do LookML no ambiente de desenvolvimento integrado do Looker, siga estas etapas:

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

O Looker vai abrir o painel File Browser do Looker IDE e mostrar os arquivos de exemplo do projeto do LookML.

Criar uma nova pasta do projeto

Para manter os arquivos criados neste guia de início rápido separados do restante dos 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 File Browser do Looker IDE, clique no ícone Add file or folder na parte de cima do painel e selecione a opção Create Folder no menu Add file or folder.

  2. Para o nome da nova pasta, digite quickstart.

  3. Clique em Criar.

O Looker adiciona a nova pasta ao painel File Browser no ambiente de desenvolvimento integrado do Looker.

Informações adicionais sobre pastas do ambiente de desenvolvimento integrado

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

Criar um novo 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 que os usuários consultem seus dados no Looker depois que eles forem modelados no LookML. Consulte Como visualizar e interagir com as Análises no Looker.

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

  1. No painel File Browser do Looker IDE, selecione o menu de Folder Options com três pontos para a pasta quickstart que você criou no procedimento Criar uma nova pasta de projeto.
  2. No menu Folder Options, selecione Create Model.
  3. Na caixa de diálogo Create File, digite o nome quickstart_practice para o novo arquivo e clique em Create. 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 File Browser indica que o arquivo é novo.
  4. No painel File Browser, clique na pasta quickstart para expandi-la e conferir o arquivo quickstart_practice.model.
  5. No ambiente de desenvolvimento integrado do Looker, clique no arquivo quickstart_practice.model para abri-lo, se ele ainda não estiver aberto.

O arquivo quickstart_practice.model contém exemplos de LookML que podem ser usados 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 arquivo de modelo.

Outras informações sobre arquivos de modelo

Para criar seus próprios arquivos de modelo no futuro, consulte 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 seu banco de dados a ser consultada e os campos (dimensões e medidas) a serem incluídos nessa tabela. Depois de definir um campo no arquivo de visualização, use o operador de substituição $ para fazer referência a ele em outras partes do LookML. Assim, você pode definir o campo em um único local e usá-lo em vários lugares no seu projeto do LookML.

Há várias maneiras de criar um novo arquivo de visualização, mas a maneira mais fácil de começar é fazer com que o próprio Looker gere automaticamente um arquivo de visualização com base em uma tabela existente no seu banco de dados.

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

  1. No painel File Browser do Looker IDE, selecione o menu de Folder Options com três pontos para a pasta quickstart que você criou no procedimento Criar uma nova pasta de projeto.
  2. Selecione Criar visualização da tabela no menu Opções de pasta.

  3. Na página Criar visualizações a partir de tabelas, clique no campo de entrada Inserir db personalizado e digite bigquery-public-data:

    Caixa de diálogo "Create Views from Tables".

  4. Pressione Enter para conferir 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 do Looker. No painel do File Browser, a pasta quickstart é expandida, e o arquivo de visualização order_items é mostrado com um ponto azul para indicar que é um novo arquivo.

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

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

Ajuda rápida do IDE do Looker

Agora você criou um arquivo de modelo e um 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, familiarize-se com o recurso de ajuda rápida do IDE do Looker. O painel Ajuda rápida oferece explicações e opções para a localização atual do cursor nos arquivos do LookML:

  • No painel do editor do ambiente de desenvolvimento integrado, você pode clicar nos campos e parâmetros nos arquivos do LookML. O painel Ajuda rápida vai mostrar 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 relacionada a 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 executar o procedimento Criar um novo arquivo de modelo do LookML e Criar um novo arquivo de visualização do LookML, você pode definir uma análise detalhada para o novo arquivo de visualização para usar o Looker e consultar os dados que você modelou no arquivo de visualização.

As análises detalhadas geralmente são definidas em um arquivo de modelo. Você pode criar um arquivo de análise detalhada separado, mas, para este guia de início rápido, você vai criar a análise detalhada no arquivo de modelo.

No arquivo LookML em que você define uma análise detalhada, é necessário usar o parâmetro include para fazer referência ao arquivo de visualização na definição da análise detalhada. Este procedimento orienta você nessas etapas.

Para criar uma análise detalhada 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 pela seguinte:

    include: "/quickstart/order_items.view"

  3. Adicione uma nova linha no parâmetro include e insira o seguinte valor do LookML: none explore: order_items {}, que pode ser selecionado no campo.

  4. Clique no botão Save Changes na parte de cima do Looker IDE.

Essa Análise é o exemplo mais básico de uma Análise que permite que os usuários consultem a visualização order_items. A partir desse ponto, 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, consulte 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á conferir 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 campos em uma Análise detalhada e que pode ser usado para filtrar uma consulta. Se o campo não estiver em uma função de agregação, como SUM, COUNT e similares, 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 baseadas 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ões para os campos baseados em tempo que ele detecta na tabela do banco de dados.
  • Uma medida é um campo em uma Análise detalhada que representa informações mensuráveis sobre seus dados, como somas, contagens etc. Uma medida é declarada em um arquivo de visualização e pode ser de um tipo agregado ou não. O Looker cria automaticamente uma medida de type:count para o arquivo de visualização, que é o equivalente a um COUNT(*) no 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 ele ainda não estiver aberto: no painel File Browser do ambiente de desenvolvimento integrado do Looker, clique na pasta quickstart para expandi-la e 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 no arquivo.

  3. Na nova linha, comece a digitar dimension. Conforme você digita, o ambiente de desenvolvimento integrado do Looker mostra uma lista de parâmetros possíveis que começam com o texto que você digitou.

    • Use as teclas de seta para navegar pela 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 atribuir um nome à nova dimensão, clique no ambiente de desenvolvimento integrado antes do {} e digite shipped_to_delivered_days.

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

  6. Preencha o LookML para a nova dimensão. Você pode copiar e colar o LookML a seguir ou inserir manualmente para conferir as orientações do IDE do Looker:

    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 Looker IDE, clique no botão Save Changes.

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

Mais informações sobre os campos do LookML

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

  • Para informações sobre os campos do LookML em geral, consulte a página de documentação Referência de campo do LookML.
  • Para saber mais 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 Dimensões, filtros e tipos de parâmetros.
  • Para saber mais sobre os tipos de medidas que podem ser criados em um arquivo de visualização, consulte a página de documentação Tipos de medidas.

Conferir e testar suas mudanças na interface do Looker

Se você executou o procedimento Criar análises para suas visualizações para criar uma análise para o arquivo de visualização order_items, a nova dimensão vai aparecer na interface de Análises do Looker.

Para conferir e testar as mudanças na seção "Explorar" da interface do Looker, siga estas etapas:

  1. No arquivo quickstarts/order_items.view do Looker IDE, clique no ícone de seta See file actions ao lado do nome do arquivo de visualização na parte de cima do painel do editor de arquivos e selecione a opção Explore Order Items - quickstart_practice.

    Menu "Ver ações do arquivo" com a opção "Analisar itens do pedido - quickstart_practice" selecionada.

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

  3. No seletor de campo Itens do pedido, clique no rótulo do grupo Data de envio para expandi-lo e, em seguida, clique na dimensão Data para adicionar à análise detalhada.

  4. No seletor de campo da Análise detalhada Itens do pedido, clique no rótulo do grupo Data de entrega para expandi-lo e, em seguida, clique na dimensão Data para adicionar à Análise detalhada.

  5. Clique no botão Run na parte de cima da seção "Explorar".

O Looker vai executar a consulta e mostrar os resultados na seção Dados da Análise. Para cada linha, verifique se o valor em Order Items Shipped to Delivered Days mostra o número correto de dias entre o valor de Order Items Shipped Date e o valor de Order Items Delivered Date.

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 seus dados, é bom conhecer as ferramentas do Looker para validar o LookML.

Ao editar o LookML, o Looker IDE alerta sobre erros de sintaxe não resolvidos em um único arquivo (consulte a página de documentação Visão geral do Looker IDE). 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 seu LookML para mais informações.

Confirmar as mudanças

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

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

Os arquivos e a Análise LookML que você acessou neste guia de início rápido só estão disponíveis 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 (núcleo do Google Cloud), comete as mudanças, mescle a ramificação e implante a ramificação de produção.

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

Limpar

Para maximizar a performance do Looker, não é necessário implantar modelos desnecessários na produção. Para manter uma ramificação pessoal do Git limpa e evitar a implantação acidental desses arquivos na produção, siga estas etapas para excluir os arquivos criados neste guia de início rápido:

  1. Clique no ícone Menu principal do Looker e selecione Desenvolver, se o menu Desenvolver ainda não estiver aberto.
  2. No menu Develop, selecione sample_thelook_ecommerce.
  3. No painel File Browser do Looker IDE, selecione o menu de Folder Options com três pontos 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 Delete Folder, clique em Delete.

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

A seguir