Gerar um modelo com base em dados de amostra

Saiba como usar o Looker (Google Cloud Core) para gerar automaticamente um modelo de dados básico com base em uma conexão incluída em cada instância.

Cada instância do Looker (Google Cloud Core) vem com o exemplo de projeto do LookML instalado por padrão. O projeto de exemplo do LookML inclui modelos selecionados que são baseados no conjunto de dados público do BigQuery the Look eCommerce. O exemplo de projeto do LookML usa uma conexão, sample_bigquery_connection. Você pode usar essa conexão para gerar um novo modelo de dados com base em uma das tabelas do projeto de exemplo. Como este início rápido é apenas para fins instrutivos, você vai excluir o modelo de dados no final do processo.

Dica: para gerar um modelo usando sua própria conexão e dados reais, siga as etapas na página de documentação Como gerar um modelo do LookML.

Antes de começar

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

• Acesso a uma instância do Looker (Google Cloud Core) que inclui o exemplo de projeto do LookML.
• Alguém com a função do IAM de Administrador do Looker precisa ativar a API BigQuery para o projeto do Google Cloud que contém sua instância do Looker (Google Cloud Core).

  Ativar a API

• É necessário ter a função de Administrador do Looker ou a permissão develop.

Navegue até a página "Criar um modelo".

1. Na página inicial do Looker (Google Cloud Core), ative o modo de desenvolvimento selecionando a opção Modo de desenvolvimento no menu de navegação principal.
2. Na página inicial do Looker (Google Cloud Core), clique no botão Criar no menu de navegação principal para abrir o menu suspenso.
3. No menu suspenso, selecione Modelo do LookML para abrir a página Criar um modelo.

Defina seu modelo

Na página Criar um modelo, siga estas etapas:

1. Na seção Selecionar conexão de banco de dados, selecione sample_bigquery_connection no menu suspenso.
2. Selecione o botão de opção para adicionar o modelo ao projeto sample_thelook_ecommerce e clique em Próxima.
3. Na seção Selecionar tabelas, deixe o projeto padrão do Google Cloud no campo Selecionar projeto do GCP.
4. No campo Conjuntos de dados, selecione bq_dataset.
5. Clique na seta à direita de bq_dataset para acessar o campo Tabelas.
6. No campo Tabelas, selecione bq_table.
7. Clique na seta à direita de bq_table para acessar o campo Campos.
8. No campo Campos, selecione todos os campos e clique em Próxima.
9. Na seção Selecionar chaves primárias, selecione Nome como a chave primária e clique em Próxima.
10. Na seção Selecionar análises para criar, selecione o arquivo bq_table.view e clique em Próxima.
11. Na seção Enter Model Name, insira um nome exclusivo para o modelo.
12. Clique no botão Concluir e conferir modelo. Essa ação leva você ao ambiente de desenvolvimento integrado do Looker.

Conferir o modelo

Depois de preencher todos os campos na página Criar um modelo, confira o modelo gerado pelo Looker.

Conferir os arquivos do modelo no ambiente de desenvolvimento integrado do Looker

1. Depois de clicar no botão Complete and View Model, você vai acessar o ambiente de desenvolvimento integrado do Looker. No navegador de arquivos do ambiente de desenvolvimento integrado, você encontra as pastas dos modelos de exemplo do LookML, que são 0_start_here, 1_basic_lookml, 2_intermediate_lookml e 3_advanced_lookml. Você também vai encontrar as pastas criadas para o modelo gerado, models e views.
2. Abra as pastas models e views para conferir os arquivos LookML que o Looker criou para o modelo que você definiu na página Criar um modelo. O ponto azul ao lado de cada arquivo indica que eles são novos e ainda não foram implantados na produção.
   • O arquivo .model define o modelo. No arquivo de modelo, é possível ver a conexão selecionada, a visualização bq_table e outras configurações padrão.
   • O arquivo bq_table.view define a visualização. No arquivo de visualização, você pode conferir os campos birthdate, name e rating selecionados e como eles são definidos na tabela do banco de dados do BigQuery, além de uma medida count padrão que o Looker adicionou.
3. Você também vai encontrar o arquivo README.md gerado pelo Looker porque a caixa de seleção Generate a Readme file that gives more information about using LookML na página Create a Model foi selecionada por padrão.

Conferir o modelo na página "Projetos do LookML"

1. No ambiente de desenvolvimento integrado, abra o menu de navegação principal clicando no ícone Main menu.
2. Se você ainda não estiver no menu Develop, clique em Develop.
3. No menu Develop, selecione Projects para acessar a página LookML Projects.
4. Confira seu modelo na coluna Models da linha sample_thelook_ecommerce. Ele aparece com os modelos advanced_ecomm, basic_ecomm e intermediate_ecomm do projeto de exemplo do LookML.

Conferir a Análise detalhada criada pelo modelo

1. Na página Projects, clique no nome do modelo para voltar ao arquivo no ambiente de desenvolvimento integrado.
2. Com o arquivo de modelo aberto no ambiente de desenvolvimento integrado, clique na seta Ver ações do arquivo ao lado do nome do arquivo na parte de cima do ambiente.
3. Selecione Analisar tabela do BQ - nome_do_modelo no menu suspenso. Essa seleção leva você à análise detalhada Bq Table criada pelo seu modelo.
4. No seletor de campos, observe as dimensões Data de nascimento, Nome e Nota que você selecionou na página Criar um modelo, bem como a medida padrão Contagem.

Observação: o modelo gerado não contém dados. Portanto, a execução de uma consulta no recurso "Explorar" não vai retornar resultados.

Os arquivos de modelo, a configuração do modelo e a seção "Explorar" que você acessou só ficam disponíveis no seu ramo do Git pessoal no modo de desenvolvimento. Se você quiser disponibilizar esse modelo para outros usuários na sua instância do Looker (Google Cloud Core), comete as mudanças, mescle a ramificação e implante a ramificação de produção. No entanto, para os fins deste guia de início rápido, você vai excluir esse modelo, conforme descrito na próxima seção.

Limpar

Para maximizar a performance do Looker, não implante modelos desnecessários na produção. Para manter uma ramificação pessoal do Git limpa e evitar a implantação acidental do modelo na produção, siga estas etapas para excluí-lo:

1. Na seção "Explorar", clique no link Acessar LookML no seletor de campos. Essa ação leva você ao ambiente de desenvolvimento integrado do Looker.
2. No ambiente de desenvolvimento integrado, selecione o ícone Ações do Git.
3. No menu Ações do Git, clique em Reverter para.

4. Na janela Reverter para, verifique se a opção Reverter alterações não confirmadas está selecionada e clique em Confirmar.

   Dica: se você quiser saber se há outras mudanças na sua ramificação de trabalho, clique em View Changes antes de clicar em Confirm.

5. No ambiente de desenvolvimento integrado, os arquivos do modelo não aparecem mais.

6. Para excluir a configuração do modelo, acesse a página Projects clicando em Projects no menu Develop.

7. Localize seu modelo na tabela e clique no botão Configurar na linha dele.

8. Verifique se você está na janela do modelo verificando o nome no campo Model e clique em Excluir configuração do modelo.

A seguir

• Como gerar um modelo do LookML
• Visão geral do ambiente de desenvolvimento integrado do Looker
• Gerenciar arquivos e pastas do LookML
• Padrões comuns do LookML
• Como usar o controle e a implantação de versões