Como gerenciar arquivos LookML e Git com a extensão do Looker para VS Code

A extensão do Looker para VS Code usa um modelo de desenvolvimento local. Esse modelo mantém uma relação tripla entre seu sistema de arquivos local, o modo de desenvolvimento da sua instância do Looker e seu repositório Git remoto.

Este guia explica como a extensão sincroniza arquivos e como as operações locais do Git afetam seu projeto do Looker.

Mecanismo de sincronização

A extensão gerencia automaticamente a sincronização do conteúdo do arquivo entre o IDE local e o servidor do Looker.

Abrir arquivos (leitura ao abrir)

Quando você abre um arquivo .lkml no ambiente de desenvolvimento integrado (IDE) local, a extensão busca automaticamente a versão atual desse arquivo na ramificação extraída do Modo de Desenvolvimento da sua instância do Looker. Isso garante que você sempre trabalhe com a versão mais atualizada do código.

Salvar arquivos (gravar ao salvar)

Quando você salva um arquivo localmente (Command-S no Mac ou Ctrl+S no Windows/Linux), a extensão envia imediatamente as mudanças locais para o servidor do Looker. Essas mudanças ficam visíveis no IDE do Looker baseado em navegador quando você está no modo de desenvolvimento.

Lidar com conflitos de sincronização

Se um arquivo for editado no Looker IDE baseado em navegador enquanto também estiver aberto no VS Code, poderá ocorrer um conflito.

Por padrão, a extensão vai substituir a versão no servidor do Looker pela versão local do VS Code.

No entanto, se você ativou a configuração looker.askBeforeOverwritingRemote, o VS Code vai mostrar um aviso quando você tentar salvar um arquivo que foi modificado no servidor. Você pode escolher uma das seguintes ações:

  • Manter local: substitui a versão no servidor do Looker pela versão local do VS Code.
  • Extrair remoto: substitui o arquivo local pela versão do servidor do Looker.

A configuração looker.askBeforeOverwritingRemote fica desativada por padrão.

Operações locais do Git

A extensão sincroniza o conteúdo do arquivo, mas você precisa gerenciar seu repositório Git usando comandos padrão do Git no terminal local ou na guia "Controle de origem" do IDE local.

Gerenciar ramificações

Quando você muda de ramificação localmente usando git checkout, a extensão detecta a mudança e alterna automaticamente sua sessão no servidor do Looker para a ramificação correspondente.

Estado do Git no Looker

Quando você salva as mudanças no arquivo, elas são sincronizadas com sua instância do Looker e aparecem como não confirmadas no IDE do Looker baseado em navegador. Se você fizer commit dessas mudanças usando o Git no seu ambiente local, elas vão continuar aparecendo como não confirmadas no IDE do Looker até que você as envie para o repositório remoto.

Quando você usa git push, sua instância do Looker extrai as mudanças confirmadas do repositório remoto. Depois que a instância do Looker extrair do repositório remoto, as mudanças confirmadas e enviadas não vão mais aparecer como não confirmadas no IDE do Looker. Somente arquivos salvos localmente, mas ainda não confirmados e enviados, vão aparecer como não confirmados.

Validar o LookML

A extensão executa automaticamente o validador de LookML do Looker sempre que você salva uma mudança. Todos os erros de sintaxe e modelo retornados pelo validador vão aparecer inline nos seus arquivos dentro do ambiente de desenvolvimento integrado local. Se quiser, também é possível executar o validador do LookML manualmente sem salvar arquivos usando o comando Looker: Validate LookML da paleta de comandos.

A seguir