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):
- A instância precisa incluir o exemplo de projeto do LookML.
- O projeto do Google Cloud da instância precisa ter a API BigQuery ativada.
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:
- 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.
- 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.
Acesse o projeto de exemplo do LookML no ambiente de desenvolvimento integrado do Looker.
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:
- Clique no ícone do Menu principal do Looker e selecione Desenvolver, se o menu Desenvolver ainda não estiver sendo exibido.
- 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:
- 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.
Para o nome da nova pasta, digite
quickstart.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:
- Para criar suas próprias pastas e arquivos no futuro e saber mais sobre como criar pastas no seu projeto, consulte a página de documentação Como gerenciar arquivos e pastas do LookML.
- Para saber mais sobre o navegador de arquivos do ambiente de desenvolvimento integrado do Looker, consulte a página de documentação Como trabalhar com o navegador de arquivos do ambiente de desenvolvimento integrado.
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:
- 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
quickstartque você criou no procedimento Criar uma nova pasta de projeto. - No menu Opções de pasta, selecione Criar modelo.
- Na caixa de diálogo Criar arquivo, insira o nome
quickstart_practicepara o novo arquivo e clique em Criar. O Looker cria o arquivoquickstart_practice.modelna pastaquickstarte 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. - No painel Navegador de arquivos, clique na pasta
quickstartpara expandi-la e ver o arquivoquickstart_practice.model. - No ambiente de desenvolvimento integrado do Looker, clique no arquivo
quickstart_practice.modelpara 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:
- Para informações sobre arquivos de modelo em geral, consulte a seção Arquivos de modelo da página de documentação Arquivos de projeto do LookML.
- Para ver o procedimento completo e outras opções de criação de arquivos no projeto, consulte a página de documentação Como gerenciar arquivos e pastas do LookML.
- Para informações sobre as convenções de nomenclatura de arquivos do LookML, consulte a seção Antes de começar: convenções importantes de nomenclatura de arquivos e pastas na página "Como gerenciar arquivos e pastas do LookML".
- Para informações sobre os parâmetros do LookML que podem ser usados em um arquivo de modelo, consulte a página de documentação Parâmetros de modelo.
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:
- 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
quickstartque você criou no procedimento Criar uma nova pasta de projeto. - Selecione Criar visualização com base na tabela no menu Opções de pasta.
Na página Criar visualização da tabela, clique no campo de entrada Inserir db personalizado e digite
bigquery-public-data:
Pressione Enter para ver os conjuntos de dados públicos do BigQuery.
Role a lista até encontrar o conjunto de dados
thelook_ecommerce.Clique no conjunto de dados
thelook_ecommercepara expandi-lo.Selecione a tabela
order_items.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:
- Para informações sobre arquivos de visualização em geral, consulte a seção Arquivos de visualização da página de documentação Arquivos de projeto do LookML.
- Para ver o procedimento completo e outras opções de criação de arquivos no projeto, consulte a página de documentação Como gerenciar arquivos e pastas do LookML.
- Para considerações específicas sobre a criação de arquivos de visualização, consulte a seção Considerações para criar arquivos de visualização na página "Como gerenciar arquivos e pastas do LookML".
- Para informações sobre as convenções de nomenclatura de arquivos do LookML, consulte a seção Antes de começar: convenções importantes de nomenclatura de arquivos e pastas na página "Como gerenciar arquivos e pastas do LookML".
- Para informações sobre os parâmetros do LookML que podem ser usados em um arquivo de visualização, consulte a página de documentação Parâmetros de visualização.
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:
- No ambiente de desenvolvimento integrado do Looker, abra o arquivo
quickstart_practice.model. No arquivo
quickstart_practice.model, substitua a linha que contém o parâmetroincludepor esta:include: "/quickstart/order_items.view"Adicione uma nova linha abaixo do parâmetro
includee insira o seguinte LookML:none explore: order_items {}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:
- Para mais informações sobre como criar Análises, consulte a página de documentação Como criar e editar Análises.
- Para saber como mesclar outras visualizações, consulte a página de documentação Como trabalhar com mesclagens no LookML.
- Para informações sobre os parâmetros do LookML que podem ser usados em uma Análise, consulte a página de documentação Parâmetros das Análises.
- Para saber como consultar dados em uma página de Análise na interface do Looker, consulte a página de documentação Como visualizar e interagir com Análises no Looker.
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:countpara o arquivo de visualização, que é o equivalente a umCOUNT(*)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:
- 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 arquivoorder_items.viewpara abri-lo. - No arquivo
quickstarts/order_items.view, crie uma nova linha antes do primeiro parâmetrodimension. 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
dimensionna nova linha que você criou.
- Use as teclas de seta para navegar na lista de sugestões até a opção
Para dar um nome à nova dimensão, clique no ambiente de desenvolvimento integrado antes de
{}e digiteshipped_to_delivered_days.Clique dentro de
{}e pressione Enter para criar uma nova linha dentro de{}.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} ;; }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:
No arquivo
quickstarts/order_items.viewno 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.
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 Daysna caixa de pesquisa do seletor de campo.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.
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.
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:
- Clique no ícone do Menu principal do Looker e selecione Desenvolver, se o menu Desenvolver ainda não estiver sendo exibido.
- No menu Desenvolver, selecione sample_thelook_ecommerce.
- 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
quickstartque você criou no procedimento Criar uma nova pasta de projeto. - Selecione Excluir no menu Opções da pasta.
- Na janela Excluir pasta, clique em Excluir.
O Looker exclui a pasta quickstart e todo o conteúdo dela.
A seguir
- Como gerar um modelo do LookML
- Visão geral do ambiente de desenvolvimento integrado do Looker
- Como gerenciar arquivos e pastas do LookML
- Tipos de arquivos em um projeto do LookML
- Ver parâmetros
- Parâmetros do modelo
- Padrões comuns do LookML
- Como usar o controle de versões e a implantação
- Como o Looker gera SQL
- Incorporar SQL e referenciar objetos do LookML