Esta página foi traduzida pela API Cloud Translation.

Configurações de administrador: tabelas derivadas persistentes
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

A página de administrador Tabelas derivadas permanentes do Looker mostra o status das tabelas mantidas da instância do Looker, que incluem tabelas derivadas persistentes e tabelas de agregação.

A página de administrador Tabelas derivadas persistentes exibe vários recursos de administração que podem ajudar a rastrear e solucionar problemas de comportamento persistente da tabela. Consulte a página de documentação Tabelas derivadas no Looker para saber como solucionar problemas com tabelas persistentes.

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

Para abrir a página Persistent Derived Tables, siga estas etapas:

Clique no ícone do Menu principal e selecione Administrador se o menu Administrador ainda não estiver aparecendo. Se você estiver na seção Análise ou Desenvolver do menu principal do Looker, talvez seja necessário clicar na seta "Voltar" para abrir o menu Administrador.
No menu Administrador, selecione Tabelas derivadas persistentes.

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

A tabela persistente é 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 tabela persistente faz parte de um modelo configurado corretamente.
A tabela mantida 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 Análise do log de eventos de TDP nesta página.

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 alterar os dados mostrados na tabela:

Para ver as tabelas mantidas somente 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 estão ativadas para PDTs e às quais você tem acesso a dados.
Digite palavras-chave na caixa de pesquisa para restringir a lista de tabelas persistentes às tabelas persistentes com nomes que incluem a palavra-chave. A tabela vai mostrar as tabelas mantidas com o termo de pesquisa correspondente em negrito. Clique no X na barra de pesquisa para limpar os termos da consulta.
Clique no ícone Filtros para definir um filtro para a tabela.
Clique no ícone "Fechar/Abrir" para mostrar ou ocultar a seção Resumo.
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.
Clique no ícone Selecione as colunas a serem exibidas para ocultar ou mostrar colunas na tabela.
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

Você pode usar o ícone Filtros ao lado da barra de pesquisa para escolher quais tabelas mantidas são mostradas na página Tabelas derivadas persistentes. Por exemplo, filtre por Status do último build para ver apenas as tabelas persistentes que apresentam um erro de build ou filtre por Modelo para limitar as tabelas exibidas para um modelo específico.

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

Clique no ícone Filtros .
Selecione uma opção de filtro no primeiro seletor no menu de filtro. As seguintes opções estão disponíveis:
- Não acionadas 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.
- Acionadas nos últimos: filtra a página Tabelas derivadas persistentes por tabelas persistentes que foram acionadas em um número especificado de horas e minutos.
- Modelo: filtra a página Tabelas derivadas persistentes (em inglês) para tabelas mantidas que estão incluídas em um modelo especificado.
- Regra de persistência: filtra a página Persistent Derived Tables 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 exibição estável: um booleano que filtra a página Tabelas derivadas persistentes para tabelas persistentes e exibe Sim para tabelas persistentes que foram publicadas como uma exibição estável e Não para tabelas persistentes que não foram publicadas como uma exibição estável, conforme determinado pelo valor do parâmetro publish_as_db_view.
- Duração da última versão além de: filtra a página Tabelas derivadas persistentes por tabelas persistentes com builds que levaram mais do que um número especificado de segundos.
- Project: filtra a página Persistent Derived Tables por tabelas mantidas do projeto do LookML especificado.
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.
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.
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.

Compreendendo a página Tabelas derivadas persistentes

As seções a seguir descrevem as informações da 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 mantidas em produção. Estas são as tabelas mantidas que foram implantadas para produção na 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 tabelas de produção persistentes.
A guia Desenvolvimento mostra as tabelas de desenvolvimento permanente. As tabelas de desenvolvimento persistentes 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 alterações que afetam os dados na tabela persistente ou a maneira como a tabela persistente é consultada. Essas mudanças fazem com que o Looker crie a tabela de desenvolvimento permanente, mas não cria a tabela persistente, a menos que ela seja consultada após as alterações. A guia Desenvolvimento pode ajudar a determinar quais tabelas de desenvolvimento persistentes o Looker criou e se elas foram criadas.

Consulte a página de documentação Tabelas derivadas no Looker para mais informações sobre quais solicitações do Looker criam tabelas de desenvolvimento persistentes e por quanto tempo essas tabelas são mantidas no seu banco de dados.

Seção Resumo

A seção Resumo mostra um resumo visual do status das tabelas mantidas que são exibidas nessa tabela. 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 persistente.

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

A coluna Nome da TDP exibe essas informações adicionais sob o nome da tabela mantida, quando aplicável:

Build antigo indica que a linha está exibindo informações sobre uma compilação de tabela antiga persistente. Veja mais informações sobre a mensagem na caixa de diálogo Detalhes da TDP no menu Opções.
Incremental indica que a tabela mantida é uma PDT incremental.
Visualização materializada indica que a tabela mantida é 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 tabela persistente listada:

Gerar novamente 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.
Sucesso indica que uma tabela persistente foi criada.
Building indica que uma tabela persistente está sendo criada e não pode ser consultada até que o build seja concluído.
Não construído indica que uma tabela persistente não foi criada.
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 tabela persistente se tiver as permissões apropriadas para ver o LookML. Consulte a seção menu Opções nesta página para saber mais sobre como solucionar problemas de tabelas persistentes na página Tabelas derivadas persistentes.

Última tentativa em

A coluna Last Attempted At indica a hora da última tentativa de build persistente da tabela.

Último build bem-sucedido

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

Duração do último build

A coluna Duração da última versão exibe, em segundos, o tempo necessário para criar o build mais recente dessa tabela persistente em segundos e quanto tempo leva para criar essa tabela, em média.

Regra de persistência

A coluna Regra de persistência exibe o tipo de persistência aplicado a uma tabela persistente, conforme especificado na definição do LookML dela. Ele também indica a última vez que uma tabela persistente criada com sucesso foi verificada (para tabelas com persistência de tipo de gatilho) ou quando uma tabela persistente criada com sucesso está prestes a expirar (para tabelas de tipo persistido). Há dois tipos de persistência exibidos na coluna Regra de persistência:

Persistir por: (tempo) é exibido para tabelas persistentes que são mantidas com o parâmetro persist_for.
Gatilho: (nome do grupo de dados) é exibido para tabelas 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.
Gatilho: SQL é exibido para tabelas persistentes 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 LookML em que a tabela mantida está definida.

Conexão

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

Modelo

A coluna Modelo exibe o nome do arquivo de modelo associado à tabela mantida. Em uma TDP, geralmente é o arquivo do modelo que inclui o arquivo de visualização em que a TDP está definida. Em uma tabela de agregação, geralmente é o arquivo de modelo em que a tabela de agregação é definida.

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, verifique 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 tabela mantida é definida caso você tenha 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 tabela persistente selecionada nas últimas quatro semanas.
Detalhes da TDP: abre uma caixa de diálogo com mais informações e estatísticas de uma tabela específica persistente. 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 tabela mantida para ver o modal de detalhes da TDP.

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

Nome da tabela: o hash da tabela persistente mais recente criada com sucesso.
Modelo: o nome do arquivo de modelo em que o arquivo de visualização da tabela é incluído.
Nome estável: o nome da visualização estável do banco de dados da tabela mantida no banco de dados, caso ela tenha sido publicada como uma visualização estável. É possível publicar uma tabela persistente como uma visualização estável no seu banco de dados adicionando a instrução publish_as_db_view: yes à PDT ou tabela agregada 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 tabela mantida está ativada.
Build antigo: um booleano que exibe Yes se um build for de tabela antiga persistente ou No se não for.
- Tipo de tabela: para versões antigas, 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 tabela persistente é 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 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 esta tabela persistente depende. Cada nó do 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 tabela persistente que foi criada com sucesso.
- 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.
Último build:
- Build bem-sucedido mais recente: a data e a hora do build mais recente e bem-sucedido da tabela.
- Duração do build mais recente: quanto tempo levou o build da tabela persistente mais recente (em segundos; mostra – se a tabela ainda não foi criada).
- Duração média do build: quanto tempo leva, em média, para criar a tabela persistente (em segundos; exibe – se a tabela ainda não foi criada).
- Motivo da criação: o motivo pelo qual uma tabela persistente foi criada (incepção para uma compilação inicial, datagroup acionado se a tabela persistida for mantida com um grupo de dados, acionar mudança de valor se o valor do gatilho SQL da tabela persistente tiver mudado).
- Increment Key: o parâmetro increment_key para tabelas persistentes que usam builds incrementais.
- Deslocamento de incremento: o parâmetro increment_offset para tabelas persistentes 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.
- Persist for: para as tabelas com tipo Persist, o valor da duração da persistência. Não aplicável a tabelas persistentes do tipo Gatilho.
- Datagroup: para tabelas persistentes do acionador de datagroup, fornece o nome do grupo de dados.
- Bloco de código SQL: para tabelas persistentes do grupo de dados e do gatilho SQL, 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 de dados. Para gatilhos SQL, é o SQL do parâmetro sql_trigger_value.
- Valor do gatilho: para tabelas persistentes do tipo Gatilho, o valor que acionou a criação da tabela persistente (exibe – para tabelas persistentes criadas com sucesso que são persistidas com um datagroup_trigger; para ver o valor do gatilho mais recente para um grupo de dados, consulte a página Grupos de dados no painel Administrador).
- Última verificação: para tabelas do tipo Gatilho persistido, quando o valor do acionador foi verificado pela última vez.
- Expira: quando a tabela persistente expira, se aplicável (não aplicável a acionadores de datagroup).

Painel de atividades de TDP

O painel Atividade de TDP mostra informações sobre a tabela persistente, 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 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 tabela persistente que inclui o nome do modelo LookML e a visualização que define a tabela persistente, o nome da conexão com o banco de dados que a tabela persistente usa, o número total de tentativas de build bem-sucedidas e com falha da tabela mantida e a porcentagem do total de tentativas de build com falha.
A data e a hora da recriação completa mais recente da tabela mantida.
Se a tabela mantida for uma TDP incremental, a data e a hora da recriação incremental mais recente da TDP.
Se a tabela persistente for uma PDT incremental, é o número de recriações incrementais que ocorreram desde a recriação completa mais recente.
O tempo médio necessário para recriar a tabela mantida.
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 recompilações persistentes 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 incrementais, o gatilho que causou cada recompilação e o número de compilações da tabela persistente.
Uma lista de todas as tentativas de recompilação com falha, incluindo a data e a hora em que a recompilação com falha 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 acionadores de recriação da tabela, 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 tabela mantidos, 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 tempo de execução médio para cada origem da consulta.
O número total de consultas executadas na tabela mantida.
Uma lista de todos os campos da tabela 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.

Explorar log de eventos de TDP

O Looker inclui um modelo pré-criado chamado system_activity que permite analisar o log de eventos de TDP, 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 tabelas persistentes.

Você pode acessar o modelo com os links Eventos de compilação 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 no painel Administrador do Looker.

Para acessar a Análise do log de eventos de PDT na página Conexões, selecione a opção Mostrar log de eventos de PDT 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 PDT é filtrada por uma tabela persistente específica.

Este é um guia rápido sobre os 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 prazo de validade de uma tabela persistente, a causa de uma recriação e o texto de uma mensagem de erro. 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 gravado para criá-la.
ID	O ID exclusivo da instância do Looker que gerou a tabela mantida. 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 compilação da tabela mantida.
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 tabela mantida, 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.