O validador de conteúdo procura no LookML o modelo, a análise e os nomes de campo que são referenciados no conteúdo do Looker. Ela é 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, no painel de navegação à esquerda. A partir daqui, você pode usar o Validador de conteúdo de duas maneiras:
- Clique em Validar para encontrar e corrigir erros causados por mudanças no modelo do LookML.
- Clique em Localizar e Substitua em "Todo o conteúdo" para encontrar e substituir os nomes do modelo, da Análise ou dos campos em todo o conteúdo do Looker, independente de haver erros no conteúdo do Looker.
Antes de usar o validador de conteúdo
Você precisa ter extremamente cuidado ao fazer alterações usando a validação de conteúdo. O validador de conteúdo não tem uma função de desfazer e pode afetar muitos painéis e links Explorar daqui. 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 momento de usar o validador de conteúdo. Ao enviar as mudanças de desenvolvimento para produção, é necessário corrigir os Looks e os blocos afetados aproximadamente ao mesmo tempo, para que eles sejam corrompidos pelo mínimo de tempo. Se você corrigir os Looks e os Blocos muito cedo, com base no seu trabalho no Modo de desenvolvimento, eles vão aparecer com problemas para os usuários até que você envie as mudanças. Da mesma forma, se você demorar para corrigir os Looks e os blocos até muito tempo depois de enviar as mudanças, eles vão aparecer quebrados 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 alterações no LookML. Por exemplo, se você mudar o nome de um campo de customer para user, os blocos de informações ou painéis que incluíam o campo customer não vão mais funcionar, a menos que você tenha usado o parâmetro alias. O validador de conteúdo lista todas as referências ao campo customer e fornece uma maneira fácil de corrigir o erro.
Quando você executa o Content Validator, ele valida todas as referências que os Looks e os dashboards fazem aos modelos, Análises, 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 desconhecido do LookML.
O validador de conteúdo não mostra erros para o seguinte:
- Conteúdo em que você não tem a permissão
develop. O validador de conteúdo está limitado às suas permissões. Assim, você só pode usar o validador de conteúdo no conteúdo para o qual você tem permissãodevelop(os modelos que aparecem no ambiente de desenvolvimento integrado do Looker). Para mais informações sobre permissões do modelo, consulte a página de documentação Papéis. - Looks excluídos e que estão na Lixeira. Se você quiser validar um Look excluído, seu administrador do Looker vai precisar restaurar o Look primeiro.
Como executar o validador de conteúdo
Para validar seu LookML com o Validador de conteúdo:
- Clique em Validate (Validar).
- Selecione as guias Agrupar por para mudar a forma como os erros são agrupados:
- Erro: liste cada erro, agrupando o conteúdo do Looker que apresenta o erro. Isso é útil quando você quer 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 com erros. Isso é útil se você quiser corrigir apenas os erros em uma pasta específica.
- Conteúdo: liste cada conteúdo que apresenta erros, agrupando os respectivos 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 da mudança de Looks e blocos. Se você "corrigir" os problemas antes de ativar as mudanças, haverá um período em que a correção será prematura, e os usuários vão encontrar problemas com os Looks ou blocos. A mensagem de aviso ajuda você a lembrar disso.
- A tabela de erros mostra qualquer erro, junto com uma lista de Looks e blocos que contêm o erro, além do modelo e da Análise que estão produzindo o erro. Você pode usar as guias Agrupar por no canto superior direito da página para alterar o layout da tabela de erros.
- O Looker oferece os botões Replace e/ou Remove para cada linha, dependendo do tipo de erro. Esses botões oferecem funcionalidade para corrigir os erros e são descritos em mais detalhes em Como usar o Content Validator para corrigir erros.
Como conferir 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, nomes de visualizações, nomes de visualizações ou de campos que não existem ou não foram encontrados. Consulte a seção Como usar o Content Validator para corrigir erros para saber mais sobre os elementos do LookML que o Content Validator pode encontrar e validar.
O ícone ao lado do nome do conteúdo identifica o tipo de conteúdo:
: bloco do painel
: alerta do painel
: programar para um dashboard ou Look
: filtro para um painel ou um campo em um Bloco que ouve um filtro de painel. Consulte a página de documentação Adicionar e editar filtros de painel definidos pelo usuário para informações sobre como configurar Blocos para ouvir filtros de 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 o 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 alterações intencionais no LookML, bem como um erro de digitação ou uma mesclagem ausente.
Para ajustar os erros, use os botões Substituir e Remover em cada linha da tabela de erros da seguinte forma:
- Substituir: o Looker oferece o botão Substituir para cada erro. Consulte a seção Como substituir nomes de campos, visualizações, análises detalhadas e modelos mais adiante nesta página para saber como substituir nomes com o Validador de conteúdo.
- Remover: para erros com nomes de campos 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 serão aplicados a todas as ocorrências desse erro em todos os Looks e blocos na sua instância do Looker, o que permite 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 visual 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 as três partes do conteúdo é Substituir. Clicar em Substituir afetaria as três instâncias de conteúdo com o erro 3 x Unknown explore 'customers'.
Em alguns casos, vários erros podem existir para alguns conteúdos. Por exemplo, uma tabela de erros é agrupada por Conteúdo e exibe uma parte do conteúdo chamada Detalhes do pedido. Há quatro erros Unknown field exibidos na coluna Erros, e cada erro tem seus próprios botões de ação Substituir e Remover na coluna Ações.
Além disso, se você agrupar por conteúdo, terá a opção de excluir Looks.
Como substituir nomes de campos, visualizações, análises detalhadas 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 nos blocos de Looks e do painel
- Explorar nomes nos blocos de Looks e dashboard
- Confira os nomes em filtros personalizados ou cálculos de tabela
- Mostrar nomes em blocos de Looks e do painel
- Nomes dos campos:
- Na seção Dados de um visual
- em um bloco do painel baseado em consulta;
- Referenciado em cálculos de tabela
- Referenciados em filtros personalizados.
- Referenciado em campos personalizados
- Referenciado 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 para atualizar da janela de configuração do filtro, descrito na página de documentação Como adicionar e editar filtros de painel definidos pelo usuário.
Para qualquer um desses erros, você pode usar o Validador de conteúdo para substituir um atributo do conteúdo que seja igual ou mais geral que o atributo com erro:
- Se um campo apresentar um erro, substitua/remova o campo ou substitua a visualização, a Análise detalhada ou o nome do modelo.
- Se houver um erro no nome da Análise, substitua o nome dela ou o nome do modelo.
- Se o nome de um modelo estiver com erro, é possível substituí-lo.
Veja 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, é possível 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 Content Validator preenche essas informações automaticamente.
Na seção Nome de substituição, insira o novo nome do item.
Se você tiver agrupado por Erro e houver vários itens afetados, clique em Mostrar conteúdo para conferir uma lista de itens que o Validador de conteúdo vai atualizar.
Opcionalmente, você pode desmarcar as caixas de seleção ao lado dos itens listados para manter os nomes inalterados.
Para fazer a mudança, clique em Substituir.
Como remover o nome de um campo
Para erros com nomes de campos na seção Dados de um Look ou bloco, a tabela de erros terá um botão Remover à direita do erro. Você pode usar o Validador de conteúdo para remover campos que:
- Na seção Dados de um bloco de um Look ou painel
- Referenciado 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 para atualizar da janela de configuração do filtro, descrito 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 tabela, porque normalmente é necessário fazer outras mudanças 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 precisam ser corrigidos e, em seguida, refaça 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, é possível 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 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 Content Validator 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 de itens que o Validador de conteúdo vai atualizar.
Também é possível desmarcar as caixas de seleção ao lado dos Looks ou blocos para não mudar os nomes.
Clique em Remover campo para fazer a alteração.
Como excluir Looks
Se você agrupar a tabela de erros por Content, vai ter a opção de excluir Looks na tabela.
Para usar o validador de conteúdo e excluir Looks, faça o seguinte:
- 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 dos 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 encontrar e substituir
O Validador de conteúdo também pode ser usado para pesquisar e substituir os 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 no seu projeto, mesmo que não haja um erro. A lista completa de elementos que o validador de conteúdo pode pesquisar/substituir é fornecida na seção Substituir nomes de campos, visualizações, Análises e modelos.
Para usar o validador de conteúdo como uma ferramenta de busca e substituição:
- Na tela do validador de conteúdo, clique em Encontrar e substituir em todo o conteúdo para abrir a caixa de diálogo Atualizar no conteúdo.
- Selecione o Tipo de elemento LookML que você quer mudar (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 detalhada ou o modelo.
- Clique em Substituir para fazer a mudança.
Informações importantes
Planeje uma nova execução da validação de conteúdo para conferir os resultados das correções feitas.
Observações sobre o validador de conteúdo:
- Para visualizações, análises detalhadas ou modelos, é possível mudar os nomes, mas não remover completamente. Consulte a seção Como remover um nome de campo para conferir uma lista de itens que podem ser removidos com o Validador de conteúdo.
- Os cálculos de tabela só podem referenciar campos incluídos na consulta de um Look ou um bloco. Isso significa que, se você remover um campo da consulta de um visual ou bloco, mas um cálculo de tabela ainda usar esse campo, vai receber um novo erro de validação de conteúdo.
- Looks excluídos e que estão na página Lixeira não serão validados. Se você quiser validar um Look excluído, o administrador do Looker vai precisar restaurar o Look excluído 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 a 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 mudar para o modo de Production antes de executar o validador de conteúdo.