ALTER STREAMING TABLE

  • Article

S’applique à :coche marquée oui Databricks SQL

Important

Cette fonctionnalité est disponible en préversion publique. Pour vous inscrire et y accéder, remplissez ce formulaire.

Vous permet soit de :

  • Ajoutez une planification pour actualiser une vue matérialisée ou une table de streaming existante.
  • Modifiez une planification d'actualisation existante pour une vue matérialisée ou une table de streaming.
  • Supprimez la planification d’actualisation pour une vue matérialisée ou une table de streaming. Si la planification est supprimée, l'objet doit être actualisé manuellement pour refléter les dernières données.

Syntaxe

ALTER STREAMING TABLE table_name
  {
    { ADD | ALTER } SCHEDULE [ REFRESH ]
      CRON cron_string [ AT TIME ZONE timezone_id ] |
    DROP SCHEDULE
  }

Paramètres

  • table_name

    Le nom de la table de streaming dont vous souhaitez modifier la définition. Le nom ne doit pas inclure une spécification temporelle.

  • SCHEDULE [ REFRESH ] CRON cron_string [ AT TIME ZONE timezone_id ]

    Le cas échéant, planifie la table de streaming ou la vue matérialisée pour actualiser ses données avec la planification cron quartz donnée. Seules les time_zone_values sont acceptées. La fonction AT TIME ZONE LOCAL n'est pas prise en charge. Si AT TIME ZONE est absent, le fuseau horaire de session est utilisé. Si AT TIME ZONE est absent et que le fuseau horaire de session n’est pas défini, une erreur est générée. SCHEDULE est équivalent sémantiquement à SCHEDULE REFRESH.

    Vous ne pouvez pas utiliser la syntaxe SCHEDULE dans une définition de pipeline Delta Live Tables.

Exemples

-- Adds a schedule to refresh the streaming table once a day
-- at midnight in Los Angeles
> ALTER STREAMING TABLE my_st
  ADD SCHEDULE CRON '0 0 0 * * ? *' AT TIME ZONE 'America/Los_Angeles';

-- Alters the schedule to run every 15 minutes for a streaming table
> ALTER STREAMING TABLE my_st
  ALTER SCHEDULE CRON '0 0/15 * * * ? *';

-- Drops the schedule for a streaming table
> ALTER STREAMING TABLE my_st
  DROP SCHEDULE;