sql_trigger_value

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))

Substitua o "3" pela hora do dia em que você quer que a regeneração ocorra
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

Substitua 4 e 18 pelas horas do dia em que você quer que a regeneração ocorra
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

Substitua 4, 9 e 18 pelas horas do dia em que você quer que a regeneração ocorra
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))

Você pode substituir o "2" pelo número de horas que quer entre cada regeneração
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))

Substitua o "3" pela hora do dia em que você quer que a regeneração ocorra
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

Substitua 4 e 18 pelas horas do dia em que você quer que a regeneração ocorra
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

Substitua 4, 9 e 18 pelas horas do dia em que você quer que a regeneração ocorra
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))

Você pode substituir o "2" pelo número de horas que quer entre cada regeneração
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))

Substitua o "3" pela hora do dia em que você quer que a regeneração ocorra
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

Substitua 4 e 18 pelas horas do dia em que você quer que a regeneração ocorra
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

Substitua 4, 9 e 18 pelas horas do dia em que você quer que a regeneração ocorra
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))

Você pode substituir o "2" pelo número de horas que quer entre cada regeneração
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))

Substitua o "3" pela hora do dia em que você quer que a regeneração ocorra
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

Substitua 4 e 18 pelas horas do dia em que você quer que a regeneração ocorra
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

Substitua 4, 9 e 18 pelas horas do dia em que você quer que a regeneração ocorra
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))

Você pode substituir o "2" pelo número de horas que quer entre cada regeneração
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))

Substitua o "3" pela hora do dia em que você quer que a regeneração ocorra
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

Substitua 4 e 18 pelas horas do dia em que você quer que a regeneração ocorra
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

Substitua 4, 9 e 18 pelas horas do dia em que você quer que a regeneração ocorra
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))

Você pode substituir o "2" pelo número de horas que quer entre cada regeneração
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.