Configurações de administrador: tabelas derivadas persistentes

As funções de tabelas derivadas persistentes (TDPs) do Looker permitem fazer análises complexas no Looker. O Looker exibe vários recursos de administração que ajudam a rastrear e resolver problemas de comportamento da TDP na página Tabelas derivadas persistentes, que os administradores e usuários com as permissões apropriadas 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 saber como resolver problemas de TDPs.

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

• A TDP é definida em um arquivo de visualização que está em produção, a menos que você esteja no Modo de Desenvolvimento. Nesse caso, é possível usar a guia Desenvolvimento para ver a versão de desenvolvimento das tabelas mantidas.
• A TDP faz parte de um modelo que está configurado corretamente.
• A TDP faz parte de um modelo em que você tem acesso a dados.

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

Personalizar a tabela

Por padrão, a página Tabelas derivadas persistentes mostra no máximo 25 TDPs na página e carrega 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 exibidos na tabela:

1. Clique na seta ao lado de Todas as conexões para visualizar as TDPs apenas de uma conexão específica. O seletor mostra apenas as conexões que têm TDPs ativadas e a que você tem acesso a dados.
2. Digite palavras-chave na caixa de pesquisa para restringir a lista de TDPs a TDPs com nomes que incluam a palavra-chave. A tabela 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 exibir ou ocultar a seção Resumo.
5. Clique no nome de uma coluna para ordenar a tabela por essa coluna. 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 exibir colunas na tabela.
7. Use o seletor de exibição para escolher o número de resultados que são mostrados em uma única página. Se a tabela for maior que uma página, clique nas setas na parte inferior central para acessar a próxima página ou a anterior.

Filtragem

É possível usar o ícone Filtros ao lado da barra de pesquisa para escolher quais TDPs são exibidas na página Tabelas derivadas persistentes. Por exemplo, é possível filtrar por Último status da versão para visualizar apenas as TDPs com um erro de versão ou filtrar por Modelo para limitar as TDPs exibidas a um modelo específico.

Para filtrar a página Tabelas derivadas persistentes:

1. Clique no ícone Filtros .
2. Escolha uma opção de filtro no primeiro seletor no menu de filtro. As seguintes opções estão disponíveis:
   • Não acionadas nos últimos: filtra a página Tabelas derivadas persistentes por TDPs 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 TDPs 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 Tabelas derivadas persistentes pelo tipo de persistência da 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 exibe Sim para TDPs que foram 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 além de: filtra a página Tabelas derivadas persistentes por TDPs com builds que levaram mais do que um número especificado de segundos.
   • Projeto: filtra a página Tabelas derivadas persistentes por TDPs do projeto LookML especificado.
3. Escolha o valor que você quer usar para filtrar a página Tabelas derivadas persistentes no segundo seletor de filtro. Para as opções Não acionado nos últimos ou Acionados na última, insira um número de horas ou de minutos. Para a opção Duração do último build maior que, insira um número de segundos.
4. Clique em Adicionar filtro para incluir mais filtros e repita as etapas 2 e 3 para cada filtro adicionado.
   • 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 para o filtro que deseja 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 removê-lo 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 LookML no Modo de Desenvolvimento, a tabela Tabelas derivadas persistentes terá duas guias:

• A guia Produção é selecionada por padrão e mostra as TDPs de produção. Essas são as TDPs que foram implantadas na produção na sua instância. Elas fornecem os dados para as consultas da Análise 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 só vai mostrar informações de TDPs de produção.

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

O Looker cria uma TDP de desenvolvimento quando um desenvolvedor do LookML no Modo de Desenvolvimento faz mudanças que afetam os dados na TDP ou a maneira como a TDP é consultada. Essas mudanças solicitam que o Looker crie a TDP de desenvolvimento, mas, na verdade, o Looker não cria a TDP, a menos que ela seja consultada depois que as alterações forem feitas. A guia Desenvolvimento pode ajudar a determinar quais TDPs de desenvolvimento o Looker criou e se elas foram criadas.

Dica :você também pode conferir 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 ter mais informações sobre o que leva o Looker a criar TDPs 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 que aparecem 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 restringirá os resultados para corresponder ao que é mostrado na tabela de TDP.

Para mostrar ou ocultar a seção Resumo, clique no ícone 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 exibir algumas colunas da tabela. Para saber mais, consulte a seção Como 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 essas informações adicionais sob o 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 essa mensagem.
• Incremental indica que a TDP é uma TDP incremental.
• Visualização materializada indica que a TDP é 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 uma tabela atualizada está sendo criada. Um carimbo de data/hora indica quando a TDP começou.
• Sucesso indica que uma TDP foi criada.
• Criação indica que uma TDP está sendo criada no momento e não pode ser consultada até que a versão seja concluída.
• Não criada indica que uma TDP não foi criada no momento.
• Erro de build indica que ocorreu um erro durante a criação. Clique em Build Error para conferir a origem do erro e navegue até o LookML da TDP se você tiver as permissões apropriadas para conferir o LookML. Consulte a seção Menu "Opções" nesta página para saber mais sobre como resolver problemas de TDPs na página Tabelas derivadas persistentes.

Última tentativa em

A coluna Última tentativa em indica a hora da última tentativa de build da 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 do último build exibe o tempo em segundos necessário para o build mais recente da TDP e quanto tempo leva, em média, para criar a TDP.

Regra de persistência

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

• Persistir por: (tempo) é exibido para TDPs mantidas com o parâmetro persist_for.
• Acionador: (nome do grupo de dados) é exibido para TDPs que são mantidas com um parâmetro datagroup_trigger. Clique no link do nome do grupo de dados para ver o valor sql_trigger do parâmetro datagroup.
• Acionador: SQL é exibido para TDPs que são mantidas com um parâmetro sql_trigger_value. Clique no link para visualizar a instrução sql_trigger_value.
• A visualização materializada é exibida para visualizações materializadas, que usam a funcionalidade do seu banco de dados para manter as tabelas derivadas nele.

Projeto

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

Conexão

Se Todas as conexões estiver selecionada na seleção de conexão, a coluna Conexão será exibida e exibirá o nome da conexão em que a TDP está ativada.

Modelo

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

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

É importante ser explícito ao incluir arquivos de visualização em modelos, já que incluir todos os arquivos de visualização pode desorganizar o esquema do banco de dados e fazer com que várias cópias de TDPs 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 é especialmente útil para solucionar problemas de comportamento inesperado. As opções apresentadas permitem verificar quando as tabelas foram criadas pela última vez, conferir quanto tempo elas levaram para criar, 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:

• Go to LookML: abre o arquivo de visualização em que a TDP é definida se você tem as permissões apropriadas para ver 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 da TDP nesta página para mais informações.

Consulte a seção Monitoramento e solução de problemas de TDPs 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 da TDP no menu de três pontos Opções da TDP para ver o modal de detalhes da TDP.

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

• Nome da tabela: o hash da TDP mais recente criada.
• Modelo: o nome do arquivo modelo em que o arquivo de visualização da TDP está incluído.
• Nome estável: o nome da visualização do banco de dados estável da TDP no seu banco de dados, se a TDP tiver sido publicada como uma visualização estável. É possível publicar uma TDP como uma visualização estável no seu banco de dados adicionando a instrução publish_as_db_view: yes à tabela derivada ou usando 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 a TDP está ativada.
• Build antigo: um booleano que mostra Yes se o build for um build TDP antigo ou No caso não seja.
  • Tipo de tabela: para builds antigos, esse campo é exibido e mostra o tipo de tabela. Os valores incluem Tabela de geração antiga e Standin.
• TDP incremental: um booleano que exibe Sim se a TDP for uma TDP 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, se o usuário tiver as permissões apropriadas para ver o LookML.
• Dependencies: clique no botão Show Dependency Graph para mostrar um diagrama de relação de todas as tabelas derivadas de que essa TDP depende. Cada nó no diagrama corresponde a uma tabela derivada. A cor de cada nó corresponde ao status da 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 incrementando.
  • 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:
  • Último build bem-sucedido: a data e a hora do build de TDP mais recente bem-sucedido.
  • Duração do build mais recente: quanto tempo o build da TDP mais recente levou (em segundos; exibe – se a tabela ainda não tiver sido criada).
  • Duração média do build: quanto tempo leva para criar a TDP em média (em segundos; exibe – se a tabela ainda não tiver sido criada).
  • Motivo do build: o motivo da criação de uma TDP (início de um build inicial, datagroup acionado se a TDP for mantida em um grupo de dados, mudança do valor do acionador se o valor do acionador SQL da TDP foi alterado).
  • Chave de incremento: o parâmetro increment_key para TDPs que usam builds incrementais.
  • Increment Offset: o parâmetro increment_offset para TDPs que usam builds incrementais.
  • Increment Build Add/Removed Rows: o número de linhas que foram adicionadas ou removidas da tabela quando esta foi incrementada pela última vez (exibe – se nenhuma linha foi adicionada ou removida quando a estratégia de persistência da tabela acionou um incremento pela última vez).
  • SQL da última tentativa: o SQL usado para consultar o banco de dados para criar o último build da tabela.
• Regra de persistência:
  • Tipo: o tipo de persistência usado pela tabela. Consulte a seção Regra de persistência nesta página para ver os possíveis valores.
  • Persistir para: para TDPs do tipo Persistência, o valor da duração da persistência. Não relevante para TDPs do tipo acionador.
  • Datagroup: para TDPs do acionador do datagroup, fornece o nome do datagroup.
  • Bloco de código SQL: para TDPs de gatilhos de datagroup e SQL, o bloco de código mostra a instrução SQL do acionador. Para gatilhos de datagroup, esse é o SQL do parâmetro sql_trigger do datagroup. Para gatilhos SQL, esse é o SQL do parâmetro sql_trigger_value.
  • Valor do acionador: para TDPs do tipo Acionador, o valor que acionou o build da TDP (mostra – para TDPs criadas com sucesso 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 em: quando a TDP expira, se aplicável (não aplicável para acionadores do datagroup).

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 atividades das quatro semanas anteriores. Você pode alterar o período mostrado usando a barra de filtro na parte superior do painel. O painel Atividade de TDP inclui blocos que mostram as seguintes informações:

• Um resumo da TDP que inclui o nome do modelo LookML e a visualização que definem a TDP, o nome da conexão de 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 do total de tentativas de build que falharam.
• A data e a hora da recriação completa mais recente da TDP.
• Se a TDP for incremental, são a data e a hora da recriação incremental mais recente da TDP.
• Se a TDP for incremental, é o número de recompilações incrementais que ocorreram desde a recompilação completa mais recente.
• O tempo médio necessário para recriar a TDP.
• Uma visualização mostrando 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 recompilações de TDP 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 recriações eram builds incrementais, o gatilho que causou cada recriação e o número de builds de TDP.
• Uma lista de todas as tentativas de recriação que falharam, incluindo a data e a hora em que a recriação com falha começou, o tipo de erro que a causou, a mensagem de erro e o número de falhas de criação.
• Uma lista de todos os eventos do acionador de recriação de TDPs, incluindo o número de ID, a data, o tipo e os dados incluídos com o evento acionador.
• Uma lista de todos os eventos de recriação da TDP, incluindo o número do ID, a data, o tipo e os dados incluídos no evento de recriação.
• O número de consultas que consultaram diretamente um campo, agrupadas pela origem da consulta e pelo ambiente de execução médio de cada origem da consulta.
• O número total de consultas executadas na TDP.
• 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 o incluiu e o número de vezes que o campo foi incluído em uma consulta.

Modelo do log de eventos da TDP

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

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

Para acessar o 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 acessado na página Conexões, a Análise do Log de eventos de TDP é filtrada para toda a conexão. Quando acessado da página Tabelas derivadas persistentes, a Análise do registro de eventos de TDP é filtrada para uma TDP específica.

Este é um guia rápido para os campos disponíveis na Análise do Log de eventos de TDP:

Campo	Descrição
Ação	Descreve a ação que ocorreu. Isso pode incluir atividades de regeneração, queda, criação e colheita. Consulte a página de documentação Noções básicas sobre ações de registro da TDP para mais informações sobre como visualizar e entender as ações de registro da TDP e os dados de ação correspondentes.
Dados de ações	Fornece detalhes mais específicos sobre uma ação, incluindo o gatilho que está sendo usado, o valor de um gatilho, 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 da TDP para mais informações sobre como visualizar e entender as ações de registro da TDP 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 TDP. Em muitos casos, haverá apenas uma instância do Looker apontando para um banco de dados, portanto, você verá apenas um único ID. No entanto, se você tiver uma instância de teste ou algo do mesmo tipo, vai encontrar vários IDs.
Nome do modelo	O nome do modelo pelo qual a tabela foi gerada.
Data da ocorrência	A data e a hora em que o evento ocorreu.
Data de exibição da ocorrência de Utc	A data e a hora em que o evento ocorreu em UTC.
Sequência	Um número de etapa no build da TDP.
Hash curto	Uma versão truncada do hash do SQL que foi gravado para criar a tabela derivada.
Nome da tabela	O nome completo da TDP, incluindo o prefixo do 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.