ALTER DYNAMIC TABLE

Modifie les propriétés d’un tableau dynamique.

Voir aussi :

CREATE DYNAMIC TABLE, DESCRIBE DYNAMIC TABLE, DROP DYNAMIC TABLE, SHOW DYNAMIC TABLES

Dans ce chapitre :

Syntaxe

ALTER DYNAMIC TABLE <name> { SUSPEND | RESUME }

ALTER DYNAMIC TABLE <name> REFRESH

ALTER DYNAMIC TABLE <name> SET
  [ TARGET_LAG = { '<num> { seconds | minutes | hours | days }'  | DOWNSTREAM } ]
  [ WAREHOUSE = <warehouse_name> ]
Copy

Paramètres

name

Identifiant de la table à modifier. Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

SUSPEND | RESUME

Spécifie l’action à effectuer sur la table dynamique :

  • SUSPEND suspend l’actualisation de la table dynamique. Si la table dynamique est utilisée par d’autres tables dynamiques, celles-ci sont également suspendues.

  • RESUME reprend l’actualisation de la table dynamique. Les opérations de reprise se répercutent en aval sur toutes les tables dynamiques en aval qui n’ont pas été suspendues manuellement.

Reportez-vous à Notes sur l’utilisation pour obtenir des informations sur l’affichage de l’état des tables dynamiques.

REFRESH

Spécifie que la table dynamique doit être actualisée manuellement. Les tables dynamiques suspendues par l’utilisateur et celles suspendues automatiquement peuvent être actualisées manuellement. Les tables dynamiques actualisées manuellement affichent MANUAL comme activité d’actualisation.

Reportez-vous à Notes sur l’utilisation pour obtenir des informations sur l’affichage de l’état des tables dynamiques. Référez-vous à la colonne REFRESH_TRIGGER de DYNAMIC_TABLE_REFRESH_HISTORY pour obtenir des informations sur le statut d’actualisation de la table dynamique.

SET ...

Spécifie un(e) ou plusieurs paramètre(s)/propriété(s) à définir pour la table (séparés par des espaces, des virgules ou de nouvelles lignes) :

TARGET_LAG = { num { seconds | minutes | hours | days } | DOWNSTREAM }

Spécifie le décalage de la table dynamique :

'num seconds | minutes | hours | days'

Spécifie le délai maximum pendant lequel le contenu de la table dynamique doit être décalé par rapport aux mises à jour des tables de base.

Par exemple :

  • Si les données de la table dynamique ne doivent pas être décalées de plus de 5 minutes, indiquez 5 minutes.

  • Si les données de la table dynamique ne doivent pas être décalées de plus de 5 heures, indiquez 5 hours.

La valeur minimale est de 1 minute. Si la table dynamique A dépend d’une autre table dynamique B, le décalage minimum pour A doit être supérieur ou égal au décalage pour B.

DOWNSTREAM

Spécifie que la table dynamique doit être actualisée si un ancêtre en aval est actualisé.

WAREHOUSE = warehouse_name

Spécifie le nom de l’entrepôt qui fournit les ressources de calcul pour l’actualisation de la table dynamique.

Vous devez disposer du privilège USAGE sur cet entrepôt pour pouvoir créer la table dynamique.

Notes sur l’utilisation

  • Pour modifier une table dynamique, vous devez utiliser un rôle disposant du privilège OPERATE sur la table.

  • Vous ne pouvez pas modifier la politique de masquage après avoir créé un tableau dynamique.

  • Si vous souhaitez mettre à jour une table dynamique existant et que vous avez besoin de voir sa définition actuelle, appelez la fonction GET_DDL.

  • Reportez-vous à Statuts des tables dynamiques pour obtenir la liste des statuts des tables dynamiques.

  • Pour voir les informations de la table dynamique, vous pouvez soit :

    • Ouvrir Snowsight et sélectionner Monitoring » Dynamic Tables.

    • Appeler la fonction de table DYNAMIC_TABLE_GRAPH_HISTORY et examiner les résultats.

  • Concernant les métadonnées :

    Attention

    Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

Exemples

Modifiez le temps de latence d’une table dynamique nommée product sur 1 heure :

ALTER DYNAMIC TABLE product SET
  TARGET_LAG = '1 hour';
Copy