Configurações de administrador – Tabelas derivadas persistentes

As funções das tabelas derivadas persistentes (PDTs, na sigla em inglês) permitem fazer análises complexas no Looker. O Looker mostra vários recursos de administração que ajudam a rastrear e resolver problemas de comportamento da TDP na página Tabelas derivadas persistentes, que podem ser acessadas por administradores e usuários com as permissões apropriadas 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 de TDPs.

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

• A PDT é definida 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 ver a versão de desenvolvimento das tabelas mantidas.
• A TDP faz parte de um modelo configurado corretamente.
• A TDP faz parte de um modelo em que você tem acesso aos dados.

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

Personalizar a tabela

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

1. Clique na seta ao lado de Todas as conexões para visualizar as PDTs apenas de uma conexão específica. O seletor mostra apenas as conexões que têm PDTs ativadas e a que você tem acesso a dados.
2. Digite palavras-chave na caixa de pesquisa para restringir a lista a TDPs com nomes que incluem a palavra-chave. A tabela vai mostrar as TDPs 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 "Fechar/Abrir" para mostrar ou ocultar a seção Resumo.
5. Clique no nome de uma coluna para ordenar a tabela com base nela. Clique no nome da coluna uma segunda vez para inverter a ordem de classificação.
6. Clique no ícone Selecione as colunas a serem exibidas para ocultar ou mostrar as colunas na tabela.
7. Use o seletor de exibição para escolher o número de resultados exibidos em uma única página. Se a tabela for maior do que uma página, clique nas setas na parte inferior central para navegar até a página seguinte ou a anterior.

Filtragem

É possível usar o ícone Filtros ao lado da barra de pesquisa para escolher quais TDPs são mostradas na página Tabelas derivadas persistentes. Por exemplo, é possível filtrar por Status do último build para ver apenas as TDPs que estão com um erro de build. Se preferir, filtre por Modelo para limitar as TDPs mostradas a um modelo específico.

Para filtrar a página Tabelas derivadas persistentes:

1. Clique no ícone Filtros .
2. Selecione uma opção de filtro no primeiro seletor no menu de filtro. As seguintes opções estão disponíveis:
   • Não acionadas no último: filtra a página Tabelas derivadas persistentes por PDTs que não foram acionadas em um número especificado de horas e minutos.
   • Acionadas no último: filtra a página Tabelas derivadas persistentes por PDTs que foram acionadas em um número especificado de horas e minutos.
   • Modelo: filtra a página Tabelas derivadas persistentes para TDPs incluídas em um model especificado.
   • Regra de persistência: filtra a página Persistent Derived Tables 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 booleano que filtra a página Tabelas derivadas persistentes para TDPs e mostra Sim para TDPs publicadas como uma visualização estável e Não para TDPs que não foram publicadas como visualização estável, conforme determinado pelo valor do parâmetro publish_as_db_view.
   • Duração da última versão além do: filtra a página Tabelas derivadas persistentes por PDTs com builds que levaram mais 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 no qual você deseja filtrar a página Persistent Derived Tables no segundo seletor de filtro. Para as opções Não acionado nos últimos ou Acionado nas últimas, insira um número de horas ou minutos. Para a opção Duração do build maior que, digite um número de segundos.
4. Clique em Adicionar filtro para incluir mais opções e repita as etapas 2 e 3 para cada filtro que estiver adicionando.
   • Para limpar suas seleções de filtro e começar de novo a qualquer momento, clique em Limpar tudo.
   • Para remover filtros individuais adicionais, clique na opção Limpar do filtro que você deseja remover.
5. Para aplicar os critérios de filtro selecionados à página Tabelas derivadas persistentes, clique em Aplicar.

Os filtros aplicados serão exibidos no topo 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 de TDP

As seções a seguir descrevem as informações da 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 as PDTs da produção. Estas são as TDPs que foram implantadas na produção na sua instância. Elas fornecem os dados para as consultas de Análise dos usuários. Se você estiver no Modo de Produção ou se não tiver as permissões develop, a página Tabelas derivadas persistentes não exibirá nenhuma guia e mostrará informações apenas para TDPs de produção.

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

O Looker cria uma TDP de desenvolvimento quando um desenvolvedor do LookML no Modo de Desenvolvimento faz alterações que afetam os dados na PDT ou a forma como a PDT é consultada. Essas alterações fazem com que o Looker crie a PDT de desenvolvimento, mas não a cria, a menos que ela seja consultada após as alterações. A guia Desenvolvimento pode ajudar a determinar quais PDTs de desenvolvimento o Looker criou e se elas foram criadas.

Dica :também é possível visualizar PDTs 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 solicita que o Looker crie PDTs 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 TDPs exibidas atualmente na tabela de TDPs. Se você tiver definido filtros para a tabela ou usado a seta ao lado de Todas as conexões na parte superior 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 para fechar/abrir na parte de cima dela.

Colunas da tabela

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

Nome da TDP

A coluna Nome da TDP exibe o nome da TDP, conforme definido no parâmetro view do arquivo de visualização do LookML da TDP.

A coluna Nome da TDP exibe estas informações adicionais abaixo do nome da TDP, quando aplicável:

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

Status da última tentativa

A coluna Status da última tentativa exibe o status da última tentativa de criar cada TDP listada:

• Gerar novamente indica que a TDP pode ser consultada e que há uma tabela atualizada sendo criada. Um carimbo de data/hora indica quando a PDT começou a ser criada.
• Sucesso indica que uma TDP foi criada.
• Building (Criação) indica que uma PDT está sendo criada e não pode ser consultada até que a versão seja concluída.
• Não construído indica que uma TDP não foi criada no momento.
• Erro de versão indica que ocorreu um erro durante uma versão. Clique em Build Error para conferir a origem do erro e acesse o LookML da PDT se tiver as permissões apropriadas para ver o LookML. Consulte a seção do menu Opções nesta página para saber mais sobre como solucionar problemas de TDPs na página Tabelas derivadas persistentes.

Última tentativa em

A coluna Última tentativa no momento indica a hora da última tentativa de build de TDP.

Último build bem-sucedido

A coluna Último build bem-sucedido indica a hora do último build de TDP bem-sucedido.

Duração do último build

A coluna Duração da última versão mostra o tempo (em segundos) que levou para o build mais recente dessa PDT e quanto tempo leva para criar a PDT, em média, em segundos.

Regra de persistência

A coluna Regra de persistência exibe o tipo de persistência aplicado a uma PDT, conforme definido no arquivo de visualização da PDT. Também indica a última vez que uma TDP criada com sucesso foi verificada (para TDPs do tipo gatilho) ou quando uma TDP criada com sucesso está prestes a expirar (para TDPs do tipo persistente). Há dois tipos de persistência exibidos na coluna Regra de persistência:

• Persistir por: (tempo) é exibido para PDTs mantidas com o parâmetro persist_for.
• Acionador: (nome do grupo de dados) é exibido para PDTs mantidas com um parâmetro datagroup_trigger. Você pode clicar no link do nome do grupo de dados para ver o valor sql_trigger do parâmetro datagroup.
• Acionador: SQL é exibido para PDTs mantidas com um parâmetro sql_trigger_value. Você pode clicar no link para visualizar o extrato do sql_trigger_value.
• A visualização materializada é exibida para visualizações materializadas, que aproveitam a funcionalidade do seu banco de dados para manter tabelas derivadas no banco de dados.

Projeto

A coluna Projeto indica o nome do projeto do LookML em que a PDT está definida.

Conexão

Se a opção Todas as conexões for selecionada na seleção de conexão, a coluna Conexão aparecerá e exibirá o nome da conexão em que a PDT está ativada.

Modelo

A coluna Modelo exibe o nome do arquivo de modelo em que o arquivo de visualização da 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 serão exibidos na coluna Modelo. Se um arquivo de visualização de TDP estiver incluído em vários arquivos de modelo com conexões diferentes, a TDP também vai aparecer em outras listas de TDP de conexão.

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

Menu "Opções"

O menu de três pontos Opções é útil para resolver problemas de comportamentos inesperados. As opções apresentadas permitem que você verifique quando as tabelas foram criadas pela última vez, confira quanto tempo elas levaram para criar, compare o tempo de build mais recente com o tempo médio de build e verifique se os gatilhos estão funcionando corretamente. Você tem as seguintes opções:

• Acessar o LookML: abre o arquivo de visualização em que a PDT é definida, caso você tenha as permissões apropriadas para ver o LookML.
• Painel de atividades da TDP: abre o painel Atividade da 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 de TDP nesta página para mais informações.

Confira as dicas de solução de problemas na seção sobre como monitorar e solucionar problemas de TDPs na página de documentação Tabelas derivadas no Looker.

Modelo de detalhes da TDP

Clique na opção Detalhes da TDP no menu Opções de três pontos da TDP para ver o modal de detalhes da TDP.

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

• Nome da tabela: o hash da PDT mais recente criada com sucesso.
• Modelo: o nome do arquivo de modelo em que o arquivo de visualização da PDT está incluído.
• Nome estável: o nome da visualização do banco de dados estável da PDT no seu banco de dados, se a PDT tiver sido publicada como uma visualização estável. É possível publicar uma PDT como uma visualização estável no banco de dados adicionando a instrução publish_as_db_view: yes à tabela derivada ou usando a instrução materialized_view: yes para tornar a tabela derivada em uma visualização materializada.
• Conexão: o nome da conexão em que a PDT está ativada.
• Build antigo: é um booleano que exibe Sim se um build for de PDT antigo ou Não se não for.
  • Tipo de tabela: para builds antigos, esse campo aparece e mostra o tipo de tabela. Os valores incluem Tabela de geração antiga e Standin.
• TDP incremental: um booleano que exibe Sim se uma TDP for incremental ou Não se não for.
• Status: informa o status da última tentativa. Para builds com falha, fornece uma mensagem de erro SQL e um link para o LookML do modelo caso o usuário tenha as permissões apropriadas para ver o LookML.
• Dependências: clique no botão Mostrar gráfico de dependências para exibir um diagrama de relação de todas as tabelas derivadas das quais essa PDT depende. Cada nó do diagrama corresponde a uma tabela derivada. A cor de cada nó corresponde ao status dessa tabela derivada, da seguinte maneira:
  • Um nó verde representa uma TDP que foi criada com sucesso.
  • Um nó amarelo representa uma TDP que está sendo criada ou incrementada no momento.
  • 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.
• Último build:
  • Build bem-sucedido mais recente: a data e a hora do build de PDT bem-sucedido mais recente.
  • Duração do build mais recente: quanto tempo o build de TDP mais recente levou (em segundos; mostra – se a tabela ainda não foi criada).
  • Duração média do build: quanto tempo leva para criar a PDT, em média, em segundos (– se a tabela ainda não tiver sido criada).
  • Motivo do build: o motivo pelo qual uma PDT foi criada (incepção para um build inicial, datagroup acionado se a PDT for mantida com um grupo de dados, acionar mudança de valor se o valor do acionador SQL da PDT tiver sido alterado).
  • Increment Key: o parâmetro increment_key para TDPs que usam builds incrementais.
  • Deslocamento de incremento: o parâmetro increment_offset para PDTs que usam builds incrementais.
  • Incrementar linhas adicionadas/removidas da tabela: o número de linhas que foram adicionadas ou removidas da tabela quando ela foi incrementada pela última vez (exibe – se nenhuma linha tiver sido adicionada ou removida quando a estratégia de persistência acionou um incremento pela última vez).
  • Última tentativa do SQL: o SQL usado para consultar o banco de dados e criar o último build da tabela.
• Regra de persistência:
  • Tipo: o tipo de persistência usado pela tabela. Consulte a seção Coluna Regra de persistência nesta página para conhecer os possíveis valores.
  • Persistir para: no tipo Persistência de TDPs, o valor da duração da persistência. Não aplicável a TDPs do tipo Gatilho.
  • Grupo de dados: para PDTs do gatilho do grupo de dados, informe o nome do grupo.
  • Bloco de código SQL: para PDTs de gatilhos SQL e grupo de dados, o bloco de código vai mostrar a instrução SQL do gatilho. Para gatilhos de grupo de dados, é o SQL do parâmetro sql_trigger do grupo. Para gatilhos SQL, é o SQL do parâmetro sql_trigger_value.
  • Valor do acionador: para PDTs do tipo acionador, o valor que acionou o build da TDP (exibe – para TDPs criadas com êxito que são mantidas com um datagroup_trigger. Para ver o valor mais recente do acionador de um grupo de dados, consulte a página Grupos de dados no painel Administrador).
  • Última verificação: para TDPs do tipo Acionador, quando o valor do acionador foi verificado pela última vez.
  • Expira: quando a PDT expira, se aplicável (não aplicável a acionadores de grupos de dados).

Painel de atividades de TDP

O painel Atividade de TDP mostra informações sobre a TDP, as recriações e as consultas dela.

Por padrão, o painel Atividade de TDP mostra 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 TDP inclui blocos que mostram as seguintes informações:

• Um resumo da PDT que inclui o nome do modelo do LookML e a visualização que define a PDT, o nome da conexão do banco de dados que a PDT usa, o número total de tentativas de build bem-sucedidas e com falha da PDT e a porcentagem do total de tentativas de build com falha.
• A data e a hora da recriação completa mais recente da 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 reconstruir a 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 recriações de PDT que ocorreram durante o período do dashboard, incluindo a data de conclusão de cada recriação, o número de segundos necessários para concluir cada recriação, se as recriações eram incrementais, o gatilho que causou cada recompilação e o número de builds da TDP.
• Uma lista de todas as tentativas de recompilação com falha, incluindo a data e a hora de início da recompilação com falha, o tipo de erro que causou a falha, a mensagem de erro e o número de falhas na criação.
• Uma lista de todos os eventos de acionador de recriação da PDT, incluindo o número do ID, a data, o tipo e os dados incluídos no evento acionador.
• Uma lista de todos os eventos de recriação da PDT, incluindo o número do ID, a data, o tipo e os dados do evento de recriação.
• O número de consultas que consultaram diretamente um campo, agrupadas pela origem da consulta e pelo tempo de execução médio de cada origem da consulta.
• O número total de consultas executadas na PDT.
• Uma lista de todos os campos de TDP consultados, incluindo a visualização e o modelo do LookML em que o campo está 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.

Modelo de log de eventos de TDP

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

Você pode acessar o modelo com os links Eventos de build recentes e Eventos de gatilho recentes no menu de três pontos da página Opções da página Tabelas derivadas persistentes ou na página Conexões no painel Administrador do Looker.

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

É possível analisar o modelo como em qualquer outra Análise do Looker. Quando acessada pela página Conexões, a Análise do log de eventos de PDT é filtrada por toda a conexão. Quando acessada pela página Tabelas derivadas persistentes, a análise do log de eventos de TDP é filtrada para uma TDP específica.

Este é um guia rápido dos campos disponíveis na Análise do log de eventos de PDT:

Campo	Descrição
Ação	Descreve a ação que ocorreu. Isso pode incluir atividades de regeneração, exclusão, criação e coleta. Consulte a página de documentação Noções básicas sobre ações de registro de TDP para mais informações sobre como visualizar e entender essas ações 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 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 ações de registro de TDP para mais informações sobre como visualizar e entender essas ações 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 PDT. Em muitos casos, haverá apenas uma instância do Looker apontando para um banco de dados, então você verá um único ID. No entanto, se você tiver uma instância de teste ou algo dessa natureza, poderá ver vários IDs.
Nome do modelo	O nome do modelo por meio do qual a tabela foi gerada.
Data da ocorrência	A data e a hora em que o evento ocorreu.
Data de exibição de UTC	A data e a hora em que o evento ocorreu em UTC.
Sequência	Um número de etapa na versão de TDP.
Hash curto	Uma versão truncada do hash do SQL que foi escrito para criar a tabela derivada.
Nome da tabela	O nome completo da PDT, incluindo o prefixo de tipo de tabela, um hash e o nome da visualização.
Maré	O ID da transação.
Acessar nome	O nome da visualização da tabela derivada.