O validador de conteúdo pesquisa no LookML os nomes de modelo, Análise e campos referenciados no conteúdo do Looker. Ele é 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. Aqui, 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 Looks e dashboards, além dos links Explorar aqui. Se você cometer um erro, tente corrigir o quanto antes, antes que outras mudanças dificultem o isolamento dos Looks afetados.
Além disso, considere o tempo ao 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 Looks e 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 mudanças. Da mesma forma, se você atrasar a correção de Looks e blocos até muito depois de enviar as alterações, os Looks e os blocos aparecerão corrompidos para os usuários até que sejam corrigidos.
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 um nome de campo de customer
para user
, todos os Looks ou blocos de dashboard 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 dashboards fazem a 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 tem como escopo suas permissões, para que você só possa usá-lo no conteúdo em que você tiver a permissãodevelop
(os modelos podem ser vistos 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. - Parece que foram excluídos e estão na Lixeira. Se você quiser validar um Look excluído, o administrador do Looker vai precisar restaurar o Look primeiro.
Como executar o validador de conteúdo
Para validar o LookML com o validador de conteúdo:
- Clique em Validate (Validar).
- Selecione as guias Agrupar por para mudar 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 de mudar Looks e blocos. Se você "corrigir" antes de ativar as alterações interruptivas, haverá um período em que a correção será prematura, e os usuários vão ter aparências ou blocos corrompidos. A mensagem de aviso ajuda você a lembrar disso.
- A tabela de erros exibe todos os erros, além de uma lista de Looks e blocos que contêm o erro, além do modelo subjacente e da Análise que estão causando 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 Substituir e/ou Remover para cada linha, dependendo do tipo de erro. Esses botões oferecem funcionalidades para corrigir os erros e são descritos em mais detalhes em Como usar o validador de conteúdo para corrigir erros.
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, nomes de modelos, nomes de visualizações ou de campos que não existem ou não foram encontrados. Consulte a seção Como usar o validador de conteúdo para corrigir erros para ver detalhes sobre os elementos do LookML que o validador de conteúdo 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 detecta um filtro de painel. Consulte a página de documentação Como adicionar e editar filtros de painel definidos pelo usuário para informações sobre como configurar blocos para detectar 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 refletirão todos os LookML que foram enviados 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 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 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 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 Look ou bloco, o que permite considerar cada ocorrência do erro separadamente.
Por exemplo, uma tabela de erros é agrupada por Erro e exibe 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, podem existir vários erros para partes do conteúdo. 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, ao agrupar por Conteúdo, você tem a opção adicional 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 de dashboard
- Explorar nomes nos blocos de Looks e dashboard
- Confira os nomes em filtros personalizados ou cálculos de tabela
- Mostrar nomes nos blocos de Looks e dashboard
- Nomes de campos:
- Na seção Dados de um Look
- em um bloco do painel baseado em consulta;
- Referenciado em cálculos de tabela.
- Referenciados em filtros personalizados.
- Referenciados 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 do 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 o nome da visualização, da Análise ou 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 apropriadas 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 houver vários itens que serão afetados, clique em Mostrar conteúdo para ver uma lista de itens que o validador de conteúdo 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 um nome de 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. É possível usar o validador de conteúdo para remover campos que:
- Na seção Dados de um bloco do Look ou do dashboard
- 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 do 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 alterações adicionais 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 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 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 Select 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 o 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 os nomes de modelos, Análises e campos. Por exemplo, talvez você decida que prefere um campo em vez de outro e quer fazer essa substituição no projeto, mesmo que não haja 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 localização e substituição:
- Na tela "Validador de conteúdo", clique em Localizar e Substitua-o 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
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 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 incluídos na consulta de um Look ou um bloco. Isso significa que, se você remover um campo da consulta de um Look ou um bloco, mas um cálculo de tabela ainda usar esse campo, você receberá um novo erro de validação de conteúdo.
- Os visuais que foram excluídos e 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 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.