Como entender as ações de registro da PDT

A análise Log de eventos da TDP em Atividade do sistema mostra informações sobre eventos históricos relacionados a TDPs, incluindo recriações e erros.

Por exemplo, a análise detalhada do registro de eventos do PDT pode ajudar a resolver falhas de build do PDT ou gatilhos presos. Ela também pode ser útil quando você está tentando identificar quando uma tabela específica foi criada e qual processo a criou.

Para mais informações sobre as Análises disponíveis na atividade do sistema, consulte a página de documentação Criar relatórios de uso do Looker com Análises de atividade do sistema.

Como conferir as ações de registro da PDT

As ações de registro de PDT aparecem na análise Log de eventos de PDT da atividade do sistema. Você precisa ser um administrador do Looker ou ter a permissão see_system_activity para acessar a análise detalhada Registro de eventos do PDT.

Para conferir uma lista de ações de registro da TDP e os dados de ação de registro associados, selecione os campos Ação e Dados da ação, além de outros campos, na visualização Log de eventos da TDP em Explorar, que pode ser acessada no menu Explorar.

Como entender as ações de registro da PDT e os pares de dados de ação de registro da PDT correspondentes

As tabelas a seguir detalham as diferentes ações de registro no PDT Event Log (registro de eventos do PDT), além dos valores de dados correspondentes para cada ação, para os seguintes tipos de eventos:

As tabelas a seguir usam os campos Ação e Dados da ação na visualização Registro de eventos da PDT do recurso Análise do registro de eventos da PDT.

Criar eventos

Ação de registro Descrição da ação de registro Registrar dados de ações Descrição dos dados da ação de registro
create begin Ocorre quando a linha de execução do regenerador escolhe o PDT. prod-user-x Indica que o usuário fez uma consulta à TDP na Análise detalhada e a tabela não existia. Por isso, o Looker teve que recriar a TDP.
create begin Ocorre quando a linha de execução do regenerador escolhe o PDT. prod Indica que a PDT foi acionada por um gatilho de grupo de dados ou SQL (criado pelo gerador).
create begin Ocorre quando a linha de execução do regenerador escolhe o PDT. dev-user-x Indica que um novo PDT do modo de desenvolvimento foi criado.

Geralmente ocorre quando uma mudança é feita no SQL do PDT, depois que o PDT é consultado em uma Análise no modo de desenvolvimento. Isso resulta na criação de uma nova tabela para não afetar a tabela de produção.
create regen requires Geralmente, indica que um usuário fez uma consulta a um PDT que faz referência a outro PDT que ainda não foi criado, o que aciona uma recriação. null
create user rebuild Indica que um usuário recriou manualmente o TDP usando a opção Recriar e executar tabelas derivadas em uma Análise. null
create ready Quando o PDT começa a ser criado, a diferença entre o evento create ready e o evento create begin indica o tempo que as crianças levam para serem recriadas.

Se o evento create ready ocorrer logo após o evento create begin, provavelmente nenhuma tabela precisará ser recriada.
null
create complete Ocorre quando o PDT termina de ser criado. production trigger Indica que o PDT foi criado devido a uma verificação de gatilho (ou seja, o PDT foi criado pelo gerador).
create incremental complete Ocorre quando o build de PDT é concluído (para builds incrementais de PDT). increment generation Contém o número sequencial do incremento.
create incremental rows Mostra o número de linhas afetadas no último incremento. rows delta Contém um valor positivo para o número de linhas adicionadas e um valor negativo para o número de linhas removidas.
create sql error Indica que o build da TDP falhou com um erro SQL. sql error Contém a mensagem de erro SQL que foi retornada pelo banco de dados.

Recomendamos executar o SQL subjacente do PDT no SQL Runner para garantir que nenhuma nova edição tenha causado o erro.
create child error Ocorre quando há um erro ao criar a PDT dependente. sql error Contém a mensagem de erro SQL que foi retornada pelo banco de dados.
create cancelled error Indica que o build do PDT falhou devido a um cancelamento de consulta. query killed Indica que a consulta foi encerrada. Isso pode acontecer se um usuário cancelar uma consulta do Looker, se um usuário cancelar uma consulta do banco de dados ou se o tempo limite da consulta no banco de dados for atingido.
create trigger old value Indica o valor do acionador antigo na verificação. trigger value Retorna o valor retornado pelo gatilho antigo.
create trigger new value Indica o novo valor do acionador após a verificação. trigger value Retorna o valor retornado do novo acionador.
create trigger missing Ocorre na verificação de gatilho de um determinado PDT quando o PDT não existe mais ou foi descartado. null
create trigger datagroup Ocorre na verificação do acionador se a TDP foi acionada por um grupo de dados. null

Gerar eventos novamente

Ação de registro Descrição da ação de registro Registrar dados de ações Descrição dos dados da ação de registro
regenerate begin Indica que o regenerador está iniciando um processo, como verificar um acionador ou criar uma tabela.

Normalmente, quando um evento regenerate begin não tem um evento de término e um PDT não está sendo criado ou um acionador não está sendo verificado, essa ação de registro indica um gerador de regeneração pendente.
connection name Mostra o nome da conexão em que a linha de execução do gerador está em execução.
regenerate end Indica que o regenerador finalizou um processo, como a verificação de um acionador ou a recriação de um PDT, ou que ocorreu um erro. success Indica que o acionador foi verificado e o PDT foi recriado.
regenerate end Indica que o regenerador concluiu um processo, como a verificação de um acionador ou a recriação de um PDT, ou que ocorreu um erro. error_in_regen Indica que ocorreu um erro no ciclo de regeneração da tabela.
regenerate end Indica que o regenerador finalizou um processo, como a verificação de um acionador ou a recriação de um PDT, ou que ocorreu um erro. datagroup_error Indica que ocorreu um erro ao verificar o acionador do grupo de dados.
regenerate trace Indica o rastreamento de linha de execução do regenerador. hex id Representa a linha de execução Java que está executando o processo.

Soltar e publicar eventos de tarefas

Ação de registro Descrição da ação de registro Registrar dados de ações Descrição dos dados da ação de registro
drop table Indica que a tabela PDT ou temporária foi removida do banco de dados. unreferenced Indica que a tabela foi excluída porque o valor do acionador associado mudou.

Se outro método de persistência estiver sendo usado, indica que a tabela expirou.
drop table Indica que a tabela PDT ou temporária foi removida do banco de dados. zombie Indica que a chave de registro da tabela não faz parte dos conjuntos de chaves de registro ativos (em connection_reg3), então ela foi marcada como uma tabela zumbi para ser descartada.
drop table Indica que a tabela PDT ou temporária foi removida do banco de dados. pdt_build_failure_cleanup Quando um build falha ou é detectado como cancelado, o Looker descarta a tabela que pode ter sido criada parcialmente.
drop table failed Ocorre quando a tentativa de excluir a tabela temporária ou PDT falha. zombie Indica que a tentativa de excluir a tabela zumbi falhou.
drop table failed Ocorre quando a tentativa de excluir a tabela temporária ou PDT falha. unreferenced Indica que a tentativa de excluir a tabela sem referência falhou.
drop view Indica que a tabela publish_as_db_view foi excluída. expired Indica que a vida útil da tabela expirou e ela foi descartada.
drop view failed Indica que a tentativa de excluir a tabela publish_as_db_view falhou. zombie Indica que a tentativa de excluir a tabela zumbi publish_as_db_view falhou.
drop view failed Indica que a tentativa de excluir a tabela publish_as_db_view falhou. unreferenced Indica que a tentativa de excluir a tabela publish_as_db_view sem referência falhou.
publish task complete Indica que a visualização anterior foi descartada e a nova foi publicada. X concluído, X falhou Indica se a tarefa de publicação foi concluída ou não.

Eventos de acionamento de datagroup

Ação de registro Descrição da ação de registro Registrar dados de ações Descrição dos dados da ação de registro
datagroup_triggers begin Indica que os acionadores do grupo de dados começaram a verificar uma conexão.

Se houver uma grande lacuna entre a linha datagroup_triggers begin mais recente de uma conexão e não houver datagroup_triggers end, isso pode significar que o regenerador ficou preso ao verificar os acionadores.
connection name Mostra o nome da conexão que os acionadores estão verificando.
datagroup_triggers end Indica que os gatilhos do grupo de dados terminaram a verificação. null

Eventos de colheita

Ação de registro Descrição da ação de registro Registrar dados de ações Descrição dos dados da ação de registro
reap begin Indica que o reaper começou a verificar a conexão para saber quais tabelas derivadas não ativas ele precisa excluir do esquema de scratch. connection name Mostra o nome da conexão que o reaper está verificando.
reap end Indica que o coletor terminou o ciclo para a conexão. connection name Mostra o nome da conexão que o reaper verificou.

Acionar eventos

Ação de registro Descrição da ação de registro Registrar dados de ações Descrição dos dados da ação de registro
trigger value Indica o valor do acionador quando calculado. trigger value Mostra o valor real do acionador.
trigger value compute Indica o SQL usado para calcular o valor do acionador. trigger sql Mostra o SQL real usado para calcular o valor do acionador.
trigger value error Indica que houve um erro SQL ao calcular o valor do acionador ou ao executar o SQL do acionador. sql error Mostra o erro SQL do banco de dados que foi retornado para a consulta de gatilho.
trigger datagroup check Indica se o regenerador executou a consulta de acionador SQL no banco de dados. Um booleano (true ou false)
  • true: indica que a consulta de acionamento foi executada.
  • false: indica que a consulta do acionador SQL não foi executada.