O validador de conteúdo pesquisa no LookML os nomes de modelo, exploração e campos referenciados no conteúdo do Looker. É uma ferramenta útil para validar as referências do LookML, corrigir erros no LookML depois de fazer alterações e atualizar os nomes dos elementos do LookML em todo o projeto.
Você precisa ter a permissão develop para usar o validador de conteúdo.
Para abrir o Validador de conteúdo, selecione Validador de conteúdo no menu Desenvolver do painel de navegação à esquerda. Nessa página, é possível usar o Validador de conteúdo de duas maneiras:
- Clique em Validar para encontrar e corrigir erros que foram causados por mudanças no modelo do LookML.
- Clique em Localizar e substituir em todo o conteúdo para encontrar e substituir os nomes do modelo, da Análise ou dos campos no conteúdo do Looker, independentemente de haver erros no conteúdo.
Antes de usar o validador de conteúdo
Você precisa ter extremely cuidado ao fazer alterações usando a validação de conteúdo. O validador de conteúdo não tem uma função "desfazer" e pode afetar muitos Looks e dashboards, além dos links Explore from Here. Se você cometer um erro, tente corrigi-lo o mais rápido possível, antes que outras mudanças dificultem o isolamento dos Looks afetados.
Além disso, considere o tempo necessário ao usar o Validador de conteúdo. Ao enviar mudanças de desenvolvimento para produção, você deve corrigir Looks e blocos afetados aproximadamente ao mesmo tempo, para que eles fiquem corrompidos pelo tempo mínimo. Se você corrigir os Looks e os blocos muito cedo, com base no seu trabalho no Modo de Desenvolvimento, eles aparecerão corrompidos para os usuários até que você envie as alterações. Da mesma forma, se você atrasar a correção de Looks e blocos até muito tempo depois de enviar as alterações, eles aparecerão corrompidos para os usuários até que você os corrija.
Como usar o validador de conteúdo para corrigir erros
O validador de conteúdo é uma ferramenta útil para encontrar e corrigir erros resultantes de mudanças no LookML. Por exemplo, se você mudar o nome de um campo de customer para user, todos os Looks ou blocos do dashboard que incluíssem o campo customer não funcionarão mais, a menos que você tenha usado o parâmetro alias. O validador de conteúdo lista todas as referências ao campo customer e também fornece uma maneira fácil de corrigir o erro.
Quando você executa o validador de conteúdo, ele valida todas as referências que seus Looks e dashboards fazem aos modelos, Explores, visualizações e campos do LookML. Além disso, ele mostra um erro para todas as referências que o conteúdo faz a um objeto LookML desconhecido.
O validador de conteúdo não mostra erros relacionados ao seguinte:
- Conteúdo em que você não tem a permissão
develop. O validador de conteúdo tem como escopo suas permissões para que ele só possa ser usado no conteúdo em que você tem a permissãodevelop(os modelos que você encontra no ambiente de desenvolvimento integrado do Looker). Consulte a página de documentação Papéis para informações sobre permissões de modelo. - Looks que foram excluídos e estão na Lixeira. Para validar um Look excluído, o administrador do Looker precisa restaurar o Look primeiro.
Como executar o validador de conteúdo
Para validar o LookML com o validador de conteúdo, faça o seguinte:
- Clique em Validate (Validar).
- Selecione as guias Agrupar por para mudar a forma como os erros são agrupados:
- Error: lista cada erro, agrupando o conteúdo do Looker com ele. Isso é útil se você quiser corrigir o mesmo erro em várias partes do conteúdo de uma só vez.
- Pasta: liste cada pasta, agrupando o conteúdo do Looker que contém erros. Isso é útil se você quer corrigir apenas os erros em uma pasta específica.
- Conteúdo: liste cada conteúdo com erros, agrupando os erros. Isso é útil se você quiser corrigir todos os erros em um único Look, bloco, filtro etc.
- Se você estiver no Modo de Desenvolvimento, o Looker vai mostrar uma mensagem de aviso. É importante entender as implicações de mudar Looks e blocos. Se você os "corrigir" antes de ativar as alterações interruptivas, a correção será prematura por um período, e os usuários vão ter Looks ou blocos corrompidos. A mensagem de aviso ajuda você a lembrar disso.
- A tabela de erros mostra todos os erros, além de uma lista de Looks e blocos que o contêm, além do modelo e do Explore que estão produzindo o erro. Você pode usar as guias Agrupar por no canto superior direito da página para mudar o layout da tabela de erros.
- O Looker tem os botões Substituir e/ou Remover para cada linha, dependendo do tipo de erro. Esses botões oferecem uma funcionalidade para corrigir os erros e são descritos em mais detalhes abaixo.
Como visualizar os resultados da validação de conteúdo
Os resultados da validação de conteúdo mostram conteúdo do Looker que usa nomes de modelos, das Análises, de visualizações ou de campos que não existem ou não podem ser encontrados. Consulte a seção Como usar o validador de conteúdo para corrigir erros para mais detalhes sobre os elementos do LookML que o validador de conteúdo pode encontrar e validar.
O ícone ao lado do nome identifica o tipo de conteúdo:
: bloco do painel
: alerta do painel
: programe para um dashboard ou um Look
: filtre para um painel ou um campo em um bloco que detecta um filtro do painel. Consulte a página de documentação Como adicionar e editar filtros de painel definidos pelo usuário para mais informações sobre como configurar blocos para detectar filtros do painel.
Os resultados da validação são baseados no LookML disponível no modo em que você está ao executar o validador. Se você estiver no Modo de Produção, os resultados da validação vão refletir todo LookML enviado para produção. Se você estiver no Modo de Desenvolvimento, os resultados da validação vão refletir o LookML salvo, mesmo que ele não tenha sido enviado para produção.
Os erros podem ser causados por mudanças intencionais no LookML, bem como por um erro de digitação ou por uma junção ausente.
Para ajustar os erros, use os botões Substituir e Remover em cada linha da tabela de erros da seguinte maneira:
- Substituir: o Looker usa o botão Substituir para cada erro. Consulte a seção Substituir nomes de campos, visualizações, Análises e modelos mais adiante nesta página para saber como substituir nomes pelo validador de conteúdo.
- Remover: para erros com nomes de campo na seção Dados de um Look ou bloco, o Looker também mostra o botão Remover. Consulte a seção Remover um nome de campo mais adiante nesta página para saber como remover nomes com o validador de conteúdo.
Dependendo da configuração Agrupar por, os botões serão aplicados a um único item (Look ou bloco) ou a vários itens:
- Se você agrupar por Erro, os botões vão ser aplicados a todas as ocorrências desse erro em todos os Looks e blocos na sua instância do Looker, permitindo corrigir todas as ocorrências em uma única operação.
- Se você agrupar por Pasta ou Conteúdo, os botões serão aplicados a uma ocorrência do erro em um único Look ou bloco, o que permite considerar cada ocorrência do erro separadamente.
Por exemplo, uma tabela de erros é agrupada por Erro e mostra três instâncias de conteúdo com uma Análise desconhecida chamada customers. A ação fornecida para os três conteúdos é Substituir. Clicar em Substituir vai afetar as três instâncias de conteúdo com o erro 3 x Unknown explore 'customers'.
Em alguns casos, podem haver vários erros para o conteúdo. Por exemplo, uma tabela de erros é agrupada por Conteúdo e exibe um conteúdo chamado Detalhes do pedido. Há quatro erros Unknown field exibidos na coluna Erros, e cada erro tem seus próprios botões Substituir e Remover na coluna Ações.
Além disso, ao agrupar por Content, você tem a opção de excluir Looks.
Substituir nomes de campos, visualizações, Análises e modelos
Os resultados da validação de conteúdo incluem um botão Substituir para os seguintes tipos de elementos para que você possa renomeá-los:
- Nomes de modelos em Looks e blocos do dashboard
- Explorar nomes em Looks e blocos do dashboard
- Mostrar nomes em filtros personalizados ou cálculos de tabela
- Mostrar nomes em Looks e blocos do dashboard
- Nomes dos campos:
- Na seção Dados de um Look
- Em um bloco do painel baseado em consultas
- Mencionado em cálculos de tabela
- Mencionado em filtros personalizados
- Mencionado em campos personalizados
- Mencionado nas configurações de visualização, como a área Personalizações da guia Série para gráficos de colunas
- Referenciado por um bloco do painel para detectar um filtro do painel. Isso é configurado na guia Blocos a serem atualizados da janela de configuração de filtros, descrita na página de documentação Como adicionar e editar filtros de painel definidos pelo usuário.
Para qualquer um destes erros, você pode usar o validador de conteúdo para substituir um atributo do conteúdo igual ou mais geral que o atributo com erro:
- Se um campo apresentar erros, substitua/remova-o, ou substitua o nome da visualização, da Análise ou do modelo.
- Se um nome da Análise estiver incorreto, substitua o nome da Análise ou do modelo.
- Se o nome de um modelo apresentar erros, substitua o nome.
Confira como usar o validador de conteúdo para substituir os nomes dos elementos no seu modelo:
- Clique em Validar para executar o validador de conteúdo.
- Selecione uma configuração Agrupar por para escolher como os erros são agrupados. Por exemplo, você pode agrupar por Erro para ajustar vários itens ao mesmo tempo.
Na tabela de erros, clique no botão Substituir ao lado do erro que você quer corrigir para abrir a caixa de diálogo Atualizar no conteúdo.
Na seção Type da caixa de diálogo Update in Content, selecione o tipo de elemento do LookML que você quer mudar: campo, visualização, Análise ou modelo. O Looker mostra as opções adequadas para cada erro.
Na seção Nome, verifique o nome do item que você quer substituir. O validador de conteúdo preenche essas informações automaticamente.
Na seção Nome da substituição, digite o novo nome do item.
Se você tiver agrupado por Erro e vários itens forem afetados, clique em Mostrar conteúdo para conferir uma lista dos itens que serão atualizados pelo validador.
Você pode desmarcar as caixas de seleção ao lado de qualquer item listado para deixar o nome inalterado.
Para fazer a mudança, clique em Substituir.
Como remover um nome de campo
Para erros com nomes de campo na seção Data de um Look ou bloco, a tabela de erros fornecerá um botão Remove à direita do erro. Use o validador de conteúdo para remover campos:
- Na seção Dados de um bloco do Look ou dashboard
- Mencionado nas configurações de visualização, como a área Personalizações da guia Série para gráficos de colunas
- Referenciado por um bloco do painel para detectar um filtro do painel. Isso é configurado na guia Blocos a serem atualizados da janela de configuração de filtros, descrita na página de documentação Como adicionar e editar filtros de painel definidos pelo usuário.
Não é possível usar o validador de conteúdo para remover campos de filtros personalizados, campos personalizados ou cálculos de tabelas porque normalmente é necessário fazer outras alterações para manter a expressão funcionando. Em vez disso, use as mensagens de erro de validação de conteúdo para encontrar locais em que filtros personalizados, campos personalizados e expressões de cálculo de tabela precisem ser corrigidos e, em seguida, modifique a expressão conforme apropriado.
- Clique em Validar para executar o validador de conteúdo.
- Selecione uma configuração Agrupar por para escolher como os erros são agrupados. Por exemplo, você pode agrupar por Erro para ajustar vários itens (Looks, blocos ou ambos) ao mesmo tempo.
Na tabela de erros, clique em Remover ao lado do erro de campo que você quer corrigir para abrir a caixa de diálogo Remover campo do conteúdo.
Na seção Campo da caixa de diálogo Remover campo do conteúdo, verifique o nome do item que você quer remover. O validador de conteúdo preenche esse campo automaticamente.
Se você tiver agrupado por Erro e houver vários itens (Looks, blocos ou ambos), clique em Mostrar conteúdo para ver uma lista dos itens que o validador de conteúdo atualizará.
Também é possível desmarcar as caixas de seleção ao lado de qualquer Look ou bloco para deixar os nomes inalterados.
Clique em Remover campo para fazer a mudança.
Excluindo Looks
Ao agrupar a tabela de erros por Content, você tem a opção de excluir Looks na tabela.
Use o validador de conteúdo para excluir Looks:
- Clique em Validar para executar o validador de conteúdo.
- Agrupe a tabela por Conteúdo.
- Na tabela de erros, clique na caixa Selecionar ao lado do Look ou Looks que você quer excluir.
- Clique em Excluir todos os Looks selecionados.
- Clique em OK na caixa de confirmação para excluir o Look ou os Looks selecionados.
Como usar o validador de conteúdo para localizar e substituir
O validador de conteúdo também pode ser usado para pesquisar e substituir nomes de modelos, Análises e campos. Por exemplo, você pode decidir que prefere um campo em vez de outro e quer fazer essa substituição em seu projeto, mesmo que não haja erro. A lista completa de elementos que o validador de conteúdo pode pesquisar/substituir está disponível na seção Substituir nomes de campos, visualizações, Análises e modelos.
Para usar o validador de conteúdo como uma ferramenta de localizar e substituir, faça o seguinte:
- Na tela do validador de conteúdo, clique em Localizar e substituir em todo o conteúdo para abrir a caixa de diálogo Atualizar no conteúdo.
- Selecione o Tipo de elemento do LookML que você quer alterar (campo, visualização, análise ou modelo).
- Digite o Nome do item que você quer substituir.
- Insira um Nome de substituição para o campo, a visualização, a Análise ou o modelo.
- Clique em Substituir para fazer a alteração.
Informações importantes
Execute novamente a validação de conteúdo para ver os resultados das correções feitas.
Observações sobre o validador de conteúdo:
- Para visualizações, Análises ou modelos, é possível mudar os nomes, mas não remover totalmente. Consulte a seção Como remover um nome de campo para ver uma lista de itens que podem ser removidos com o validador de conteúdo.
- Os cálculos de tabela só podem referenciar campos que estão incluídos na consulta de um Look ou bloco. Isso significa que, se você remover um campo de uma consulta de Look ou bloco, mas um cálculo de tabela ainda usar esse campo, você vai receber um novo erro de validação de conteúdo.
- Os Looks que foram excluídos e estão na página da Lixeira não serão validados. Para validar um Look excluído, o administrador do Looker precisa restaurar o Look primeiro.
- Se você estiver no Modo de Desenvolvimento, os resultados da validação vão refletir o LookML salvo, mesmo que ele não tenha sido enviado para produção. No entanto, as alterações feitas com o Validador de conteúdo afetarão os usuários que visualizarem o conteúdo no modo de Production. Considere trocar para o modo de Production antes de executar o validador de conteúdo.