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 :

  • NONE (rétrocompatible)

  • CREATE_DYNAMIC_TABLE

  • ALTER_TARGET_LAG

  • SUSPEND

  • RESUME

  • REPLICATION_REFRESH

  • ALTER_WAREHOUSE

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