Configurações de administrador – Tabelas derivadas persistentes

As funções de tabelas derivadas persistentes (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 de TDPs.

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.
• 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 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 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 de 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

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, filtre por Status do último build para ver apenas as TDPs que estão com um erro de build ou 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.
   • 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 TDPs incluídas em um modelo 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 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 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 adicionar mais filtros e repita as etapas 2 e 3 para cada filtro que você adicionar.
   • Para limpar suas 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 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 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 as PDTs da produção. Estas são as TDPs que foram implantadas na produção na instância. essas TDPs fornecem os dados Analisar consultas. 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 Development mostra as TDPs 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 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 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 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 da TDP mostra 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 o PDT é uma visualização materializada no banco de dados.

Status da última tentativa

A coluna Status da última tentativa exibe o status da última tentativa de criar cada TDP 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.
• Sucesso indica que uma TDP foi criada.
• Em 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 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 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 Último build bem-sucedido indica o horário do último build de TDP bem-sucedido.

Duração do último build

A coluna Duração do último build exibe, em segundos, o tempo decorrido até 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 mostra o tipo de persistência aplicado a um PDT, conforme definido no arquivo de visualização do 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:

• Persistência por: (tempo) é exibido para PDTs que são persistidas com o parâmetro persist_for.
• Trigger: (datagroup name) é exibido para PDTs que são mantidos 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.
• 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 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 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 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 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 de três pontos Opções é útil para resolver problemas de comportamentos 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 criação mais recente com o tempo médio 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 PDT é definida, caso você tenha as permissões apropriadas para ver o LookML.
• Painel de atividades de TDP: abre o painel Atividades 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 de TDP 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.

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 do PDT. Estas são as informações que você pode 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 é 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 o PDT está ativado.
• 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: mostra 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ó no diagrama corresponde a uma tabela derivada. A cor de cada nó corresponde ao status dessa 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 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 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 perfil. O símbolo – aparece 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 PDTs que usam builds incrementais.
  • Deslocamento de incremento: 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:
  • Tipo: 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 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 datagroup, esse é o SQL para o parâmetro sql_trigger do datagroup. Para gatilhos SQL, é o SQL do parâmetro sql_trigger_value.
  • Valor do acionador: para TDPs 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 datagroup, 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 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 recompilaçã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 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 de 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 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 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.

É possível 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 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.

É 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 breve guia dos campos disponíveis na Análise Log de eventos da TDP:

Campo	Descrição
Ação	descreva a ação que ocorreu; isso pode incluir atividades de regeneração, lançamento, 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 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 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 do 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 gravada 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.