Condividi tramite


ALTER MATERIALIZED VIEW

Si applica a:segno di spunta sì Databricks SQL

Modifica i metadati associati alla vista.

Consente di eseguire una delle azioni seguenti:

  • Aggiungere una pianificazione per aggiornare una vista materializzata esistente.
  • Modificare una pianificazione refresh esistente per una vista materializzata.
  • Eliminare la pianificazione refresh per una vista materializzata. Se la pianificazione viene eliminata, l'oggetto deve essere aggiornato manualmente per riflettere i dati più recenti.

Per aggiungere o modificare un commento su una visualizzazione o sulla relativa columns, usare COMMENT ON.

Sintassi

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

Parameters

  • SCHEDULE [ REFRESH ] clausola_di_programma

    Consente di aggiungere o modificare la pianificazione di una vista materializzata.

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

      Importante

      Questa funzionalità è disponibile in anteprima pubblica.

      Per pianificare un refresh che si verifica periodicamente, utilizzare la sintassi EVERY. Se la sintassi EVERY è specificata, il flusso table o la vista materializzata viene aggiornata periodicamente all'intervallo specificato in base al valore fornito, come HOUR, HOURS, DAY, DAYS, WEEKo WEEKS. Nell'table seguente sono elencati i values integer accettati per number.

      Time unit Valore intero
      HOUR or HOURS 1 <= H <= 72
      DAY or DAYS 1 <= D <= 31
      WEEK or WEEKS 1 <= W <= 8

      Nota

      Le forme singolari e plurali dell'unità temporale inclusa sono semanticamente equivalenti.

    • CRON cron_string [ AT TIME ZONE timezone_id ]

      Per pianificare un refresh utilizzando un cron valore. Vengono accettati time_zone_values validi. AT TIME ZONE LOCAL non è supportata.

      Se AT TIME ZONE è assente, viene usato il fuso orario della sessione. Se AT TIME ZONE è assente e il fuso orario della sessione non è set, viene generato un errore. SCHEDULE è semanticamente equivalente a SCHEDULE REFRESH.

Esempi


  -- 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;