Configurações de administrador: tabelas derivadas persistentes

As funções de tabela derivada persistente (PDTs) do Looker permitem que você realize análises complexas. O Looker mostra vários recursos de administrador que podem ajudar a acompanhar e resolver problemas com PDTs na página Tabelas derivadas persistentes, que administradores e usuários com as permissões adequadas podem acessar na seção Banco de dados do painel Administrador do Looker. Consulte a página de documentação Tabelas derivadas no Looker para informações sobre como resolver problemas com PDTs.

Observação: para acessar todas as páginas de administrador no Looker, é necessário ter a função de administrador. Se você tiver uma permissão que ativa apenas partes do painel Administrador, como manage_schedules ou manage_themes, mas não tiver a função de administrador, o Looker talvez não mostre as páginas descritas neste artigo no painel Administrador. Além disso, a permissão see_admin concede permissão somente leitura para a maioria das páginas de administrador, mas não para todas. Consulte a descrição de see_admin para mais informações.

A página Tabelas derivadas persistentes mostra apenas as conexões que têm PDTs ativados e apenas as PDTs que atendem aos seguintes critérios:

• O PDT é definido em um arquivo de visualização que está em produção, a menos que você esteja no Modo de desenvolvimento. Nesse caso, use a guia Desenvolvimento para conferir a versão de desenvolvimento das tabelas persistidas.
• O PDT faz parte de um modelo configurado corretamente.
• O PDT faz parte de um modelo em que você tem acesso aos dados.

As informações nesta página são baseadas em um registro de eventos interno da PDT, descrito na seção Modelo de registro de eventos da PDT.

Personalizar a tabela

Por padrão, a página Tabelas derivadas persistentes mostra um máximo de 25 PDTs na página e carrega PDTs para todas as conexões em que você tem acesso a dados na instância do Looker. Há várias maneiras de mudar os dados que aparecem na tabela:

1. Clique na seta ao lado de Todas as conexões para conferir os PDTs de uma conexão específica. O seletor mostra apenas as conexões que têm PDTs ativadas e a que você tem acesso aos dados.
2. Digite palavras-chave na caixa de pesquisa para restringir a lista de PDTs aos que incluem a palavra-chave. A tabela vai mostrar os PDTs com o termo de pesquisa correspondente em negrito. Clique no X na barra de pesquisa para limpar os termos da consulta.
3. Clique no ícone Filtros para definir um filtro para a tabela.
4. Clique no ícone de fechar/abrir para mostrar ou ocultar a seção Resumo.
5. Clique no nome de uma coluna para classificar a tabela por ela. Clique no nome da coluna uma segunda vez para inverter a ordem de classificação.
6. Clique no ícone Selecionar colunas para exibir para ocultar ou mostrar colunas na tabela.
7. Use o seletor de exibição para escolher o número de resultados que aparecem em uma única página. Se a tabela for maior que uma página, clique nas setas na parte de baixo do centro da página para navegar até a próxima ou a anterior.

Filtragem

Use o ícone Filtros ao lado da barra de pesquisa para escolher quais PDTs são mostradas na página Tabelas derivadas persistentes. Por exemplo, você pode filtrar por Status do último build para ver apenas os PDTs que estão com um erro de build ou filtrar por Modelo para limitar os PDTs mostrados a um modelo específico.

Para filtrar a página Tabelas derivadas persistentes:

1. Clique no ícone Filtros .
2. Selecione uma opção no primeiro seletor de filtro do menu. As seguintes opções estão disponíveis:
   • Não acionada na última: filtra a página Tabelas derivadas persistentes por PDTs que não foram acionadas em um número especificado de horas e minutos.
   • Acionado no último: filtra a página Tabelas derivadas persistentes por PDTs que foram acionados em um número especificado de horas e minutos.
   • Modelo: filtra a página Tabelas derivadas persistentes para encontrar as TDPs incluídas em um modelo especificado.
   • Regra de persistência: filtra a página Tabelas derivadas persistentes por tipo de persistência de TDP.
   • Status da última tentativa: filtra a página Tabelas derivadas persistentes por um status de TDP especificado.
   • Publicado como visualização estável: um valor booleano que filtra a página Tabelas derivadas persistentes para PDTs e exibe Sim para PDTs que foram publicados como uma visualização estável e Não para PDTs que não foram publicados como uma visualização estável, conforme determinado pelo valor do parâmetro publish_as_db_view.
   • Duração do último build maior que: filtra a página Tabelas derivadas persistentes por TDPs cujos builds levaram mais tempo do que um número especificado de segundos.
   • Projeto: filtra a página Tabelas derivadas persistentes por PDTs do projeto do LookML especificado.
3. Escolha o valor pelo qual você quer filtrar a página Persistent Derived Tables no segundo seletor de filtro. Para as opções Não acionadas no último ou Acionadas no último, insira um número de horas ou minutos. Para a opção Duração do último build maior que, digite um número de segundos.
4. Clique em Adicionar filtro para adicionar mais filtros e repita as etapas 2 e 3 para cada filtro que você adicionar.
   • Para limpar as seleções de filtro e começar de novo a qualquer momento, clique em Limpar tudo.
   • Para remover filtros adicionais individuais, clique na opção Limpar do filtro que você quer remover.
5. Para aplicar os critérios de filtro selecionados à página Tabelas derivadas persistentes, clique em Aplicar.

Os filtros aplicados aparecem na parte de cima da página Tabelas derivadas persistentes.

Clique no X ao lado de um filtro aplicado na página Tabelas derivadas persistentes para remover o filtro da página Tabelas derivadas persistentes. Clique em Limpar tudo para limpar todos os filtros.

Noções básicas sobre a página de TDP

As seções a seguir descrevem as informações na página Tabelas derivadas persistentes.

Guias "Production" e "Desenvolvimento"

Se você for um desenvolvedor do LookML no Modo de desenvolvimento, a tabela Tabelas derivadas persistentes terá duas guias:

• A guia Produção é selecionada por padrão e mostra os PDTs de produção. São os PDTs implantados na produção na sua instância. Eles fornecem os dados das consultas de Explorar dos usuários. Se você estiver no Modo de produção ou não tiver permissões develop, a página Tabelas derivadas persistentes não vai mostrar nenhuma guia e vai exibir apenas informações de PDTs de produção.

• A guia Development mostra as TDPs de desenvolvimento. Os PDTs de desenvolvimento ainda não foram enviados para o ambiente de produção.

O Looker cria um PDT de desenvolvimento quando um desenvolvedor do LookML no modo de desenvolvimento faz mudanças que afetam os dados no PDT ou a forma como ele é consultado. Essas mudanças fazem com que o Looker crie o PDT de desenvolvimento, mas ele não cria o PDT, a menos que seja consultado após as mudanças. A guia Desenvolvimento pode ajudar você a determinar quais PDTs de desenvolvimento o Looker criou e se eles foram criados.

Dica: também é possível visualizar TDPs não criadas no seu projeto usando o ambiente de desenvolvimento integrado do Looker.

Consulte a página de documentação Tabelas derivadas no Looker para mais informações sobre o que faz com que o Looker crie PDTs de desenvolvimento e por quanto tempo eles são mantidos no seu banco de dados.

Seção "Resumo"

A seção Resumo mostra um resumo visual do status das TDPs que estão sendo exibidas na tabela. Se você definiu filtros para a tabela ou usou a seta ao lado de Todas as conexões na parte de cima da página para restringir a tabela a uma conexão específica, a seção Resumo vai restringir os resultados para corresponder ao que é mostrado na tabela de PDT.

Para mostrar ou ocultar a seção Resumo, clique no ícone de fechar/abrir na parte de cima da seção.

Colunas da tabela

As seções a seguir descrevem as colunas da tabela na página Tabelas derivadas persistentes. Clique no ícone Selecionar colunas para exibir para ocultar ou mostrar algumas das colunas da tabela. Para mais informações, consulte a seção Personalizar a tabela nesta página.

Nome da TDP

A coluna Nome do PDT mostra o nome do PDT conforme definido no parâmetro view do arquivo de visualização LookML do PDT.

A coluna PDT Name mostra as seguintes informações adicionais abaixo do nome do PDT, quando aplicável:

• Build antigo indica que a linha está mostrando informações sobre um build antigo do PDT. Consulte o pop-up Detalhes do PDT no menu Opções para mais informações sobre essa mensagem.
• Incremental indica que o TDP é um TDP incremental.
• Visualização materializada indica que o PDT é uma visualização materializada no banco de dados.

Status da última tentativa

A coluna Status da última tentativa mostra o status da última tentativa de criar cada PDT listada:

• Regeneração indica que o TDP pode ser consultado e que há uma tabela atualizada em criação. Um carimbo de data/hora indica quando o TDP começou a ser criado.
• Success indica que uma TDP foi criada.
• Criação indica que um TDP está sendo criado e não pode ser consultado até que a criação seja concluída.
• Not Built indica que um TDP não foi criado.
• Erro de build indica que ocorreu um erro durante um build. Clique em Build Error para conferir a origem do erro e navegue até o LookML do PDT se tiver as permissões adequadas para acessar o LookML. Consulte a seção Menu de opções nesta página para saber mais sobre como resolver problemas com TDPs na página Tabelas derivadas persistentes.

Última tentativa em

A coluna Last Attempted At indica o horário da última tentativa de build do PDT.

Último build bem-sucedido

A coluna Última build bem-sucedida indica o horário do último build bem-sucedido da TDP.

Duração do último build

A coluna Duração do último build mostra o tempo em segundos que o build mais recente desse TDP levou e o tempo médio em segundos para criar o TDP.

Regra de persistência

A coluna Regra de persistência mostra o tipo de persistência aplicado a um TDP, conforme definido no arquivo de visualização do TDP. Ele também indica a última vez que uma TDP criada foi verificada (para TDPs do tipo acionador) ou quando uma TDP criada vai expirar (para TDPs do tipo persistente). Há dois tipos de persistência exibidos na coluna Regra de persistência:

• Persistência por: (tempo) é exibido para PDTs que são persistidas com o parâmetro persist_for.
• Trigger: (nome do grupo de dados) é exibido para PDTs que são mantidos com um parâmetro datagroup_trigger. Clique no link do nome do grupo de dados para conferir o valor de sql_trigger para o parâmetro datagroup.
• Trigger: SQL é exibido para PDTs que são mantidos com um parâmetro sql_trigger_value. Clique no link para conferir o extrato sql_trigger_value.
• Visualização materializada é exibido para visualizações materializadas, que aproveitam a funcionalidade do banco de dados para manter tabelas derivadas.

Projeto

A coluna Project indica o nome do projeto do LookML em que o PDT é definido.

Conexão

Se Todas as conexões estiver selecionado, a coluna Conexão vai aparecer e mostrar o nome da conexão em que o PDT está ativado.

Modelo

A coluna Modelo mostra o nome do arquivo de modelo em que o arquivo de visualização do PDT está incluído.

Observação: se um arquivo de visualização de PDT for incluído em vários arquivos de modelo que compartilham a mesma conexão, vários modelos vão aparecer na coluna Modelo. Se um arquivo de visualização de PDT for incluído em vários arquivos de modelo com conexões diferentes, ele também vai aparecer em outras listas de PDT de conexão.

É importante ser explícito ao incluir arquivos de visualização em modelos, porque incluir todos os arquivos de visualização pode bagunçar o esquema do banco de dados e fazer com que várias cópias de PDTs sejam criadas no seu banco de dados ou em vários bancos de dados.

Menu Opções

O menu Opções de três pontos é especialmente útil para resolver problemas inesperados. As opções apresentadas permitem verificar quando as tabelas foram criadas pela última vez, quanto tempo elas levaram para ser criadas, comparar o tempo de build mais recente com o tempo médio de build e verificar se os gatilhos estão funcionando corretamente. Você pode escolher entre:

• Acessar o LookML: abre o arquivo de visualização em que o PDT é definido se você tiver as permissões adequadas para acessar o LookML.
• Painel de atividades de TDP: abre o painel Atividade de TDP, que é filtrado para mostrar a atividade da TDP selecionada nas últimas quatro semanas.
• Detalhes da TDP: abre um pop-up com mais informações e estatísticas de uma TDP específica. Consulte a seção Modal de detalhes do PDT nesta página para mais informações.

Consulte a seção Monitoramento e solução de problemas de PDTs na página de documentação Tabelas derivadas no Looker para dicas de solução de problemas.

Modal de detalhes da TDP

Clique na opção Detalhes do PDT no menu de três pontos Opções do PDT para abrir o modo de detalhes do PDT.

As informações no modal dependem da configuração do PDT. Estas são as informações que você pode encontrar:

• Nome da tabela: o hash da última TDP criada.
• Modelo: o nome do arquivo de modelo em que o arquivo de visualização da PDT é incluído.
• Nome estável: o nome da visualização de banco de dados estável do PDT no seu banco de dados, se o PDT foi publicado como uma visualização estável. Para publicar uma PDT como visualização estável no seu banco de dados, adicione a instrução publish_as_db_view: yes à tabela derivada ou use a instrução materialized_view: yes para transformar a tabela derivada em uma visualização materializada.
• Conexão: o nome da conexão em que o PDT está ativado.
• Build antigo: um booleano que mostra Sim se um build é antigo do PDT ou Não se não é.
  • Tipo de tabela: para builds antigos, esse campo aparece e mostra o tipo de tabela. Os valores incluem Tabela de Geração Antiga e Substituta.
• PDT incremental: um booleano que mostra Sim se um PDT é incremental ou Não se não for.
• Status: mostra o status da última tentativa. Para builds com falha, fornece uma mensagem de erro SQL e um link para o LookML do modelo, se o usuário tiver as permissões adequadas para acessar o LookML.
• Dependências: clique no botão Mostrar gráfico de dependência para exibir um diagrama de relacionamento de todas as tabelas derivadas de que essa PDT depende. Cada nó no diagrama corresponde a uma tabela derivada. A cor de cada nó corresponde ao status da tabela derivada, conforme mostrado a seguir:
  • Um nó verde representa uma TDP que foi criada.
  • Um nó amarelo representa uma TDP que está sendo criada ou incrementada.
  • Um nó vermelho representa uma TDP que não foi criada.
  • Um nó cinza representa uma TDP que ainda não foi criada.
  • Um nó branco representa uma tabela derivada temporária, que o Looker não cria.
• Build anterior:
  • Build bem-sucedido mais recente: a data e a hora do build de TDP bem-sucedido mais recente.
  • Duração da build mais recente: o tempo que a build TDP mais recente levou (em segundos; – será exibido se a tabela ainda não tiver sido criada).
  • Duração média do build: o tempo médio (em segundos) para criar a tabela de dados de produtos (PDT, na sigla em inglês). O símbolo – é exibido se a tabela ainda não tiver sido criada.
  • Motivo da build: o motivo pelo qual uma PDT foi criada (inception para uma build inicial; datagroup triggered se a PDT for mantida com um grupo de dados; trigger value change se o valor do gatilho SQL da PDT tiver mudado).
  • Increment Key: o parâmetro increment_key para PDTs que usam builds incrementais.
  • Increment Offset: o parâmetro increment_offset para PDTs que usam builds incrementais.
  • Linhas adicionadas/removidas do build incremental: o número de linhas que foram adicionadas ou removidas da tabela quando ela foi incrementada pela última vez (mostra – se nenhuma linha foi adicionada ou removida quando a estratégia de persistência da tabela acionou um incremento).
  • SQL da última tentativa: o SQL usado para consultar o banco de dados e criar a última versão da tabela.
• Regra de persistência:
  • Type: o tipo de persistência usado pela tabela. Consulte a seção Coluna "Regra de persistência" nesta página para conferir os valores possíveis.
  • Persist For: para PDTs do tipo Persist, o valor da duração da persistência. Não aplicável a PDTs do tipo Trigger.
  • Datagroup: para PDTs de gatilho de datagroup, informa o nome do datagroup.
  • Bloco de código SQL: para PDTs de grupo de dados e acionadores SQL, o bloco de código mostra a instrução SQL do acionador. Para gatilhos de datagroup, esse é o SQL para o parâmetro sql_trigger do datagroup. Para gatilhos SQL, esse é o SQL para o parâmetro sql_trigger_value.
  • Valor do acionador: para PDTs do tipo Acionador, o valor que acionou a criação do PDT (mostra – para PDTs criados com sucesso que são mantidos com um datagroup_trigger; para ver o valor do acionador mais recente de um datagroup, consulte a página Datagroups no painel Administrador).
  • Última verificação: para PDTs do tipo Trigger, quando o valor do gatilho foi verificado pela última vez.
  • Expira: quando o PDT expirar, se aplicável (não se aplica a acionadores de grupo de dados).

Painel de atividades de TDP

O painel Atividade do PDT mostra informações sobre o PDT, as reconstruções e as consultas.

O painel Atividade PDT mostra por padrão as informações de atividade das quatro semanas anteriores. É possível mudar o período mostrado usando a barra de filtro na parte de cima do painel. O painel Atividade de PDT inclui blocos que mostram as seguintes informações:

• Um resumo da TDP que inclui o nome do modelo e da visualização do LookML que definem a TDP, o nome da conexão do banco de dados que a TDP usa, o número total de tentativas de build bem-sucedidas e com falha da TDP e a porcentagem de tentativas de build que falharam.
• A data e a hora da reconstrução completa mais recente do PDT.
• Se a TDP for incremental, a data e a hora da recriação incremental mais recente da TDP.
• Se a TDP for incremental, o número de recriações incrementais que ocorreram desde a recriação completa mais recente.
• O tempo médio necessário para recriar o PDT.
• Uma visualização que mostra todos os eventos de criação que ocorreram recentemente, agrupados por um resumo dos tipos de ações que causaram os eventos.
• Uma lista de todas as reconstruções de PDT que ocorreram durante o período do painel, incluindo a data de conclusão de cada uma, o número de segundos necessários para concluir cada uma, se as reconstruções foram incrementais, o gatilho que causou cada uma e o número de builds de PDT.
• Uma lista de todas as tentativas de reconstrução com falha, incluindo a data e a hora em que a reconstrução começou, o tipo de erro que causou a falha, a mensagem de erro e o número de falhas de criação.
• Uma lista de todos os eventos de gatilho de recriação de PDT, incluindo o número do ID do evento, a data, o tipo e os dados incluídos no evento de gatilho.
• Uma lista de todos os eventos de reconstrução de PDT, incluindo o número do ID do evento, a data, o tipo e os dados incluídos no evento de reconstrução.
• O número de consultas que consultaram um campo diretamente, agrupadas pela origem da consulta e pelo tempo médio de execução de cada origem.
• O número total de consultas executadas no PDT.
• Uma lista de todos os campos do PDT consultados, incluindo a visualização e o modelo do LookML em que o campo é definido, o nome do campo, o nome da execução da Análise detalhada que incluiu o campo e o número de vezes que o campo foi incluído em uma consulta.

Modelo de registro de eventos da PDT

O Looker inclui um modelo pré-criado chamado system_activity, que permite a análise fácil do registro de eventos de PDT, uma tabela no esquema temporário de uma conexão de banco de dados que rastreia o gatilho e cria a atividade de PDTs.

É possível acessar o modelo com os links Recent Build Events e Recent Trigger Events no menu de três pontos Options da página Persistent Derived Tables ou na página Connections no painel Admin do Looker.

Para acessar a análise detalhada do registro de eventos da TDP na página Conexões, selecione a opção Mostrar registro de eventos da TDP no menu suspenso do ícone de engrenagem para cada conexão.

Você pode analisar o modelo como em qualquer outro recurso do Looker Explorar. Quando a página Conexões é acessada, a análise detalhada Registro de eventos do PDT é filtrada para toda a conexão. Quando a página Tabelas derivadas persistentes é acessada, a análise detalhada Registro de eventos de TDP é filtrada para uma TDP específica.

Este é um breve guia dos campos disponíveis na Análise do Log de eventos da TDP:

Campo	Descrição
Ação	Descreve a ação que ocorreu. Isso pode incluir regeneração, descarte, criação e atividade de colheita. Consulte a página de documentação Noções básicas sobre as ações de registro de PDT para mais informações sobre como visualizar e entender as ações de registro de PDT e os dados de ação correspondentes.
Dados de ações	Fornece detalhes mais específicos sobre uma ação, incluindo o acionador usado, o valor de um acionador, o tempo de expiração de uma tabela persistente, a causa de uma recriação, o texto de uma mensagem de erro e assim por diante. Consulte a página de documentação Noções básicas sobre as ações de registro de PDT para mais informações sobre como visualizar e entender as ações de registro de PDT e os dados de ação correspondentes.
Conexão	O nome da conexão em que a tabela derivada existe.
Hash	Cada tabela derivada contém um hash do SQL que foi escrito para criá-la.
ID	O ID exclusivo da instância do Looker que gerou o PDT. Em muitos casos, há apenas uma instância do Looker apontando para um banco de dados, então você só vai encontrar um ID. No entanto, se você tiver uma instância de teste ou algo semelhante, poderá encontrar vários IDs.
Nome do modelo	O nome do modelo em que a tabela foi gerada.
Data de ocorrência	A data e a hora em que o evento ocorreu.
Data de exibição do UTC	A data e a hora em que o evento ocorreu no fuso horário UTC.
Sequência	Um número de etapa no build da PDT.
Hash curto	Uma versão truncada do hash do SQL que foi gravada para criar a tabela derivada.
Nome da tabela	O nome completo do PDT, incluindo o prefixo do tipo de tabela, um hash e o nome da visualização.
Tid	O ID da transação.
Acessar nome	O nome da visualização da tabela derivada.