Gerar um modelo a partir de dados de amostra

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

Cada instância do Looker (Google Cloud Core) vem com o projeto de exemplo do LookML, que é instalado por padrão na instância. O projeto de exemplo do LookML inclui modelos selecionados com base 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 instrucionais, você vai excluir o modelo de dados no final do processo.

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) que inclui o projeto de exemplo do LookML.
  • Ative a API BigQuery para o projeto Google Cloud que contém sua instância do Looker (Google Cloud Core).

    Ativar a API

Funções exigidas

Para concluir este início rápido, você precisa ter o 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 Looker (Google Cloud Core) pelo sistema Identity and Access Management do Google Cloud.

Para receber a permissão necessária para acessar o aplicativo 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 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 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

É necessário ter o papel 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), clique no ícone do Menu principal do Looker e ative o Modo de desenvolvimento selecionando a opção Modo de desenvolvimento na parte de baixo do menu.
  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, escolha 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 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, escolha Nome como a chave primária e clique em Próxima.
  10. Na seção Selecionar análises detalhadas para criar, selecione o arquivo bq_table.view e clique em Próxima.
  11. Na seção Inserir nome do modelo, digite um nome exclusivo.
  12. Clique no botão Concluir e ver modelo. Essa ação leva você ao Looker IDE.

Ver seu modelo

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

Ver os arquivos de modelo no IDE do Looker

  1. Depois de clicar no botão Concluir e ver modelo, você vai estar no IDE do Looker. No navegador de arquivos do ambiente de desenvolvimento integrado, você vê as pastas dos modelos de exemplo do LookML preexistentes, 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. Expanda as pastas models e views para ver os arquivos da LookML que o Looker criou para o modelo definido 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 adicionada pelo Looker.
  3. Você também vai encontrar o arquivo README.md que o Looker gerou porque a caixa de seleção Gerar um arquivo Readme com mais informações sobre o uso do LookML na página Criar um modelo estava marcada por padrão.

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

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

Ver a análise detalhada criada pelo modelo

  1. Na página Projetos, clique no nome do modelo para voltar ao arquivo dele no ambiente de desenvolvimento integrado.
  2. Com o arquivo do modelo aberto no IDE, clique na seta Ver ações do arquivo ao lado do nome do arquivo na parte de cima do IDE.
  3. Selecione Explorar tabela do BQ: your_model_name no menu suspenso. Essa seleção leva você à análise Tabela do BQ criada pelo modelo.
  4. No seletor de campos, observe as dimensões Data de nascimento, Nome e Classificação que você selecionou na página Criar um modelo, além da métrica padrão Contagem.

Os arquivos de modelo, a configuração do modelo e a análise detalhada que você visualizou só estão disponíveis na sua ramificação pessoal do Git no modo de desenvolvimento. Se você quisesse disponibilizar esse modelo para outros usuários na sua instância do Looker (Google Cloud Core), confirmaria as mudanças, mesclaria a ramificação e implantaria 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, modelos desnecessários não devem ser implantados na produção. Para manter uma ramificação Git pessoal limpa e evitar implantar acidentalmente esse modelo na produção, siga estas etapas para excluir o modelo:

  1. No Explore, clique no link Acessar LookML no seletor de campos. Essa ação leva você ao Looker IDE.
  2. No IDE, 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 mudanças não confirmadas está selecionada e clique em Confirmar.

  5. No IDE, os arquivos do modelo não vão mais aparecer.

  6. Para excluir a configuração do modelo, clique em Projetos no menu Desenvolver e acesse a página Projetos.

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

  8. Verifique o nome no campo Modelo para confirmar se você está na janela do seu modelo e clique em Excluir configuração do modelo.

A seguir