ONLINE_FEATURE_TABLE_REFRESH_HISTORY¶

Esta função de tabela retorna informações sobre cada atualização (concluída e em execução) das tabelas de recursos online.

Esta função de tabela retorna todas as atualizações que estão em andamento, bem como todas as atualizações que têm uma REFRESH_START_TIME dentro de 7 dias a partir da hora atual.

Consulte também:: CREATE ONLINE FEATURE TABLE , ALTER ONLINE FEATURE TABLE, DESCRIBE ONLINE FEATURE TABLE , DROP ONLINE FEATURE TABLE , SHOW ONLINE FEATURE TABLES

Sintaxe¶

ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  [ REFRESH_START_TIMESTAMP => <constant_expr> ]
  [ , REFRESH_END_TIMESTAMP => <constant_expr> ]
  [ , RESULT_LIMIT => <integer> ]
  [ , NAME => '<string>' ]
  [ , NAME_PREFIX => '<string>' ]
  [ , ERROR_ONLY => { TRUE | FALSE } ]
)

Copy

Argumentos¶

Todos os argumentos são opcionais. Se nenhum argumento for fornecido, serão retornadas 100 atualizações de todas as tabelas de recursos online na conta.

REFRESH_START_TIMESTAMP => constant_expr, REFRESH_END_TIMESTAMP => constant_expr

Intervalo de tempo (no formato TIMESTAMP_LTZ) em que as atualizações foram iniciadas. Se uma versão final não for especificada, CURRENT_TIMESTAMP será usada como o fim do intervalo.

RESULT_LIMIT => integer

Um número especificando o número máximo de linhas retornadas pela função. Se o número de linhas correspondentes for maior que este limite, as atualizações que foram concluídas mais recente (ou aquelas que ainda estão em execução) são retornadas até o limite especificado.

Faixa: 1 a 10000

Padrão: 100.

NAME => 'string'

O nome de uma tabela de recursos online.

Você pode especificar o nome não qualificado (online_feature_table_name), o nome parcialmente qualificado (schema_name.online_feature_table_name) ou o nome totalmente qualificado (database_name.schema_name.online_feature_table_name).

Para obter mais informações sobre a resolução de nomes de objetos, consulte Resolução de nome de objeto.

A função retorna as atualizações para esta tabela.

NAME_PREFIX => 'string'

Um prefixo para tabelas de recursos online.

A função retorna atualizações para tabelas com nomes que começam com esse prefixo.

Você pode usar esse argumento para retornar as atualizações das tabelas de recursos online em um banco de dados ou esquema específico.

ERROR_ONLY => { TRUE | FALSE }

Quando definida como TRUE, esta função retorna apenas atualizações que falharam ou foram canceladas.

Padrão: FALSE

Saída¶

A saída do comando inclui as seguintes colunas, que descrevem as propriedades e metadados do objeto:

Coluna	Tipo de dados	Descrição
`NAME`	TEXT	Nome da tabela de recursos online.
`SCHEMA_NAME`	TEXT	Nome do esquema com a tabela de recursos online.
`DATABASE_NAME`	TEXT	Nome do banco de dados com a tabela de recursos online.
`QUALIFIED_NAME`	TEXT	Nome totalmente qualificado da tabela de recursos online.
`STATE`	TEXT	Status da atualização da tabela de recursos online. O status pode ser uma das seguintes opções: `EXECUTING`: atualização em andamento. `SUCCEEDED`: atualização concluída com sucesso. `FAILED`: atualização com falha durante a execução. `CANCELLED`: atualização cancelada antes da conclusão.
`REFRESH_START_TIME`	TIMESTAMP_LTZ	Hora em que o trabalho de atualização foi iniciado.
`REFRESH_END_TIME`	TIMESTAMP_LTZ	Hora em que a atualização foi concluída.
`REFRESH_TRIGGER`	TEXT	Uma das opções: `SCHEDULED`: atualização normal em segundo plano para atingir a meta de atraso. `MANUAL`: usuário/tarefa que executou o comando `ALTER ONLINE FEATURE TABLE <name> REFRESH`. `CREATION`: atualização realizada durante a instrução de DDL de criação, acionada pela criação da tabela de recursos online.
`REFRESH_ACTION`	TEXT	Uma das opções: `NO_DATA`: não há novos dados nas tabelas base. Não se aplica à atualização inicial de tabelas de recursos online recém-criadas, sem considerar se as tabelas base têm ou não dados. `REINITIALIZE`: tabela base alterada. `FULL`: atualização completa, porque o modo de atualização da tabela de recursos online foi definido como FULL. `INCREMENTAL`: atualização incremental normal.
`QUERY_ID`	TEXT	ID da instrução SQL que produziu os resultados para a tabela de recursos online.
`STATE_CODE`	TEXT	Código que representa o estado atual da atualização.
`STATE_MESSAGE`	TEXT	Descrição do estado atual da atualização.

Requisitos de controle de acesso¶

Privilégio	Objeto	Notas
MONITOR	Tabela de recursos online	Função que tem o privilégio MONITOR na tabela de recursos online.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso¶

Essa função está disponível em INFORMATION_SCHEMA.
As informações retornadas por essa função são atualizadas. O histórico de atualização da tabela de recursos online na exibição ACCOUNT_USAGE.ONLINE_FEATURE_TABLE_REFRESH_HISTORY pode apresentar um atraso de até 3 horas.

Exemplos¶

O exemplo a seguir retorna o histórico de atualização de todas as tabelas de recursos online na conta:

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY());

Copy

O exemplo a seguir retorna o histórico de atualização de uma tabela de recursos online específica chamada my_feature_table:

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  NAME => 'my_feature_table'
));

Copy

O exemplo a seguir retorna apenas atualizações com falha nas últimas 24 horas:

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  REFRESH_START_TIMESTAMP => CURRENT_TIMESTAMP - INTERVAL '1 DAY',
  ERROR_ONLY => TRUE
));

Copy

O exemplo a seguir retorna atualizações das tabelas de recursos online com nomes que começam com feature_ e limita os resultados a 50 linhas:

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  NAME_PREFIX => 'feature_',
  RESULT_LIMIT => 50
));

Copy