Configurações de administrador: tabelas derivadas persistentes

A página de administrador Persistent Derived Tables do Looker mostra o status das tabelas persistentes da instância do Looker, que incluem tabela derivada persistente e tabela agregada.

A página de administrador Tabelas derivadas persistentes mostra vários recursos que podem ajudar a rastrear e resolver problemas no comportamento das tabelas persistentes. Consulte a página de documentação Tabelas derivadas no Looker para informações sobre como resolver problemas com tabelas persistentes.

Os administradores do Looker e os usuários com a permissão see_pdts podem acessar a página Tabelas derivadas persistentes.

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 exiba 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 todas. Consulte a descrição de see_admin para mais informações.

Para abrir a página Tabelas derivadas permanentes, siga estas etapas:

1. Clique no ícone Menu principal do Looker e selecione Administrador, se o menu Administrador ainda não estiver sendo exibido. Se você estiver na seção Explorar ou Desenvolver do Menu principal do Looker, talvez seja necessário clicar na seta de retorno para acessar o menu Administrador.
2. No menu Administrador, selecione Tabelas derivadas persistentes.

A página Tabelas derivadas persistentes mostra apenas as conexões que estão ativadas para PDTs e apenas as tabelas persistentes que atendem aos seguintes critérios:

• A tabela persistente é definida em um arquivo de visualização 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 persistentes.
• A tabela persistente faz parte de um modelo configurado corretamente.
• A tabela persistente faz parte de um modelo a que você tem acesso aos dados.

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

Personalizar a tabela

Por padrão, a página Tabelas derivadas persistentes mostra no máximo 25 tabelas persistentes na página e carrega tabelas persistentes 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. Para visualizar apenas as tabelas persistidas de uma conexão específica, clique na seta ao lado de Todas as conexões e selecione o nome da conexão específica. O seletor mostra apenas as conexões que foram ativadas para PDTs e para as quais você tem acesso aos dados.
2. Insira palavras-chave na caixa de pesquisa para restringir a lista de tabelas persistidas a tabelas persistidas cujos nomes incluem a palavra-chave. A tabela vai mostrar as tabelas persistidas 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 página anterior ou seguinte.

Filtragem

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

Para filtrar a página Tabelas derivadas permanentes, siga estas etapas:

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 tabelas persistentes 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 tabelas persistentes acionadas em um número especificado de horas e minutos.
   • Modelo: filtra a página Tabelas derivadas persistentes para encontrar tabelas persistentes incluídas em um modelo especificado.
   • Regra de persistência: filtra a página Tabelas derivadas persistentes por tipo de persistência.
   • Status da última tentativa: filtra a página Tabelas derivadas persistentes por um status de tabela persistente especificado.
   • Publicado como visualização estável: um valor booleano que filtra a página Tabelas derivadas persistentes para tabelas persistentes e exibe Sim para tabelas persistentes publicadas como uma visualização estável e Não para tabelas persistentes que não foram publicadas 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 tabelas persistentes cujos builds levaram mais tempo do que um número especificado de segundos.
   • Projeto: filtra a página Tabelas derivadas persistentes por tabelas persistentes 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.

Como entender a página "Tabelas derivadas persistentes"

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

Guias "Produção" 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 as tabelas de produção persistidas. São as tabelas persistidas que foram implantadas na produção na sua instância. Elas fornecem os dados para as 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 tabelas persistentes de produção.

• A guia Desenvolvimento mostra as tabelas de desenvolvimento persistidas. As tabelas persistidas de desenvolvimento ainda não foram enviadas para o ambiente de produção.

O Looker cria uma tabela de desenvolvimento persistente quando um desenvolvedor do LookML no modo de desenvolvimento faz mudanças que afetam os dados na tabela persistente ou a forma como ela é consultada. Essas mudanças fazem com que o Looker crie a tabela persistente de desenvolvimento, mas ele não constrói a tabela persistente, a menos que ela seja consultada após as mudanças. A guia Desenvolvimento pode ajudar você a determinar quais tabelas de desenvolvimento persistentes o Looker criou e se elas foram criadas.

Dica: também é possível acessar tabelas persistidas não criadas no seu projeto usando o IDE 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 tabelas persistentes de desenvolvimento e por quanto tempo elas são mantidas no seu banco de dados.

Seção "Resumo"

A seção Resumo mostra um resumo visual do status das tabelas persistentes exibidas na tabela de tabelas persistentes. 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 tabelas persistentes.

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 da tabela persistente conforme definido no parâmetro view do arquivo de visualização LookML da tabela.

A coluna Nome do PDT mostra essas informações adicionais no nome da tabela persistente, quando aplicável:

• Build antigo indica que a linha está mostrando informações sobre um build de tabela persistido antigo. Consulte a caixa de diálogo Detalhes do PDT no menu Opções para mais informações sobre essa mensagem.
• Incremental indica que a tabela persistida é uma PDT incremental.
• Visualização materializada indica que a tabela persistida é uma visualização materializada no seu banco de dados.

Status da última tentativa

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

• Regeneração indica que a tabela persistente pode ser consultada e que uma tabela atualizada está sendo criada. Um carimbo de data/hora indica quando a tabela persistente começou a ser criada.
• Success indica que uma tabela persistente foi criada.
• Criação indica que uma tabela persistente está sendo criada e não pode ser consultada até que a criação seja concluída.
• Not Built indica que uma tabela persistente não foi criada.
• 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 da tabela persistente se tiver as permissões adequadas para acessar o LookML. Consulte a seção Menu de opções nesta página para saber como resolver problemas com tabelas persistentes na página Tabelas derivadas persistentes.

Última tentativa em

A coluna Última tentativa em indica o horário da última tentativa de criação de tabela persistente.

Último build bem-sucedido

A coluna Última build com êxito indica o horário do último build de tabelas persistentes com êxito.

Duração do último build

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

Regra de persistência

A coluna Regra de persistência mostra o tipo de persistência aplicado a uma tabela persistente, conforme especificado na definição do LookML da tabela. Ele também indica a última vez que uma tabela persistente criada foi verificada (para tabelas persistentes do tipo acionador) ou quando uma tabela persistente criada vai expirar (para tabelas persistentes do tipo persistente). Há dois tipos de persistência exibidos na coluna Regra de persistência:

• Persistência por: (tempo) é exibido para tabelas persistidas com o parâmetro persist_for.
• Trigger: (datagroup name) é exibido para tabelas persistidas 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 tabelas persistidas 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 a tabela armazenada é definida.

Conexão

Se Todas as conexões for selecionado na seleção de conexão, a coluna Conexão vai aparecer e mostrar o nome da conexão em que a tabela persistente está ativada.

Modelo

A coluna Model mostra o nome do arquivo de modelo associado à tabela armazenada em cache. Para um PDT, esse é normalmente o arquivo de modelo que inclui o arquivo de visualização em que o PDT é definido. Para uma tabela agregada, esse é normalmente o arquivo de modelo em que a tabela agregada é definida.

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 a tabela persistente é definida se você tiver as permissões adequadas para acessar o LookML.
• Painel de atividades de TDP: abre o painel Atividades de TDP, que é filtrado para mostrar a atividade da tabela persistente selecionada nas últimas quatro semanas.
• Detalhes de PDT: abre uma caixa de diálogo com mais informações e estatísticas sobre uma tabela persistente 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 ver 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 da tabela persistente para abrir o modo de detalhes do PDT.

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

• Nome da tabela: o hash da tabela persistente criada com sucesso mais recentemente.
• Modelo: o nome do arquivo de modelo em que o arquivo de visualização da tabela persistente é incluído.
• Nome estável: o nome da visualização de banco de dados estável da tabela armazenada no banco de dados, se a tabela armazenada foi publicada como uma visualização estável. Para publicar uma tabela persistente como uma visualização estável no seu banco de dados, adicione a instrução publish_as_db_view: yes à tabela de agregação ou PDT ou use a instrução materialized_view: yes para tornar a tabela derivada uma visualização materializada.
• Conexão: o nome da conexão em que a tabela persistente está ativada.
• Build antigo: um booleano que mostra Sim se um build é um build de tabela persistida antigo 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 valor booleano que mostra Sim se uma tabela persistente é um PDT incremental ou Não se não é.
• 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 tabela persistente 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 tabela persistente que foi criada.
  • Um nó amarelo representa uma tabela persistente que está sendo criada ou incrementada.
  • Um nó vermelho representa uma tabela persistente que não foi criada.
  • Um nó cinza representa uma tabela persistente que ainda não foi criada.
  • Um nó branco representa uma tabela derivada temporária, que o Looker não cria.
• Build anterior:
  • Última build bem-sucedida: a data e a hora da última build de tabela persistente bem-sucedida.
  • Duração da build mais recente: o tempo que a build mais recente da tabela persistente levou (em segundos; – será exibido se a tabela ainda não tiver sido criada).
  • Duração média do build: o tempo médio necessário para criar a tabela persistente (em segundos; – será exibido se a tabela ainda não tiver sido criada).
  • Motivo do build: o motivo pelo qual uma tabela foi criada (inception para um build inicial; datagroup triggered se a tabela persistida for persistida com um datagroup; trigger value change se o valor do gatilho SQL da tabela persistida tiver sido alterado).
  • Increment Key: o parâmetro increment_key para tabelas persistidas que usam builds incrementais.
  • Increment Offset: o parâmetro increment_offset para tabelas persistentes 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 tabelas persistidas do tipo Persist, o valor da duração da persistência. Não se aplica a tabelas persistentes do tipo Trigger.
  • Datagroup: para tabelas de acionamento de datagroup persistidas, fornece o nome do datagroup.
  • Bloco de código SQL: para grupos de dados e tabelas de acionadores SQL armazenadas em cache, 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 tabelas persistidas do tipo Acionador, o valor que acionou a criação da tabela persistida (mostra – para tabelas persistidas criadas com êxito que são persistidas com um datagroup_trigger; para conferir o valor de acionamento mais recente de um datagroup, consulte a página Datagroups no painel Administrador).
  • Última verificação: para tabelas persistidas do tipo Trigger, quando o valor do acionador foi verificado pela última vez.
  • Expira: quando a tabela persistida expira, se aplicável (não se aplica a gatilhos de grupo de dados).

Painel de atividades de TDP

O painel Atividade da PDT mostra informações sobre a tabela persistente, 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 tabela persistente que inclui o nome do modelo e da visualização do LookML que definem a tabela persistente, o nome da conexão do banco de dados que a tabela persistente usa, o número total de tentativas de build bem-sucedidas e com falha da tabela persistente e a porcentagem de tentativas de build que falharam.
• A data e a hora da reconstrução completa mais recente da tabela persistente.
• Se a tabela persistida for uma PDT incremental, a data e a hora da recriação incremental mais recente da PDT.
• Se a tabela persistente for uma TDP incremental, o número de reconstruções incrementais que ocorreram desde a reconstrução completa mais recente.
• O tempo médio necessário para reconstruir a tabela persistente.
• 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 tabelas persistidas que ocorreram durante o período do painel, incluindo a data de conclusão de cada recriação, o número de segundos necessários para concluir cada recriação, se as reconstruções foram incrementais, o acionador que causou cada recriação e o número de builds de tabelas persistidas.
• 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 acionamento de reconstrução de tabelas persistidas, incluindo o número do ID do evento, a data, o tipo e os dados incluídos no evento de acionamento.
• Uma lista de todos os eventos de reconstrução de tabelas persistentes, 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 na tabela persistente.
• Uma lista de todos os campos de tabela persistidos 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 que incluiu o campo e o número de vezes que o campo foi incluído em uma consulta.

Análise detalhada do log de eventos da TDP

O Looker inclui um modelo pré-criado chamado system_activity, que permite a exploração do registro de eventos do PDT, uma tabela no esquema temporário de uma conexão de banco de dados que rastreia o gatilho e cria atividades de tabelas persistentes.

É 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 Log de eventos da TDP na página Conexões, selecione a opção Mostrar log 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 tabela persistente específica.

Este é um breve guia dos campos disponíveis na Análise 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 que está sendo usado, o valor de um acionador, o tempo de expiração de uma tabela persistente, a causa de uma reconstrução e o texto de uma mensagem de erro. 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 a tabela armazenada em cache. 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 de tabelas persistentes.
Hash curto	Uma versão truncada do hash do SQL que foi gravada para criar a tabela derivada.
Nome da tabela	O nome completo da tabela armazenada, 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.