Partager via

ALTER MATERIALIZED VIEW

  • Article

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

Modifie les métadonnées associées à l’affichage.

Vous permet d’effectuer l’une des actions suivantes :

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

Syntaxe

ALTER MATERIALIZED VIEW view_name
  { schedule }

schedule
  {
    { 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 ] }

Paramètres

  • SCHEDULE [ REFRESH ] schedule_clause

    Vous permet d’ajouter une planification vers ou de modifier la planification d’une vue matérialisée.

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

      Important

      Cette fonctionnalité est disponible en préversion publique.

      Pour planifier une actualisation qui se produit régulièrement, utilisez EVERY la syntaxe. Si EVERY la syntaxe est spécifiée, la table de diffusion en continu ou la vue matérialisée est actualisée régulièrement à l’intervalle spécifié en fonction de la valeur fournie, telle que HOUR, , , HOURS, WEEKDAYDAYSou .WEEKS Le tableau suivant répertorie les valeurs entières acceptées 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 une actualisation à l’aide d’une valeur 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 défini, une erreur est générée. SCHEDULE est équivalent sémantiquement à SCHEDULE REFRESH.

Exemples


  -- Adds a schedule to refresh a materialized view once a day
  -- at midnight in Los Angeles
  > ALTER MATERIALIZED VIEW my_mv
      ADD SCHEDULE CRON '0 0 0 * * ? *' AT TIME ZONE 'America/Los_Angeles';

  -- Alters the schedule to run every 15 minutes for a materialized view
  > ALTER MATERIALIZED VIEW my_mv
      ALTER SCHEDULE CRON '0 0/15 * * * ? *';

  -- Drops the schedule for a materialized view
  > ALTER MATERIALIZED VIEW my_mv
      DROP SCHEDULE;