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 (visualizações e painéis). É uma ferramenta útil para validar suas referências do LookML, corrigir erros no LookML depois de fazer alterações e atualizar os nomes dos elementos do LookML no projeto.
Você precisa ter a permissão develop para usar o validador de conteúdo.
O raciocínio é que um desenvolvedor precisa corrigir o conteúdo que pode ser corrompido quando o desenvolvedor faz alterações no LookML.
Para abrir o validador de conteúdo, selecione Validador de conteúdo no menu Develop no painel de navegação principal. 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 Encontrar e substituir em todo o conteúdo para encontrar e substituir os nomes de modelo, análise ou campo no conteúdo do Looker, mesmo que haja erros nele.
Antes de usar o validador de conteúdo
É extremamente importante ter cuidado ao fazer mudanças 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 painéis, além dos links Explorar a partir 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. Quando você envia mudanças de desenvolvimento para a produção, é necessário corrigir os Looks e blocos afetados aproximadamente ao mesmo tempo para que eles sejam interrompidos pelo menor período possível. 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ê atrasar a correção de Looks e blocos até muito tempo depois de enviar as mudanças, eles vão aparecer quebrados para os usuários até que sejam corrigidos.
Como usar o Content Validator 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, 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 vai listar todas as referências ao campo customer e também vai fornecer botões Replace ou Remove para corrigir o erro.
Quando você executa o validador de conteúdo, ele valida todas as referências que seus Looks e painéis fazem aos modelos, análises detalhadas, visualizações e campos do LookML e mostra um erro para todas as referências que seu conteúdo faz a um objeto desconhecido do LookML.
O validador de conteúdo não mostra erros para o seguinte:
- Looks excluídos e que estão na Lixeira. Se você quiser validar um Look excluído, o administrador do Looker precisa restaurá-lo primeiro.
Conteúdo baseado em modelos do LookML para os quais você não tem permissão
develop. O Validador de conteúdo só pode ser usado em conteúdo baseado em modelos para os quais você tem permissãodevelop(os modelos que aparecem no ambiente de desenvolvimento integrado do Looker). Consulte a página de documentação Papéis para informações sobre as permissões do modelo.
Como executar o validador de conteúdo
Para melhorar o desempenho do validador de conteúdo, um administrador do Looker pode ativar o recurso de laboratórios Escopo do validador de conteúdo na sua instância. Quando esse recurso do Labs está ativado, é possível definir o escopo da validação para projetos específicos do LookML e uma pasta de conteúdo específica. Consulte a seção Como definir o escopo do validador de conteúdo para saber como definir o escopo da validação.
Se o recurso do Content Validator Scoping Labs não estiver ativado na sua instância, siga estas etapas para executar a validação de conteúdo:
- Clique no ícone Menu principal do Looker e selecione Desenvolver, se o menu Desenvolver ainda não estiver aberto.
- No menu Develop, selecione Content Validator.
- Na página do validador de conteúdo, clique em Validar.
O validador de conteúdo vai validar todo o conteúdo baseado em projetos do LookML para os quais você tem permissão develop e mostrar os resultados. Consulte a seção Como conferir os resultados da validação de conteúdo para saber como analisar os resultados.
Como definir o escopo do validador de conteúdo
Quando o recurso de laboratórios Escopo do validador de conteúdo está ativado, é possível definir o escopo da validação para projetos específicos do LookML e uma pasta de conteúdo específica (incluindo as subpastas, se houver). Isso pode melhorar o desempenho do validador de conteúdo.
Observe o seguinte para o escopo do validador de conteúdo:
- Se você não especificar uma pasta ou um projeto do LookML, a validação não terá escopo. O validador de conteúdo valida todo o conteúdo baseado em modelos para os quais você tem permissão
develop. - Se você especificar uma pasta de conteúdo, o Validador de conteúdo vai executar a validação na pasta de conteúdo e em todas as subpastas, se houver.
- Se você especificar uma pasta de conteúdo e um ou mais projetos do LookML, ambas as condições serão aplicadas: o validador de conteúdo vai validar apenas o conteúdo na pasta (e subpastas) com base nos projetos do LookML selecionados.
- Os alertas, as programações de painéis e de Looks não são armazenados em pastas de conteúdo. Portanto, se você definir o escopo da validação de conteúdo para uma pasta, o Content Validator não vai validar nenhuma programação ou alerta.
Se você especificar um projeto do LookML, o Validador de conteúdo vai determinar os modelos associados do projeto analisando o LookML de origem dos projetos especificados e os modelos configurados para cada projeto, que podem ser vistos na página Projetos do LookML. Se um arquivo de modelo for excluído de um projeto do LookML e não for mostrado como um modelo no projeto na página Projetos do LookML, o Validador de conteúdo não vai mostrar erros relacionados ao conteúdo com base nesse modelo excluído.
Para executar o validador de conteúdo em uma instância do Looker com o Escopo do validador de conteúdo ativado, siga estas etapas:
- Clique no ícone Menu principal do Looker e selecione Desenvolver, se o menu Desenvolver ainda não estiver aberto.
- No menu Develop, selecione Content Validator.
Na página do validador de conteúdo, clique em Validar.
O Validador de conteúdo mostra a caixa de diálogo Choose Projects to Validate.
Na caixa de diálogo Choose Projects to Validate, faça o seguinte:
- Para executar o validador em todos os projetos do LookML, deixe o campo Selecionar projetos como está, sem projetos selecionados, e clique em Avançar.
- Para executar o validador em um ou mais projetos específicos do LookML, clique no menu suspenso Selecionar projetos, selecione os projetos que você quer validar e clique em Próxima.
O Validador de conteúdo mostra a caixa de diálogo Choose Folder to Validate.
Na caixa de diálogo Choose Folder to Validate, faça o seguinte:
- Para executar o validador em todas as pastas de conteúdo, deixe o seletor Folders como está, sem pastas selecionadas, e clique em Next.
- Para executar o validador em uma pasta de conteúdo específica (e nas subpastas, se houver), use o seletor Folders para selecionar a pasta que você quer validar e clique em Next.
A caixa de diálogo Review Selections mostra os projetos e as pastas que você selecionou para validação.
Na caixa de diálogo Revisão das seleções, clique em Validar.
O validador de conteúdo vai validar o conteúdo especificado e mostrar os resultados. Consulte a seção Como conferir os resultados da validação de conteúdo para saber como analisar os resultados.
Como conferir os resultados da validação de conteúdo
Quando o validador de conteúdo conclui uma validação, ele mostra uma tabela de erros. Se um administrador do Looker tiver ativado o recurso de laboratórios Content Validator Scoping na sua instância, os resultados da validação serão aplicados aos projetos e pastas que você selecionou ao executar o Content Validator.
Os resultados da validação de conteúdo mostram conteúdo do Looker que usa nomes de modelos, nomes de análises, nomes de visualizações ou nomes de campos que não existem ou não podem ser 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.
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 a produção.
A tabela de erros mostra cada 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 causando o erro.
Use as guias Agrupar por no canto superior direito da página para mudar o layout da tabela de erros:
- Erro: liste cada erro, agrupando o conteúdo do Looker que tem o erro. Isso é útil se você quiser corrigir o mesmo erro em vários conteúdos de uma vez.
- Pasta: liste cada pasta, agrupando o conteúdo do Looker que tem erros. Isso é útil se você quiser corrigir apenas os erros em uma pasta específica.
- Conteúdo: liste cada conteúdo com erros e agrupe os erros. Isso é útil se você quiser corrigir todos os erros em um único visual, bloco, filtro etc.
O ícone ao lado do nome do conteúdo identifica o tipo de conteúdo:
: bloco do painel
: alerta do painel
: programar para um painel ou um 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.
Erros podem ser causados por mudanças intencionais no LookML, bem como por um erro de digitação ou uma mesclagem ausente.
Para cada linha, o Looker oferece um botão Replace ou Remove, ou ambos, 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. Para ajustar erros, use os botões Replace e Remove em cada linha da tabela de erros da seguinte maneira:
- 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 visual ou bloco, o Looker também mostra o botão Remover. Consulte a seção Como 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 Substituir e Remover 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 os três conteúdos é 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 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 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 do Look e do painel
- Analisar nomes em blocos de Looks e do painel
- Conferir nomes em filtros personalizados ou cálculos de tabela
- Mostrar nomes nos blocos de Looks e do painel
- Nomes dos campos:
- Na seção Dados de um visual
- Em um bloco de painel com base em consulta
- Referenciado em cálculos de tabela
- Referência em filtros personalizados
- Referenciado em campos personalizados
- É referenciado em configurações de visualização, como a área Customizations da guia Series para gráficos de colunas
- Referenciado por um Bloco do painel para monitorar um filtro do painel (configurado na guia Blocos a serem atualizados da janela de configuração do filtro, descrita 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 igual ou mais geral do que o atributo com erro:
- Se um campo estiver causando um erro, substitua ou remova o campo ou substitua a visualização, a Análise detalhada ou o nome do modelo.
- Se o nome de uma Análise estiver causando um erro, substitua o nome da Análise ou do modelo.
- Se um nome de modelo estiver causando um erro, substitua-o.
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 Replace ao lado do erro que você quer corrigir para abrir a caixa de diálogo Update in Content.
Na seção Tipo da caixa de diálogo Atualizar no conteúdo, selecione o tipo de elemento do LookML que você quer mudar: campo, visualização, Análise detalhada 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 vários itens forem afetados, clique em Mostrar conteúdo para conferir uma lista de itens que o Validador de conteúdo vai atualizar.
Se preferir, você pode limpar 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 campo na seção Dados de um visual ou bloco, a tabela de erros vai mostrar 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 em configurações de visualização, como a área Customizations da guia Series para gráficos de colunas
- Referenciado por um Bloco do painel para monitorar um filtro do painel (configurado na guia Blocos a serem atualizados da janela de configuração do filtro, conforme 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 lugares em que filtros personalizados, campos personalizados e expressões de cálculo de tabela precisam ser corrigidos e, em seguida, retrabalhe 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 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.
Você também pode limpar as caixas de seleção ao lado de qualquer visual ou bloco para manter os nomes inalterados.
Clique em Remover campo para fazer a mudança.
Como excluir Looks
Se você agrupar a tabela de erros por Conteúdo, terá a opção de excluir Looks na tabela.
Para usar 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 dos looks que você quer excluir.
- Clique no botão Excluir todos os Looks selecionados na parte de cima da tabela de erros.
- 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 e substituir está disponível na seção Como substituir nomes de campos, visualizações, análises detalhadas e modelos.
Para usar o Validador de conteúdo como uma ferramenta de localização 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 do 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.
Considerações
Planeje a reexecução da validação de conteúdo para conferir os resultados das correções feitas.
Observe o seguinte 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 visual ou 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 pasta Lixeira não são validados. Se você quiser validar um Look excluído, o administrador do Looker precisa restaurá-lo 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, qualquer mudança feita usando o validador de conteúdo vai afetar os usuários que visualizarem o conteúdo no modo de produção. Considere mudar para o modo de produção antes de executar o validador de conteúdo.