Partager via


ALTER STREAMING TABLE

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

Vous permet soit de :

  • Ajoutez une planification pour actualiser une tablede diffusion en continu existante.
  • Modifiez un programme refresh existant pour une tablede diffusion en continu.
  • Supprimez la planification refresh pour une diffusion en continu table. Si la planification est supprimée, l'objet doit être actualisé manuellement pour refléter les dernières données.

Pour ajouter ou modifier un commentaire sur un table ou son columns, utilisez COMMENT ON.

Syntaxe

ALTER STREAMING TABLE table_name
  {
    { ADD | ALTER } SCHEDULE [ REFRESH ] schedule_clause |
    DROP SCHEDULE
  }

  schedule_clause
  { EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } |
    CRON cron_string [ AT TIME ZONE timezone_id ] }

Parameters

  • table_name

    Nom de la table de diffusion en continu pour modifier la définition de. Le nom ne doit pas inclure une spécification temporelle.

  • SCHEDULE [ REFRESH ] schedule_clause

    Permet d'ajouter ou de modifier l'horaire d'une diffusion en continu table.

    • EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS }

      Pour planifier une refresh qui se produit régulièrement, utilisez la syntaxe EVERY. Si la syntaxe EVERY est spécifiée, la diffusion en continu table ou la vue matérialisée est actualisée à intervalles réguliers spécifiés en fonction de la valeur fournie, telle que HOUR, HOURS, DAY, DAYS, WEEKou WEEKS. Les table suivants répertorient les entiers values acceptés pour number.

      Unité de temps Valeur entière
      HOUR or HOURS 1 <= H <= 72
      DAY or DAYS 1 <= D <= 31
      WEEK or WEEKS 1 <= W <= 8

      Remarque

      Les formes singulières et plurielles de l’unité de temps incluse sont sémantiquement équivalentes.

    • CRON cron_string [ AT TIME ZONE timezone_id ]

      Pour planifier un refresh à l’aide d’une valeur de cron de quartz. Les time_zone_values valides 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 set, une erreur est levée. SCHEDULE est équivalent sémantiquement à SCHEDULE REFRESH.

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 EVERY 15 MINUTES;

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