Freigeben über

ALTER MATERIALIZED VIEW

  • Artikel

Gilt für:mit Häkchen bei Ja versehen Databricks SQL

Ändert Metadaten, die der Sicht zugeordnet sind.

Ermöglicht das Ausführen der folgenden Aktionen:

  • Fügen Sie einen Zeitplan für das Aktualisieren einer vorhandenen materialisierten Sicht hinzu.
  • Ändern eines vorhandenen Aktualisierungszeitplans für eine materialisierte Ansicht
  • Löschen des Aktualisierungszeitplans für eine materialisierte Sicht Wenn der Zeitplan gelöscht wird, muss das Objekt manuell aktualisiert werden, um die neuesten Daten widerzuspiegeln.

Verwenden Sie COMMENT ON, um einen Kommentar zu einer Ansicht oder den zugehörigen Spalten hinzuzufügen oder zu ändern.

Syntax

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

Parameter

  • ZEITPLAN [ REFRESH ] Planungsklausel

    Ermöglicht es Ihnen, einer materialisierten Sicht einen Zeitplan hinzuzufügen oder den Zeitplan einer materialisierten Sicht zu ändern.

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

      Verwenden Sie EVERY die Syntax, um eine aktualisierung zu planen, die in regelmäßigen Abständen auftritt. Wenn die Syntax EVERY angegeben ist, wird die Streaming-Tabelle oder materialisierte Ansicht regelmäßig in dem angegebenen Intervall aktualisiert, basierend auf dem angegebenen Wert, z. B. HOUR, HOURS, DAY, DAYS, WEEK oder WEEKS. In der folgenden Tabelle sind die akzeptierten Werte für ganze Zahlen von number aufgeführt.

      Zeiteinheit Ganzzahliger Wert
      HOUR or HOURS 1 <= H <= 72
      DAY or DAYS 1 <= D <= 31
      WEEK or WEEKS 1 <= W <= 8

      Hinweis

      Die Singular- und Pluralformen der enthaltenen Zeiteinheit sind semantisch gleichwertig.

    • CRON cron_string [ AT TIME ZONE timezone_id ]

      Zum Planen einer Aktualisierung mithilfe eines quartz cron-Werts. Gültige time_zone_values werden akzeptiert. AT TIME ZONE LOCAL wird nicht unterstützt.

      Fehlt AT TIME ZONE, wird die Sitzungszeitzone verwendet. Wenn AT TIME ZONE fehlt und die Sitzungszeitzone nicht festgelegt ist, wird ein Fehler ausgelöst. SCHEDULE ist semantisch äquivalent mit SCHEDULE REFRESH.

Beispiele


  -- 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 two hours for a materialized view
  > ALTER MATERIALIZED VIEW my_mv
      ALTER SCHEDULE EVERY 2 HOURS;

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