Freigeben über

ALTER MATERIALIZED VIEW

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 |
    ALTER COLUMN clause |
    SET ROW FILTER clause |
    DROP ROW FILTER |
    SET TAGS clause |
    UNSET TAGS clause }

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

  • SCHEDULE [ REFRESH ] Zeitplanklausel

    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.

  • Anpassen COLUMN

    Von Bedeutung

    Dieses Feature befindet sich in der Public Preview.

    Ändert eine Eigenschaft einer Spalte.

  • SET ROW FILTER Klausel

    Von Bedeutung

    Dieses Feature befindet sich in der Public Preview.

    Fügt der materialisierten Ansicht eine Zeilenfilterfunktion hinzu. Alle nachfolgenden Abfragen der materialisierten Ansicht erhalten eine Teilmenge der Zeilen, in denen die Funktion als boolescher TRUEWert ausgewertet wird. Dies kann für eine fein abgestufte Zugriffssteuerung nützlich sein, bei der die Funktion die Identität oder Gruppenmitgliedschaften der aufrufenden Benutzer überprüfen kann, um zu entscheiden, ob bestimmte Spalten gefiltert werden sollen.

  • DROP ROW FILTER

    Von Bedeutung

    Dieses Feature befindet sich in der Public Preview.

    Legt den Zeilenfilter aus der materialisierten Ansicht ab, falls vorhanden. Zukünftige Abfragen geben alle Zeilen aus der Tabelle ohne automatische Filterung zurück.

  • SET TAGS ( { tag_name = tag_value } [, ...] )

    Von Bedeutung

    Dieses Feature befindet sich in der Public Preview.

    Anwenden von Tags auf die materialisierte Ansicht. Sie müssen über die APPLY TAG-Berechtigung zum Hinzufügen von Tags zur materialisierten Ansicht verfügen.

    • tag_name

      Ein STRING-Literal. Das tag_name muss innerhalb der materialisierten Ansicht oder Spalte eindeutig sein.

    • tag_value

      Ein STRING-Literal.

  • UNSET TAGS ( tag_name [, ...] )

    Von Bedeutung

    Dieses Feature befindet sich in der Public Preview.

    Entfernen Sie Tags aus der materialisierten Ansicht. Sie benötigen die APPLY TAG Berechtigung, um Tags aus der materialisierten Ansicht zu entfernen.

    • tag_name

      Ein STRING-Literal. Das tag_name muss innerhalb der materialisierten Ansicht oder Spalte eindeutig sein.

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;