Uso
view: my_view {
derived_table: {
sql_trigger_value: SELECT CURDATE() ;;
...
}
}
|
Hierarquia
sql_trigger_value |
Valor padrão
Nenhum
Aceita
Uma instrução SQL que resulta em uma linha e uma coluna
|
Definição
O sql_trigger_value permite acionar a regeneração de uma tabela derivada persistente com base em uma instrução SQL fornecida por você. Se o resultado da instrução SQL for diferente do valor anterior, a TDP será gerada novamente.
O parâmetro sql_trigger_value considera apenas a primeira linha e coluna no SQL que você escreve. Portanto, recomendamos que você escreva a consulta para retornar apenas um valor (uma linha e uma coluna). Isso evita confusões para futuros desenvolvedores e protege os dialetos SQL que não são de streaming contra o carregamento de grandes conjuntos de resultados na memória.
Por padrão, a cada cinco minutos, o Looker executa a consulta SQL que você escreveu, desde que outra tabela derivada persistente não esteja sendo criada. Se os resultados da consulta SQL mudarem, o Looker vai gerar a tabela derivada novamente. É possível mudar essa programação conforme necessário usando a configuração Programação de manutenção de TDP e datagroup nas configurações de administrador do Looker.
Por exemplo, suponha que você esteja executando o MySQL e use:
sql_trigger_value: SELECT CURDATE() ;;
Os resultados seriam assim:
| Tempo de execução de sql_trigger_value | Resultado de sql_trigger_value |
|---|---|
| 2015-01-01 00:00 | 2015-01-01 |
| 2015-01-01 00:05 | 2015-01-01 |
| 2015-01-01 00:10 | 2015-01-01 |
| … | … |
| 2015-01-01 23:55 | 2015-01-01 |
| 2015-01-02 00:00 | 2015-01-02 |
| 2015-01-02 00:05 | 2015-01-02 |
O valor dessa consulta SQL muda uma vez por dia à meia-noite, então a tabela derivada é gerada novamente nesses horários.
Se o administrador tiver concedido a você a permissão develop, será possível forçar a regeneração de uma tabela derivada antes que a consulta sql_trigger_value seja alterada. Selecione a opção Recriar tabelas derivadas e executar no menu de engrenagem Ações de análise depois de executar uma consulta.
Consulte a página de documentação Tabelas derivadas no Looker para mais detalhes sobre a opção Recriar tabelas derivadas e executar.
Exemplos
Crie uma TDP no MySQL que seja recriada uma vez por dia à meia-noite:
view: clean_events {
derived_table: {
sql:
SELECT *
FROM events
WHERE type NOT IN ('test', 'staff') ;;
sql_trigger_value: SELECT CURDATE() ;;
}
}
As seções a seguir mostram o SQL a ser usado para várias estratégias de recriação de TDP em diferentes dialetos:
Google BigQuery
| Programação de regeneração desejada | SQL para usar |
|---|---|
| Uma vez por dia, à meia-noite do horário do Pacífico | SELECT FORMAT_TIMESTAMP('%F', CURRENT_TIMESTAMP(), 'America/Los_Angeles') |
| Uma vez por dia em um horário específico | SELECT FLOOR(((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) - 60*60*3)/(60*60*24)) |
| Duas vezes por dia em horários específicos | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 4am and 6pm'
ELSE 'between 6pm and 4am'
END |
| Três vezes por dia em horários específicos | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 9
THEN 'between 4am and 9am'
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 9 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 9am and 6pm'
ELSE 'between 6pm and 4am'
END |
| A cada hora | SELECT EXTRACT(HOUR FROM CURRENT_TIMESTAMP()) |
| A cada 2 horas | SELECT FLOOR((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) / (2*60*60)) |
| Nunca atualizar dados | SELECT 1 |
MySQL
| Programação de regeneração desejada | SQL para usar |
|---|---|
| Uma vez por dia, à meia-noite | SELECT CURDATE() |
| Uma vez por dia em um horário específico do Tempo Universal Coordenado (UTC) | SELECT FLOOR((UNIX_TIMESTAMP(NOW()) - 60*60*3)/(60*60*24)) |
| Duas vezes por dia em horários específicos | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 4am and 6pm'
ELSE 'between 6pm and 4am'
END |
| Três vezes por dia em horários específicos | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 9
THEN 'between 4am and 9am'
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 9 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 9am and 6pm'
ELSE 'between 6pm and 4am'
END |
| Quando uma tabela específica é atualizada | SELECT COUNT(*) FROM table |
| A cada hora | SELECT HOUR(CURTIME()) |
| A cada 2 horas no Tempo Universal Coordenado (UTC) | SELECT FLOOR(UNIX_TIMESTAMP() / (2*60*60)) |
| Nunca atualizar dados | SELECT 1 |
Amazon Redshift
| Programação de regeneração desejada | SQL para usar |
|---|---|
| Uma vez por dia, à meia-noite | SELECT CURRENT_DATE |
| Uma vez por dia em um horário específico | SELECT FLOOR((EXTRACT(epoch from GETDATE()) - 60*60*3)/(60*60*24)) |
| Duas vezes por dia em horários específicos | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 4am and 6pm'
ELSE 'between 6pm and 4am'
END |
| Três vezes por dia em horários específicos | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 9
THEN 'between 4am and 9am'
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 9 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 9am and 6pm'
ELSE 'between 6pm and 4am'
END |
| Quando uma tabela específica é atualizada | SELECT COUNT(*) FROM table |
| A cada hora | SELECT DATE_PART('hour', GETDATE()) |
| A cada 2 horas | SELECT FLOOR(EXTRACT(epoch from GETDATE()) / (2*60*60)) |
| Nunca atualizar dados | SELECT 1 |
PostgreSQL
| Programação de regeneração desejada | SQL para usar |
|---|---|
| Uma vez por dia, à meia-noite | SELECT CURRENT_DATE |
| Uma vez por dia em um horário específico | SELECT FLOOR((EXTRACT(epoch from NOW()) - 60*60*3)/(60*60*24)) |
| Duas vezes por dia em horários específicos | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 4am and 6pm'
ELSE 'between 6pm and 4am'
END |
| Três vezes por dia em horários específicos | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 9
THEN 'between 4am and 9am'
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 9 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 9am and 6pm'
ELSE 'between 6pm and 4am'
END |
| Quando uma tabela específica é atualizada | SELECT COUNT(*) FROM table |
| A cada hora | SELECT DATE_PART('hour', NOW()) |
| A cada 2 horas | SELECT FLOOR(EXTRACT(epoch from NOW()) / (2*60*60)) |
| Nunca atualizar dados | SELECT 1 |
Snowflake
| Programação de regeneração desejada | SQL para usar |
|---|---|
| Uma vez por dia, à meia-noite | SELECT CURRENT_DATE() |
| Uma vez por dia em um horário específico do Tempo Universal Coordenado (UTC) | SELECT FLOOR((DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) - 60*60*3)/(60*60*24)) |
| Duas vezes por dia em horários específicos | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 4am and 6pm'
ELSE 'between 6pm and 4am'
END |
| Três vezes por dia em horários específicos | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 9
THEN 'between 4am and 9am'
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 9 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 9am and 6pm'
ELSE 'between 6pm and 4am'
END |
| Quando uma tabela específica é atualizada | SELECT COUNT(*) FROM table |
| A cada hora | SELECT HOUR(CURRENT_TIME()) |
| A cada 2 horas no Tempo Universal Coordenado (UTC) | SELECT FLOOR(DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) / (2*60*60)) |
| Nunca atualizar dados | SELECT 1 |
Desafios comuns
sql_trigger_value exige que você tenha configurado tabelas derivadas persistentes
O uso de sql_trigger_value vai causar erros de validação do LookML, a menos que você tenha ativado a persistência para tabelas derivadas nas configurações de conexão do banco de dados. A maioria dos clientes configura tabelas derivadas persistentes ao configurar inicialmente uma conexão de banco de dados. A exceção mais comum a essa regra é para clientes que conectam o Looker a um secundário de troca automática somente leitura do PostgreSQL.
O sql_trigger_value funciona de maneira diferente no Modo de Desenvolvimento e no Modo de Produção.
sql_trigger_value deve funcionar como esperado no Modo de Produção. No Modo de Desenvolvimento, todas as tabelas derivadas são tratadas como se persist_for: 24 hours tivesse sido usado, independentemente da configuração implementada. Para mais informações, consulte a seção Tabelas persistentes no Modo de Desenvolvimento da página de documentação Tabelas derivadas no Looker.