Como criar um novo projeto do LookML

Um projeto é uma coleção de arquivos LookML que descrevem como as tabelas de banco de dados se relacionam entre si e como o Looker deve interpretar essas tabelas. Saiba mais sobre projetos nas páginas de documentação Projetos do LookML e modelo de desenvolvimento e Termos e conceitos do LookML. Para informações sobre como acessar e editar projetos, consulte a página de documentação Acessar e editar informações do projeto.

Um projeto do LookML pode conter mais de um arquivo de modelo. No entanto, se você quiser especificar permissões para os usuários visualizarem e editarem o LookML de um arquivo de modelo específico, crie um novo projeto. Embora a maioria das permissões no Looker se aplique ao nível do modelo, algumas se aplicam ao nível do projeto, incluindo see_lookml, que permite visualizar o LookML de um projeto, e develop, que permite editar o LookML.

Os usuários do Looker com a permissão manage_models podem criar modelos LookML em uma instância do Looker.

Como criar um projeto

Para criar um projeto, siga estas etapas:

  1. Verifique se você está no modo de desenvolvimento.

  2. Selecione Projetos na seção Desenvolver do painel de navegação.

  3. Na página Projetos do LookML, selecione Novo projeto do LookML para escolher as opções do projeto.

Essa ação abre a página Novo projeto, em que é possível especificar as configurações do projeto, incluindo o nome e o ponto de partida.

O Looker pode criar um projeto de várias maneiras, e as etapas realizadas dependem da opção Ponto de partida escolhida na página Novo projeto. As seções a seguir descrevem como esses pontos de partida funcionam:

Gerar um modelo automaticamente do seu banco de dados

Na página Novo projeto, especifique as seguintes opções para gerar automaticamente um modelo de um banco de dados.

  1. Nome do projeto: dê um nome ao projeto. Os nomes de projetos diferenciam maiúsculas de minúsculas e só permitem caracteres alfanuméricos, _, . e -. Escolha o nome do projeto com cuidado e considere-o um ID permanente, já que o Looker usa o nome do projeto das seguintes maneiras:

    • Para identificar o projeto em chamadas de API que têm o parâmetro project_id.
    • Para identificar o projeto no banco de dados interno da instância do Looker.
    • Para identificar o projeto para importação de projeto local.
    • Para mostrar o projeto na página Projetos do LookML.
    • Para mostrar o projeto na seção Desenvolver do painel de navegação do Looker.
    • Como parte do URL dos arquivos de projeto. Por exemplo, em uma instância do Looker com um URL de example.looker.com, o arquivo de manifesto do projeto chamado ecommerce pode ser encontrado neste URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  2. Ponto de partida: escolha Gerar modelo do esquema de banco de dados.

  3. Conexão: no menu suspenso, selecione o nome da conexão do banco de dados.

  4. Criar visualizações a partir de: selecione uma das seguintes opções:

    • Todas as tabelas: o gerador do LookML cria um arquivo de visualização para cada tabela no seu banco de dados.
    • Tabela única: o gerador de LookML cria uma visualização para uma tabela no seu banco de dados. Se você escolher essa opção, insira o nome da tabela do banco de dados.

  5. Esquemas: para gerar arquivos de apenas um esquema no banco de dados, insira o nome dele no campo de texto Esquemas. É possível listar vários esquemas separados por vírgulas.

  6. Ignorar prefixos: para deixar os prefixos de tabela fora dos nomes dos arquivos de visualização, insira os prefixos do seu banco de dados no campo Ignorar prefixos. Esse campo diferencia maiúsculas de minúsculas. É possível listar vários prefixos separados por vírgulas. Por exemplo, suas tabelas são chamadas de dwh_orders e DBS_users. Se você inserir dwh, DBS no campo de texto Ignorar prefixos, o Looker vai criar arquivos de visualização chamados orders e users.

Por fim, clique em Criar projeto para criar um projeto que contenha o modelo gerado.

  • O gerador do LookML cria um arquivo de modelo para o projeto e um arquivo de visualização para cada tabela no banco de dados, a menos que especificado de outra forma. Em seguida, o Looker abre o novo projeto no ambiente de desenvolvimento integrado do Looker.
  • O gerador de LookML cria pastas do IDE para seus arquivos de visualização e modelo. Se o banco de dados tiver mais de um esquema, o gerador de LookML vai criar uma pasta para eles.

Para conexões do BigQuery, se você gerar um projeto LookML do seu banco de dados, o Looker vai preencher automaticamente as descrições dos campos com as descrições dos metadados da coluna do BigQuery, se houver.

O gerador também cria uma análise detalhada para cada tabela de banco de dados. Para começar a consultar seus dados, use o painel Análise e selecione o nome de uma Análise.

Como clonar um repositório Git público na página Novo projeto

Se você selecionar Clonar repositório Git público como ponto de partida na página Novo projeto, o Looker vai copiar os arquivos de um repositório Git público para seu novo projeto LookML.

Os projetos do Looker clonados de repositórios Git públicos na página Novo projeto são somente leitura. No entanto, é possível importar o projeto somente leitura para outro projeto do Looker, em que você pode usar os arquivos do repositório clonado como ponto de partida para extends ou refinamentos do Looker para criar um projeto a partir daí.

Para clonar um repositório Git público em um projeto do Looker, siga estas etapas:

  1. Verifique se você está no modo de desenvolvimento.
  2. Na seção Desenvolver do painel de navegação do Looker, selecione Projetos.

  3. Na página Projetos do LookML, dependendo da configuração da sua instância, faça uma destas ações:

    • Clique no botão Novo projeto do LookML para abrir a página Novo projeto.
    • Clique no botão Novo modelo para abrir a página Criar um modelo. Em seguida, no banner de informações dessa página, clique no link clique aqui para abrir a página Novo projeto.

  4. No campo Nome do projeto, dê um nome ao projeto. Os nomes de projetos diferenciam maiúsculas de minúsculas e não podem usar espaços nem determinados caracteres especiais. Escolha o nome do projeto com cuidado e considere-o um ID permanente, já que o Looker usa o nome do projeto das seguintes maneiras:

    • Para identificar o projeto em chamadas de API que têm o parâmetro project_id.
    • Para identificar o projeto no banco de dados interno da instância do Looker.
    • Para identificar o projeto para importação de projeto local.
    • Para mostrar o projeto na página Projetos do LookML.
    • Para mostrar o projeto na seção Desenvolver do painel de navegação do Looker.
    • Como parte do URL dos arquivos de projeto. Por exemplo, em uma instância do Looker com um URL de example.looker.com, o arquivo de manifesto do projeto chamado ecommerce pode ser encontrado neste URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  5. No campo Ponto de partida, selecione Clonar repositório Git público.

  6. No campo URL do repositório Git, insira o URL do repositório público do Git. Confira se o URL está no formato git://github.com/example/my-repository.git.

    Se você tiver um URL como https://github.com/llooker/blocks_redshift_admin, edite-o para o formato correto substituindo https:// por git:// e adicionando .git no final. O URL que você inseriria seria git://github.com/llooker/blocks_redshift_admin.git.

  7. Clique em Criar projeto. O Looker vai extrair todos os arquivos do repositório público para um novo projeto do LookML e abrir o projeto no IDE do Looker.

Método alternativo para clonar um repositório Git público

A maneira mais fácil de clonar um repositório Git público é cloná-lo usando a página Novo projeto no Looker. No entanto, há duas desvantagens em clonar na página Novo projeto:

  • O GitHub não aceita URLs git://. Por isso, não é possível clonar repositórios do GitHub na página Novos projetos.
  • Os repositórios Git clonados na página Novos projetos são somente leitura.

Se você tiver um repositório do GitHub ou quiser gravar nele, crie um fork do repositório e conecte-o a um projeto em branco no Looker seguindo estas etapas:

  1. Navegue até seu provedor Git e faça um fork do repositório.
  2. No Looker, crie um projeto em branco conforme descrito na seção Como criar um projeto em branco desta página.
  3. Depois de criar o projeto em branco do LookML, configure a conexão Git dele com o fork do repositório Git usando HTTPS ou SSH.

Depois de configurar a conexão Git com o fork do repositório, você pode editar os arquivos no Looker IDE e usar o controle de versão e implantar as mudanças na produção como em qualquer projeto padrão do LookML.

Como criar um projeto em branco

Se você selecionar Projeto em branco como ponto de partida na página Novo projeto, o Looker vai criar um projeto vazio para que você possa criar seus arquivos LookML do zero.

Para criar um projeto em branco, siga estas etapas:

  1. Verifique se você está no modo de desenvolvimento.
  2. Na seção Desenvolver do painel de navegação do Looker, selecione Projetos.

  3. Na página Projetos do LookML, dependendo da configuração da sua instância, faça uma destas ações:

    • Clique no botão Novo projeto do LookML para abrir a página Novo projeto.
    • Clique no botão Novo modelo para abrir a página Criar um modelo. Em seguida, no banner de informações dessa página, clique no link clique aqui para abrir a página Novo projeto.

  4. No campo Nome do projeto, dê um nome ao projeto. Os nomes de projetos diferenciam maiúsculas de minúsculas e não podem usar espaços nem determinados caracteres especiais. Escolha o nome do projeto com cuidado e considere-o um ID permanente, já que o Looker usa o nome do projeto das seguintes maneiras:

    • Para identificar o projeto em chamadas de API que têm o parâmetro project_id.
    • Para identificar o projeto no banco de dados interno da instância do Looker.
    • Para identificar o projeto para importação de projeto local.
    • Para mostrar o projeto na página Projetos do LookML.
    • Para mostrar o projeto na seção Desenvolver do painel de navegação do Looker.
    • Como parte do URL dos arquivos de projeto. Por exemplo, em uma instância do Looker com um URL de example.looker.com, o arquivo de manifesto do projeto chamado ecommerce pode ser encontrado neste URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  5. No campo Ponto de partida, escolha Projeto em branco.

  6. Clique em Criar projeto. O Looker cria e abre o projeto no ambiente de desenvolvimento integrado do Looker.

Próximas etapas

Depois que um projeto é criado, é possível fazer o seguinte: