Поделиться через

ALTER MATERIALIZED VIEW

  • Статья

Область применения:флажок Databricks SQL

Изменяет метаданные, связанные с представлением.

Позволяет выполнить одно из следующих действий:

  • Добавьте расписание обновления существующего материализованного представления.
  • Измените существующее расписание обновления для материализованного представления.
  • Удалите расписание обновления для материализованного представления. Если расписание удалено, объект необходимо обновить вручную, чтобы отразить последние данные.

Чтобы добавить или изменить комментарий к представлению или его столбцам, используйте COMMENT ON.

Синтаксис

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

Параметры

  • SCHEDULE [ REFRESH ] schedule_clause

    Позволяет добавить расписание или изменить расписание материализованного представления.

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

      Чтобы запланировать периодические обновления, используйте синтаксис EVERY. Если указан синтаксис EVERY, то потоковая таблица или материализованное представление периодически обновляется с заданным интервалом на основе указанного значения, например HOUR, HOURS, DAY, DAYS, WEEKили WEEKS. В следующей таблице перечислены принятые целые значения для number.

      Time unit Целое значение
      HOUR or HOURS 1 <= H <= 72
      DAY or DAYS 1 <= D <= 31
      WEEK or WEEKS 1 <= W <= 8

      Примечание.

      Семантические и множественные формы включенной единицы времени семантики.

    • CRON cron_string [ AT TIME ZONE timezone_id ]

      Чтобы запланировать обновление с использованием значения quartz cron . Допустимые time_zone_values принимаются. Функция AT TIME ZONE LOCAL не поддерживается.

      Если AT TIME ZONE нет, используется часовой пояс сеанса. Если AT TIME ZONE отсутствует, а часовой пояс сеанса не задан, возникает ошибка. SCHEDULE семантически эквивалентен SCHEDULE REFRESH.

Примеры


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

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