Tables dynamiques : modifications de la valeur de retour et ajout de nouvelles colonnes à DYNAMIC_TABLE_GRAPH_HISTORY, DYNAMIC_TABLE_REFRESH_HISTORY, et SHOW DYNAMIC TABLES (en attente)¶
Attention
Ce changement de comportement est présent dans le bundle 2024_02.
Pour connaître le statut actuel du bundle, reportez-vous à Historique du bundle.
Comportement de la valeur de retour¶
Le comportement des fonctions DYNAMIC_TABLE_GRAPH_HISTORY, DYNAMIC_TABLE_REFRESH_HISTORY, et SHOW DYNAMIC TABLES a changé comme suit : Les valeurs de retour de ces fonctions sont affichées comme suit.
Comportement de la valeur de retour pour la fonction DYNAMIC_TABLE_GRAPH_HISTORY¶
Lorsque ce bundle de changements de comportement est activé, la sortie de la fonction DYNAMIC_TABLE_GRAPH_HISTORY comprend les modifications suivantes de la valeur de retour :
- Avant la modification:
La colonne SCHEDULING_STATE renvoie
"state": "RUNNING"
ou"state": "SUSPENDED"
pour décrire le statut de la table dynamique.La colonne SCHEDULING_STATE renvoie RUNNING si une table en amont a été suspendue et que vous ne disposez pas du privilège MONITOR sur cette table en amont.
- Après la modification:
La colonne SCHEDULING_STATE renvoie
"state": "ACTIVE"
ou"state": "SUSPENDED"
pour décrire l’état de la table dynamique.La colonne SCHEDULING_STATE renvoie SUSPENDED, même si vous ne disposez pas du privilège MONITOR sur les tables en amont.
Comportement de la valeur de retour pour la fonction DYNAMIC_TABLE_REFRESH_HISTORY¶
Lorsque ce bundle de changements de comportement est activé, la sortie de la fonction DYNAMIC_TABLE_REFRESH_HISTORY comprend les modifications suivantes de la valeur de retour :
- Avant la modification:
La colonne LAST_COMPLETED_DEPENDENCY peut renvoyer à tort des valeurs NULL.
La colonne STATE renvoie SKIPPED pour les tâches d’actualisation qui ont été ignorées en raison d’une défaillance en amont.
L’historique des actualisations a été affiché pour tous les statuts des tables dynamiques.
- Après la modification:
La colonne LAST_COMPLETED_DEPENDENCY renvoie désormais des valeurs exactes.
La colonne STATE renvoie désormais UPSTREAM_FAILED pour les tâches d’actualisation qui sont ignorées en raison d’une défaillance en amont.
Les historiques d’actualisation ne sont plus affichés si la colonne STATE renvoie QUEUED ou SKIPPED. (Si l’actualisation de votre table dynamique a été ignorée en raison d’une défaillance en amont, la colonne STATE renvoie désormais UPSTREAM_FAILED).
Comportement de la valeur de retour pour la fonction SHOW DYNAMIC TABLE¶
Lorsque ce bundle de changements de comportement est activé, la sortie de la commande SHOW DYNAMIC TABLES inclut les changements de valeur de retour suivants :
- Avant la modification:
La colonne SCHEDULING_STATE renvoie RUNNING ou SUSPENDED pour décrire l’état de la table dynamique.
- Après la modification:
La colonne SCHEDULING_STATE renvoie ACTIVE ou SUSPENDED pour décrire l’état de la table dynamique.
Changements au niveau des colonnes¶
Lorsque cette option est activée, les colonnes suivantes sont ajoutées aux fonctions DYNAMIC_TABLE_GRAPH_HISTORY et DYNAMIC_TABLE_REFRESH_HISTORY.
Fonction DYNAMIC_TABLE_GRAPH_HISTORY : nouvelle colonne dans la sortie¶
Lorsque le bundle de changements de comportement est activé, la sortie de la fonction DYNAMIC_TABLE_GRAPH_HISTORY comprend la ou les nouvelles colonnes suivantes :
Nom de la colonne |
Type de données |
Description |
---|---|---|
ALTER_TRIGGER |
ARRAY |
Décrit pourquoi une nouvelle entrée est créée dans la fonction DYNAMIC_TABLE_GRAPH_HISTORY. Elle peut être sous la forme suivante :
|
Fonction DYNAMIC_TABLE_REFRESH_HISTORY : nouvelle colonne dans la sortie¶
Lorsque le bundle de changements de comportement est activé, la sortie de la fonction DYNAMIC_TABLE_REFRESH_HISTORY comprend la ou les nouvelles colonnes suivantes :
Nom de la colonne |
Type de données |
Description |
---|---|---|
TARGET_LAG |
TEXT |
Cette colonne décrit la valeur TARGET_LAG de la table dynamique au moment de l’actualisation. |
GRAPH_HISTORY_VALID_FROM |
TIMESTAMP_NTZ |
Encode l’horodatage VALID_FROM de la fonction de table DYNAMIC_TABLE_GRAPH_HISTORY au moment de l’actualisation. |
Réf : 1543