Visão geral do IDE do Looker

O ambiente de desenvolvimento integrado (IDE) do Looker oferece acesso aos arquivos do projeto do LookML e às configurações dele.

Como acessar o IDE do Looker

Para acessar um projeto do LookML, você precisa ter a permissão develop em pelo menos um modelo do projeto. Você pode acessar o Looker IDE pelo painel Develop do menu de navegação principal do Looker:

  1. Selecione Desenvolver no painel de navegação para abrir o painel Desenvolver.
  2. No painel Develop, selecione o nome do projeto que você quer acessar.

O Looker abre o ambiente de desenvolvimento integrado para o projeto do LookML que você selecionou.

Como alternativa, abra o ambiente de desenvolvimento integrado para objetos específicos do LookML em uma Análise detalhada ou no navegador de objetos. Consulte Como acessar arquivos de projeto para saber mais e conferir outras opções.

Elementos do IDE do Looker

O ambiente de desenvolvimento integrado do Looker tem os seguintes elementos:

  1. Banner do modo de desenvolvimento: esse banner indica que você está no modo de desenvolvimento, em que é possível fazer alterações nos arquivos do LookML e ter uma prévia de como elas vão afetar o conteúdo na sua instância. Clique no link Sair do modo de desenvolvimento no banner para acessar o Modo de produção.
  2. Barra de navegação do ambiente de desenvolvimento integrado: use a barra de navegação para acessar diferentes recursos do Looker IDE. Alguns recursos só estão disponíveis no Modo de desenvolvimento. Depois de selecionar um recurso na barra de navegação do ambiente de desenvolvimento integrado, selecione o item da barra de navegação uma segunda vez para recolher o painel de recursos. A barra de navegação do ambiente de desenvolvimento integrado oferece acesso aos seguintes recursos:
  3. Painel de recursos: oferece navegação para arquivos e objetos do LookML para o navegador de arquivos e o navegador de objetos, parâmetros de pesquisa para a função de encontrar e substituir, comandos do Git disponíveis para o painel Ações do Git e guias para acessar diferentes configurações do painel de configurações do projeto.
  4. Painel do editor do ambiente de desenvolvimento integrado: o editor para arquivos do LookML. O editor aparece quando File Browser ou Object Browser é selecionado na barra de navegação do ambiente de desenvolvimento integrado. Consulte Recursos de edição do ambiente de desenvolvimento integrado do Looker para mais informações sobre o editor.
  5. Seletor do painel lateral: clique em uma opção para abrir os recursos do painel lateral do ambiente de desenvolvimento integrado:
    • Project Health: abre o painel Project Health.
    • Ajuda rápida: abre o painel Ajuda rápida, que inclui uma guia para acessar o painel Metadados.
    • Quero ajuda para codificar: (para instâncias do Looker (Google Cloud core) com o Gemini ativado) abre o painel Quero ajuda para codificar. Clique na opção do seletor do painel lateral uma segunda vez para ocultar o painel lateral do ambiente de desenvolvimento integrado.
  6. Painel lateral do ambiente de desenvolvimento integrado: exibe o recurso selecionado do painel lateral:
  7. Botão do Git: dependendo do estado do projeto, o botão mostra a próxima ação que você precisa realizar para levar o projeto à produção, como Validar LookML, Enviar a ramificação para o remoto ou Confirmar. Clique no botão para realizar a ação. Consulte a referência de comandos do Git para conferir os comandos que o botão pode mostrar e executar.

Configurar o ambiente de desenvolvimento integrado do Looker

É possível personalizar o ambiente de desenvolvimento integrado do Looker das seguintes maneiras:

Modos do editor de texto

O ambiente de desenvolvimento integrado do Looker oferece suporte a três modos de editor de texto:

  • Editor do IDE do Looker (padrão)
  • Vim
  • Emacs

Para mudar o modo do editor de texto, siga estas etapas:

  1. Selecione o ícone Settings no painel de navegação à esquerda no ambiente de desenvolvimento integrado do Looker.
  2. Selecione a guia Editor em IDE Settings.
  3. Use o menu suspenso Modo do editor de texto para selecionar a opção.

Depois de selecionar uma opção no menu suspenso, o ambiente de desenvolvimento integrado do Looker é atualizado imediatamente para usar o modo de editor de texto selecionado.

Modo de quebra de linha

Por padrão, o Looker IDE é ativado para quebra de linha.

Para ativar ou desativar a quebra de linha:

  1. Selecione o ícone Settings no painel de navegação à esquerda no ambiente de desenvolvimento integrado do Looker.
  2. Selecione a guia Editor em IDE Settings.
  3. Use a opção Modo de quebra de linha para ativar ou desativar a quebra de linha no ambiente de desenvolvimento integrado.

Depois que você muda a chave, a atualização é aplicada ao ambiente de desenvolvimento integrado do Looker.

Redimensionar os painéis laterais do ambiente de desenvolvimento integrado

É possível mudar a largura dos painéis no ambiente de desenvolvimento integrado, tanto o painel de recursos, que contém os painéis File Browser, Object Browser e Git Actions, quanto o painel lateral, que contém os painéis Project Health, Quick Help e Metadata.

Para redimensionar os painéis do ambiente de desenvolvimento integrado, mantenha o cursor sobre a borda do painel e arraste para redimensionar:

Se você estiver no modo de desenvolvimento, o ambiente de desenvolvimento integrado permitirá o tamanho dos painéis laterais em todos os logins e atualizações.

Como recolher os painéis laterais do ambiente de desenvolvimento integrado

Se você quiser maximizar a largura do painel do editor do ambiente de desenvolvimento integrado, feche os painéis laterais do ambiente de desenvolvimento integrado:

  • Para mostrar ou ocultar o painel de recursos do ambiente de desenvolvimento integrado, use o atalho de teclado Command-B (Mac) ou Ctrl+B (Windows) ou clique em um ícone na barra de navegação do ambiente de desenvolvimento integrado que já está selecionado.
  • Para mostrar ou ocultar o painel lateral do ambiente de desenvolvimento integrado, clique em um ícone no seletor de painel lateral que já está selecionado.

Recursos de edição do ambiente de desenvolvimento integrado do Looker

As seções a seguir descrevem alguns dos recursos de edição do Looker IDE que podem ajudar no desenvolvimento em LookML:

Sugestão automática

Conforme você digita, o ambiente de desenvolvimento integrado sugere possíveis parâmetros e valores que são sensíveis ao contexto do que você está digitando. Por exemplo, as sugestões para o parâmetro type de uma dimensão só vão incluir opções válidas para esse parâmetro. Além disso, os campos nos parâmetros sql precisam ser marcados com ${...} para que o ambiente de desenvolvimento integrado adicione essa sintaxe ao sugerir campos.

A sugestão automática aparece automaticamente onde for possível. Para fechar, pressione a tecla Esc no teclado. Para conferir a qualquer momento, pressione Ctrl + Espaço (Windows) ou Control + Espaço (Mac).

Verificação de erros ad hoc

O ambiente de desenvolvimento integrado detecta erros de sintaxe enquanto você digita. Um X vermelho na margem indica um erro de sintaxe, que é sublinhado em vermelho. Quando você mantém o cursor sobre o X vermelho, uma breve descrição do problema aparece. Por exemplo, se você digitar avrage em vez de average como o valor do parâmetro type para uma medida, o ambiente de desenvolvimento integrado vai mostrar o erro Invalid value for "type":avrage.

O validador do LookML ainda é necessário para realizar uma validação completa do modelo. Alguns erros, como uma referência de campo inválida causada por uma mesclagem ausente, exigem uma análise holística do modelo e, portanto, só são exibidos quando o validador do LookML é executado.

Formatação automática

No modo de desenvolvimento, use o atalho de teclado para formatar arquivos para recuar automaticamente o arquivo LookML. O recuo indica a hierarquia de parâmetros e subparâmetros, facilitando a leitura e a compreensão do LookML.

Dobrável

Uma pequena seta aparece no gutter ao lado do início de cada parâmetro de nível superior do LookML no arquivo. Ao selecionar essa seta, você pode abrir ou fechar uma seção do LookML para se concentrar em seções específicas.

O menu Ver ações do arquivo do arquivo LookML também oferece as opções Dobrar LookML e Desdobrar LookML para expandir ou recolher todas as seções da LookML até o parâmetro de nível superior no arquivo atual.

Também é possível usar atalhos de teclado para dobrar e desdobrar o LookML.

Comentários

É possível adicionar comentários ao LookML para facilitar a leitura. Para adicionar um único comentário, use o caractere #:

dimension: name {
  sql: ${TABLE}.name ;; # This is the customer's full name
}

Para comentar um bloco inteiro de código usando atalhos de teclado, siga estas etapas:

  1. Selecione as linhas que você quer comentar.
  2. Pressione Command + / (Mac) ou Ctrl + / (Windows).

O ambiente de desenvolvimento integrado vai adicionar o caractere # a cada uma das linhas selecionadas.

Como comentar blocos SQL

Se você estiver comentando linhas que estão inteiramente em um bloco de código SQL, adicione manualmente a notação de comentário SQL.

Quando você usa o bloco de comentários SQL, as seções comentadas ainda são interpretadas como código LookML. Portanto, você vai encontrar seus comentários no SQL gerado pelo LookML, mas eles não vão afetar os resultados da consulta.

Como conferir adições, alterações e exclusões

No ambiente de desenvolvimento integrado do LookML, vários indicadores são sempre exibidos quando você está no modo de desenvolvimento e tem mudanças não confirmadas.

  • O nome do arquivo é exibido com um ponto azul no lado esquerdo da janela para indicar que o arquivo é novo, foi alterado ou renomeado.
  • Quando você abre um arquivo novo ou alterado, os números de linha dentro dele são destacados em verde para mostrar as linhas novas ou alteradas, e uma linha vermelha horizontal indica as linhas removidas.

Persistência do estado do ambiente de desenvolvimento integrado

Quando você está no modo de desenvolvimento, o ambiente de desenvolvimento integrado do Looker mantém o estado do ambiente de desenvolvimento integrado em atualizações e logins. O estado do seu ambiente de desenvolvimento integrado inclui o seguinte:

  • O item selecionado na barra de navegação do ambiente de desenvolvimento integrado (como o navegador de arquivos, ações do Git, navegador de objetos ou configurações do projeto)
  • Abrir o arquivo LookML exibido no navegador de arquivos
  • Estado aberto ou fechado dos itens no navegador de arquivos e no navegador de objetos
  • A largura dos painéis laterais do ambiente de desenvolvimento integrado
  • O item selecionado na barra lateral direita do ambiente de desenvolvimento integrado (como o painel "Ajuda rápida", "Metadados" e "Saúde do projeto")
  • O modo de quebra de linha do editor

Para redefinir o ambiente de desenvolvimento integrado para os padrões, selecione o ícone Settings no painel de navegação à esquerda no ambiente de desenvolvimento integrado do Looker, selecione a guia Editor na seção IDE Settings e clique no botão Reset IDE Layout. O ambiente de desenvolvimento integrado vai manter seu estado novamente à medida que você continuar a abrir arquivos e fazer seleções.

Acessar o objeto ou arquivo

No Looker IDE, é possível fazer uma pesquisa rápida para navegar diretamente aos objetos e arquivos do projeto do LookML usando o recurso Ir para objeto ou arquivo. Clique no ícone Ir para objeto ou arquivo no navegador de arquivos ou no navegador de objetos ou use o atalho do teclado Command-J (Mac) ou Ctrl+J (Windows).

Consulte a página de documentação Como acessar arquivos de projeto do LookML para mais informações.

Painel de Ajuda rápida

Para abrir o painel Ajuda rápida, selecione o ícone Ajuda rápida no navegador de arquivos ou no navegador de objetos:

O painel Ajuda rápida oferece explicações e opções para o local atual no código:

  • No painel do editor do ambiente de desenvolvimento integrado, você pode clicar nos campos e parâmetros nos arquivos do LookML. O painel Ajuda rápida vai mostrar as opções e os subparâmetros compatíveis com esse elemento do LookML.
  • No painel Ajuda rápida, clique no nome de um parâmetro para abrir a página de documentação do Looker relacionada a ele.

Painel "Preciso de ajuda com o código"

Se você tiver uma instância do Looker (núcleo do Google Cloud) com o Gemini ativado, poderá usar o Gemini no Looker para ajudar a escrever o LookML:

Ambiente de desenvolvimento integrado do Looker com o ícone "Preciso de ajuda com o código" em destaque.

Consulte a documentação Escrever LookML com a assistência do Gemini no Looker para mais detalhes.

Menus de opções para arquivos e pastas

No navegador de arquivos, cada arquivo ou pasta no painel à esquerda tem um menu que mostra as ações disponíveis para esse item. Mantenha o cursor sobre um arquivo e uma pasta e selecione o menu Opções da pasta (para pastas) ou Opções do arquivo (para arquivos) para abrir o menu. Para um item com um nome longo ou que está aninhado em várias pastas, você pode acessar o menu rolando para os lados no painel do navegador de arquivos.

Nos menus de opções, você pode criar pastas e arquivos, fazer upload de arquivos e excluir e mover arquivos e pastas usando o navegador de arquivos. Para mais informações, consulte a página de documentação Gerenciar arquivos e pastas do LookML.

Ao organizar seus arquivos do LookML com pastas, você precisa confirmar suas alterações e implantá-las na produção antes que outros desenvolvedores do Looker possam acessá-las. Isso é como qualquer mudança feita no seu projeto do LookML.

Como encontrar e substituir texto no projeto

O ambiente de desenvolvimento integrado do Looker tem uma função de encontrar e substituir, que pode ser usada para pesquisar texto em todos os arquivos do projeto e substituir todas as instâncias ou instâncias selecionadas em uma operação em massa.

Para usar a função de busca do ambiente de desenvolvimento integrado do Looker, siga estas etapas:

  1. Navegue até o painel de pesquisa no ambiente de desenvolvimento integrado.
  2. Digite um termo no campo Encontrar.
  3. Você também pode selecionar Diferença entre maiúsculas e minúsculas para pesquisar apenas instâncias que correspondam ao caso que você inseriu no campo Encontrar ou RegEX para realizar uma pesquisa de expressão regular.
  4. Selecione Encontrar.
  5. Você também pode selecionar o nome de um arquivo para abri-lo no ambiente de desenvolvimento integrado.

Se você estiver no modo de desenvolvimento, também vai encontrar o campo Substituir por. Para substituir o texto no projeto, siga estas etapas:

  1. Insira o texto de substituição no campo Substituir por. Se preferir, deixe o campo Substituir por em branco para excluir o texto no campo Localizar em vez de substituí-lo.

  2. Selecione Selecionar e substituir para conferir como o texto seria substituído no projeto.

  3. Os resultados mostram todas as instâncias no seu projeto destacadas para substituição. Você pode usar as seguintes opções para personalizar quais instâncias são substituídas:

    • Use a caixa de seleção ao lado do resumo dos resultados para selecionar ou desmarcar todas as instâncias em todo o projeto.
    • Use a caixa de seleção ao lado de uma única instância para selecionar ou desmarcar essa instância.

  4. Selecione o botão Replace Selected para aplicar a substituição às instâncias selecionadas. O ambiente de desenvolvimento integrado vai mostrar as mudanças feitas.

Como criar e testar novos campos

Como exemplo de edição do LookML, vamos adicionar vários campos e testá-los.

Como criar uma dimensão

Primeiro, vamos adicionar uma nova dimensão à visualização users que determina se um usuário é da Califórnia ou de Nova York. A dimensão será type: yesno, o que significa que ela vai retornar Sim se o usuário for da Califórnia ou de Nova York e Não caso contrário.

O LookML para nossa nova dimensão é assim:

dimension: from_ca_or_ny {
  type: yesno
  sql: ${TABLE}.state = "California" OR ${TABLE}.state = "New York" ;;
}

Adicione essa dimensão ao arquivo de visualização user e clique no botão Salvar alterações.

Confira os operadores de substituição para saber mais sobre ${TABLE}.state.

Como criar uma medida

Em seguida, vamos adicionar uma nova métrica à visualização user que mostra a média de idade dos usuários. Essa medida será type: average e agregada na coluna age.

O LookML para essa nova medida é parecido com este:

measure: average_age {
  type: average
  sql: ${TABLE}.age ;;
}

Adicione essa métrica ao arquivo de visualização user e clique no botão Salvar alterações.

Como testar os campos na Análise detalhada

Para testar a nova dimensão e a métrica, faça uma consulta. Depois que você salva as mudanças, esses campos aparecem no seletor de campos na seção "Explorar". Use o menu suspenso Conferir ações do arquivo ao lado do nome do arquivo para acessar a seção "Explorar" da visualização atual. O menu suspenso Conferir ações no arquivo lista todas as análises detalhadas com base na visualização, incluindo as que estão vinculadas a ela. Por exemplo, para acessar a seção "Explorar" em uma visualização chamada users, selecione a opção Explorar usuários no menu suspenso Conferir ações de arquivo.

Na seção Usuários, você pode selecionar os novos campos para adicioná-los a uma consulta. Por exemplo, é possível criar uma consulta com os dois novos campos que mostram a idade média dos usuários da Califórnia ou de Nova York e a idade média dos usuários que não são dessas localidades:

Tabela de dados de uma amostra da Análise detalhada de usuários com os campos "Usuários de CA ou NY (Sim/Não)" e "Idade média dos usuários" selecionados.