ONLINE_FEATURE_TABLE_REFRESH_HISTORY¶

Cette fonction de table renvoie des informations sur chaque actualisation (terminée et en cours) des tables de fonctionnalités en ligne.

Cette fonction de table renvoie toutes les actualisations en cours ainsi que toutes les actualisations pour lesquelles REFRESH_START_TIME se situe dans un délai de 7 jours par rapport à l’heure actuelle.

Voir aussi :: CREATE ONLINE FEATURE TABLE , ALTER ONLINE FEATURE TABLE, DESCRIBE ONLINE FEATURE TABLE , DROP ONLINE FEATURE TABLE , SHOW ONLINE FEATURE TABLES

Syntaxe¶

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

Arguments¶

Tous les arguments sont facultatifs. Si aucun argument n’est fourni, alors 100 actualisations de toutes les tables de fonctionnalités en ligne du compte seront renvoyées.

REFRESH_START_TIMESTAMP => constant_expr , REFRESH_END_TIMESTAMP => constant_expr

Intervalle de temps (au format TIMESTAMP_LTZ) pendant lequel les actualisations ont commencé. Si aucune version de fin n’est spécifiée, CURRENT_TIMESTAMP est utilisée comme fin de plage.

RESULT_LIMIT => integer

Un nombre spécifiant le nombre maximum de lignes renvoyé par la fonction. Si le nombre de lignes correspondantes est supérieur à cette limite, les actualisations avec l’heure de fin la plus récente (ou celles qui sont toujours en cours d’exécution) sont renvoyées, jusqu’à la limite spécifiée.

Plage : 1 à 10000

Par défaut : 100.

NAME => 'string'

Le nom d’une table de fonctionnalités en ligne.

Vous pouvez spécifier le nom incomplet (online_feature_table_name), le nom partiellement complet (schema_name.online_feature_table_name) ou le nom complet (database_name.schema_name.online_feature_table_name).

Pour plus d’informations sur la résolution des noms d’objets, voir Résolution de nom d’objet.

La fonction renvoie les actualisations pour cette table.

NAME_PREFIX => 'string'

Préfixe pour les tables de fonctionnalités en ligne.

La fonction renvoie des actualisations pour les tables dont le nom commence par ce préfixe.

Vous pouvez utiliser cet argument pour renvoyer les actualisations des tables de fonctionnalités en ligne d’une base de données ou d’un schéma spécifique.

ERROR_ONLY => { TRUE | FALSE }

Lorsqu’elle est définie sur TRUE, cette fonction renvoie uniquement les actualisations qui ont échoué ou qui ont été annulées.

Par défaut : FALSE

Sortie¶

La sortie de la commande comprend les colonnes suivantes, qui décrivent les propriétés et les métadonnées de l’objet :

Colonne	Type de données	Description
`NAME`	TEXT	Nom de la table des fonctionnalités en ligne.
`SCHEMA_NAME`	TEXT	Nom du schéma contenant la table des fonctionnalités en ligne.
`DATABASE_NAME`	TEXT	Nom de la base de données contenant la table des fonctionnalités en ligne.
`QUALIFIED_NAME`	TEXT	Nom complet de la table des fonctionnalités en ligne.
`STATE`	TEXT	Statut de l’actualisation de la table des fonctionnalités en ligne. Le statut peut être sous la forme suivante : `EXECUTING` : actualisation en cours. `SUCCEEDED` : actualisation exécutée avec succès. `FAILED` : échec de l’actualisation lors de l’exécution. `CANCELLED` : actualisation annulée avant la fin.
`REFRESH_START_TIME`	TIMESTAMP_LTZ	Heure à laquelle la tâche d’actualisation a commencé.
`REFRESH_END_TIME`	TIMESTAMP_LTZ	Heure à laquelle l’actualisation s’est achevée.
`REFRESH_TRIGGER`	TEXT	Une des options : `SCHEDULED` : actualisation normale de l’arrière-plan pour atteindre la latence cible. `MANUAL`: utilisateur/tâche a exécuté la commande `ALTER ONLINE FEATURE TABLE <name> REFRESH`. `CREATION` : actualisation effectuée lors de la création de l’instruction DDL, déclenchée par la création de la table des fonctionnalités en ligne.
`REFRESH_ACTION`	TEXT	Une des options : `NO_DATA` - pas de nouvelles données dans les tables de base. Ne s’applique pas à l’actualisation initiale des tables de fonctionnalités en ligne venant d’être créées, que les tables de base contiennent ou non des données. `REINITIALIZE` : table de base modifiée. `FULL` : Actualisation complète, car le mode d’actualisation de la table des fonctionnalités en ligne est défini sur FULL. `INCREMENTAL` : actualisation incrémentielle normale.
`QUERY_ID`	TEXT	ID de l’instruction SQL qui a produit les résultats pour la table des fonctionnalités en ligne.
`STATE_CODE`	TEXT	Code représentant l’état actuel de l’actualisation.
`STATE_MESSAGE`	TEXT	Description de l’état actuel de l’actualisation.

Exigences en matière de contrôle d’accès¶

Privilège	Objet	Remarques
MONITOR	Table des fonctionnalités en ligne	Rôle qui a le privilège MONITOR sur la table des fonctionnalités en ligne.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

Cette fonction est disponible dans le INFORMATION_SCHEMA.
Les informations renvoyées par cette fonction sont à jour. L’historique d’actualisation de la table des fonctionnalités en ligne dans la vue ACCOUNT_USAGE.ONLINE_FEATURE_TABLE_REFRESH_HISTORY peut être décalé jusqu’à 3 heures.

Exemples¶

L’exemple suivant renvoie l’historique d’actualisation pour toutes les tables de fonctionnalités en ligne du compte :

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

Copy

L’exemple suivant renvoie l’historique d’actualisation d’une table de fonctionnalités en ligne spécifique nommée my_feature_table :

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

Copy

L’exemple suivant renvoie uniquement les actualisations ayant échoué au cours des dernières 24 heures :

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

Copy

L’exemple suivant renvoie des actualisations pour les tables de fonctionnalités en ligne dont les noms commencent par feature_ et limite les résultats à 50 lignes :

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

Copy