Como criar um novo projeto do LookML

Um projeto é uma coleção de arquivos do LookML que descrevem como as tabelas do banco de dados estão relacionadas entre si e como o Looker deve interpretar essas tabelas. Saiba mais sobre os projetos nas páginas de documentação Modelo de desenvolvimento e projetos do LookML e Termos e conceitos do LookML. Para saber como acessar e editar projetos, consulte a página de documentação Como 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 que os usuários possam visualizar e editar o LookML de um arquivo de modelo específico, crie um novo projeto. Embora a maioria das permissões no Looker seja aplicada no nível do modelo, algumas são aplicadas no 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 do LookML em uma instância do Looker.

Como criar um projeto

Atenção: a página New Project no Looker descrita nesta documentação foi substituída pela página Create a Model. No entanto, ainda é possível acessar a página New Project se você estiver usando uma instância do Looker (original) e o administrador do Looker tiver ativado o recurso legado Use Legacy Project Creation Page, ou pelo banner informativo na parte de cima da página Create a Model ou pelo botão Add LookML na seção Pending Projects da página Projects.

Para criar um projeto, siga estas etapas:

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

2. Selecione Projects na seção Develop 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 New Project, em que você pode 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 dependem da opção Starting Point escolhida na página New Project. As seções a seguir descrevem como esses pontos de partida funcionam:

• Como gerar automaticamente um modelo no banco de dados
• Como clonar um repositório Git público
• Como criar um projeto em branco

Gerar automaticamente um modelo do seu banco de dados

Na página New Project, 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 permitem apenas caracteres alfanuméricos, _, . e -. Escolha o nome do projeto com cuidado e considere-o como um ID permanente, já que o Looker usa o nome do projeto das seguintes maneiras:

   • Para identificar o projeto de 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 a importação de projetos locais.
   • 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 do 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 com base no esquema do 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 do 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 do esquema no campo de texto Esquemas. É possível listar vários esquemas separados por vírgulas.

   Observação: para conexões com bancos de dados do Databricks com o Unity Catalog ativado, o Looker só pode gerar modelos para o catálogo do Databricks especificado na conexão do Looker com o banco de dados do Databricks. Se a conexão não especificar um catálogo, o Looker só poderá gerar modelos para o catálogo padrão do banco de dados.

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 têm os títulos dwh_orders e DBS_users. Se você inserir dwh, DBS no campo de texto Ignore Prefixes, o Looker vai criar arquivos de visualização com os nomes 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 do LookML cria pastas do ambiente de desenvolvimento integrado para os 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 do LookML a partir do seu banco de dados, o Looker vai preencher automaticamente as descrições de campo com as descrições dos metadados da coluna do BigQuery, se houver.

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

Como clonar um repositório Git público

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

Os projetos do Looker clonados de repositórios Git públicos são somente leitura. No entanto, é possível importar o projeto somente leitura para outro projeto do Looker, onde você pode editar os arquivos. Além disso, você pode usar os arquivos do repositório clonado como ponto de partida e, em seguida, usar o parâmetro extends ou os refinamentos do Looker para criar um projeto a partir deles.

Na página New Project, especifique as seguintes opções para clonar um repositório Git público em um projeto do Looker:

1. 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 ou determinados caracteres especiais. Escolha o nome do projeto com cuidado e considere-o como um ID permanente, já que o Looker usa o nome do projeto das seguintes maneiras:

   • Para identificar o projeto de 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 a importação de projetos locais.
   • 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 do 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 Clonar repositório Git público.

3. URL do repositório Git: insira o URL do repositório Git público. 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 usar o formato correto substituindo "https://" por "git://" e adicionando ".git" no final. O URL que você vai inserir é git://github.com/llooker/blocks_redshift_admin.git.

Por fim, 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.

Como criar um projeto em branco

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

Na página New Project, especifique as seguintes opções para criar um projeto em branco:

1. 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 ou determinados caracteres especiais. Escolha o nome do projeto com cuidado e considere-o como um ID permanente, já que o Looker usa o nome do projeto das seguintes maneiras:

   • Para identificar o projeto de 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 a importação de projetos locais.
   • 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 do 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 Projeto em branco.

Por fim, clique em Criar projeto. O Looker cria o projeto e o abre no ambiente de desenvolvimento integrado do Looker.

Próximas etapas

Depois que um projeto é criado, você pode:

• Crie manualmente outros modelos para seu projeto.
• Edite arquivos do LookML.
• Configure modelos para uso na produção.
• Renomeie o projeto.
• Conectar o projeto do Looker ao Git.