Criar um novo projeto do LookML

Um projeto é uma coleção de ficheiros LookML que descrevem a forma como as tabelas da base de dados se relacionam entre si e como o Looker deve interpretar essas tabelas. Pode saber mais sobre os projetos nas páginas de documentação Projetos do LookML e modelo de desenvolvimento e Termos e conceitos do LookML. Para obter informações sobre como aceder e editar projetos existentes, consulte a página de documentação Aceder e editar informações do projeto.

Um projeto do LookML pode conter mais do que um ficheiro de modelo. No entanto, se quiser especificar autorizações para os utilizadores verem e editarem o LookML de um ficheiro de modelo específico, é recomendável criar um novo projeto. Embora a maioria das autorizações no Looker se aplique ao nível do modelo, existem algumas autorizações que se aplicam ao nível do projeto, incluindo see_lookml, que lhe permite ver o LookML de um projeto, e develop, que lhe permite editar o LookML.

Os utilizadores do Looker com a autorização manage_models podem criar modelos LookML numa instância do Looker.

Criar um projeto

Para criar um projeto, siga estes passos:

  1. Verifique se está no modo de programação.

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

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

Esta ação abre a página Novo projeto, onde pode especificar as definições do projeto, incluindo o nome e o ponto de partida do projeto.

O Looker pode criar um projeto de várias formas, e os passos realizados dependem da opção Ponto de partida que escolher na página Novo projeto. As secções seguintes descrevem o funcionamento destes pontos de partida:

Gerar automaticamente um modelo a partir da sua base de dados

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

  1. Nome do projeto: atribua um nome ao projeto. Os nomes dos projetos são sensíveis a maiúsculas e minúsculas e só permitem carateres alfanuméricos, _, . e -. Escolha cuidadosamente o nome do projeto e considere-o um ID permanente para o projeto, uma vez que o Looker usa o nome do projeto das seguintes formas:

    • Para identificar o projeto para chamadas API que têm o parâmetro project_id.
    • Para identificar o projeto na base de dados interna da instância do Looker.
    • Para identificar o projeto para a importação de projetos locais.
    • Para apresentar o projeto na página Projetos do LookML.
    • Para apresentar o projeto na secção Desenvolver do painel de navegação do Looker.
    • Como parte do URL dos ficheiros do projeto. Por exemplo, numa instância do Looker com um URL de example.looker.com, o ficheiro de manifesto do projeto com o nome ecommerce pode ser encontrado neste URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  2. Ponto de partida: escolha Gerar modelo a partir do esquema da base de dados.

  3. Associação: no menu pendente, selecione o nome da associação da base de dados.

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

    • Todas as tabelas: o gerador do LookML cria um ficheiro de vista para cada tabela na sua base de dados.
    • Tabela única: o gerador de LookML cria uma vista para uma tabela na sua base de dados. Se escolher esta opção, introduza o nome da tabela da base de dados.

  5. Esquemas: para gerar ficheiros apenas para um esquema na sua base de dados, introduza o nome do esquema no campo de texto Esquemas. Pode listar vários esquemas, separados por vírgulas.

  6. Ignorar prefixos: para deixar os prefixos das tabelas de fora dos nomes dos ficheiros da vista, introduza os prefixos da base de dados no campo Ignorar prefixos. Este campo é sensível a maiúsculas e minúsculas. Pode listar vários prefixos, separados por vírgulas. Por exemplo, as suas tabelas têm os títulos dwh_orders e DBS_users. Se introduzir dwh, DBS no campo de texto Ignorar prefixos, o Looker cria ficheiros de visualização com os nomes orders e users.

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

  • O gerador do LookML cria um ficheiro de modelo para o projeto, bem como um ficheiro de visualização para cada tabela na base de dados (salvo indicação em contrário). Em seguida, o Looker abre o novo projeto no IDE do Looker.
  • O gerador de LookML cria pastas do IDE para os ficheiros de visualização e modelo. Se a sua base de dados tiver mais do que um esquema, o gerador do LookML cria uma pasta para esquemas.

Para as ligações do BigQuery, se gerar um projeto LookML a partir da sua base de dados, o Looker preenche automaticamente as descrições dos campos com as descrições dos metadados das colunas do BigQuery, se existirem.

O gerador também cria uma exploração para cada tabela da base de dados. Para começar a consultar os seus dados, use o painel Explorar para selecionar o nome de uma opção Explorar.

Clonar um repositório Git público a partir da página Novo projeto

Se selecionar Clonar repositório Git público como ponto de partida na página Novo projeto, o Looker copia os ficheiros de um repositório Git público para um novo projeto LookML.

O Looker suporta a clonagem de um repositório Git público através do URL Web HTTPS do repositório.

Para clonar um repositório Git público existente num projeto do Looker, siga estes passos:

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

  3. Na página Projetos do LookML, consoante a configuração da sua instância, faça uma das seguintes 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 e, em seguida, no banner de informações na página Criar um modelo, clique no link clique aqui para abrir a página Novo projeto.

  4. No campo Nome do projeto, atribua um nome ao projeto. Os nomes dos projetos são sensíveis a maiúsculas e minúsculas e não podem usar espaços nem determinados carateres especiais. Escolha cuidadosamente o nome do projeto e considere-o um ID permanente para o projeto, uma vez que o Looker usa o nome do projeto das seguintes formas:

    • Para identificar o projeto para chamadas API que têm o parâmetro project_id.
    • Para identificar o projeto na base de dados interna da instância do Looker.
    • Para identificar o projeto para a importação de projetos locais.
    • Para apresentar o projeto na página Projetos do LookML.
    • Para apresentar o projeto na secção Desenvolver do painel de navegação do Looker.
    • Como parte do URL dos ficheiros do projeto. Por exemplo, numa instância do Looker com um URL de example.looker.com, o ficheiro de manifesto do projeto com o nome 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, introduza o URL do repositório Git público. Certifique-se de que o URL está no formato https://github.com/example/my-repository.git.

  7. Clique em Criar projeto. O Looker clona o repositório e abre o IDE do Looker para o novo projeto LookML com os ficheiros do projeto do repositório clonado.

Depois de o Looker criar o seu novo projeto do LookML, tem de configurar o controlo de versão Git associando-o a um repositório Git. Consulte a página de documentação Configurar e testar uma ligação Git para ver os procedimentos de ligação ao Git através de HTTPS ou SSH.

Consoante a sua situação, pode querer configurar a ligação Git para enviar alterações para o seu próprio repositório Git ou pode querer enviar alterações de volta para o repositório Git original clonado:

  • Se quiser usar os ficheiros clonados como ponto de partida para o seu próprio projeto independente do repositório Git público, configure a ligação Git do seu projeto para apontar para o seu próprio repositório Git e envie as suas alterações para lá.
  • Se quiser contribuir com atualizações para o repositório Git público que clonou e tiver um token de acesso pessoal com acesso de leitura/escrita ao repositório público, configure a ligação Git do seu projeto para apontar para o repositório Git público e envie as suas alterações para lá.

Depois de configurar a ligação Git a um repositório, pode editar os ficheiros no IDE do Looker e, em seguida, usar o controlo de versões e implementar alterações na produção, tal como acontece com qualquer projeto padrão do LookML.

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

A forma mais fácil de clonar um repositório Git público é usar a página Novo projeto no Looker.

Em alternativa, pode criar um fork do repositório e associá-lo a um projeto em branco no Looker através destes passos:

  1. Navegue até ao seu fornecedor de Git e crie um fork do repositório.
  2. No Looker, crie um projeto em branco conforme descrito na secção Criar um projeto em branco desta página.
  3. Depois de criar o novo projeto do LookML em branco, configure a ligação Git do projeto à ramificação do repositório Git através de HTTPS ou SSH.

Depois de configurar a ligação Git ao fork do repositório, pode editar os ficheiros no IDE do Looker e, em seguida, usar o controlo de versões e implementar alterações na produção, tal como acontece com qualquer projeto LookML padrão.

Criar um projeto em branco

Se selecionar Projeto em branco como ponto de partida na página Novo projeto, o Looker cria um projeto vazio para que possa criar os seus ficheiros LookML de raiz.

Para criar um projeto em branco, siga estes passos:

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

  3. Na página Projetos do LookML, consoante a configuração da sua instância, faça uma das seguintes 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 e, em seguida, no banner de informações na página Criar um modelo, clique no link clique aqui para abrir a página Novo projeto.

  4. No campo Nome do projeto, atribua um nome ao projeto. Os nomes dos projetos são sensíveis a maiúsculas e minúsculas e não podem usar espaços nem determinados carateres especiais. Escolha cuidadosamente o nome do projeto e considere-o um ID permanente para o projeto, uma vez que o Looker usa o nome do projeto das seguintes formas:

    • Para identificar o projeto para chamadas API que têm o parâmetro project_id.
    • Para identificar o projeto na base de dados interna da instância do Looker.
    • Para identificar o projeto para a importação de projetos locais.
    • Para apresentar o projeto na página Projetos do LookML.
    • Para apresentar o projeto na secção Desenvolver do painel de navegação do Looker.
    • Como parte do URL dos ficheiros do projeto. Por exemplo, numa instância do Looker com um URL de example.looker.com, o ficheiro de manifesto do projeto com o nome 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 o projeto e abre-o no IDE do Looker.

Passos seguintes

Depois de criar um projeto, pode fazer o seguinte: