ALTER STREAMING TABLE

  • Artikel

Gilt für: Häkchen Databricks SQL

Ermöglicht Folgendes:

  • Hinzufügen eines Zeitplans zum Aktualisieren einer vorhandenen Streamingtabelle.
  • Ändern eines vorhandenen Aktualisierungszeitplans für eine Streamingtabelle.
  • Löschen des Aktualisierungszeitplans für eine Streamingtabelle. Wenn der Zeitplan gelöscht wird, muss das Objekt manuell aktualisiert werden, um die neuesten Daten widerzuspiegeln.

Syntax

ALTER STREAMING TABLE table_name
  {
    { 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

  • table_name

    Der Name der Streamingtabelle, deren Definition geändert werden soll. Der Name darf keine temporale Spezifikation enthalten.

  • SCHEDULE [ REFRESH ] schedule_clause

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

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

      Wichtig

      Dieses Feature befindet sich in der Public Preview.

      Verwenden Sie EVERY die Syntax, um eine aktualisierung zu planen, die in regelmäßigen Abständen auftritt. Wenn EVERY die Syntax angegeben ist, wird die Streamingtabelle oder materialisierte Ansicht regelmäßig im angegebenen Intervall aktualisiert, basierend auf dem angegebenen Wert, z HOUR. B. , , HOURS, DAY, DAYS, WEEKoder WEEKS. In der folgenden Tabelle sind akzeptierte ganzzahlige Werte für number.

      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 ]

      Um eine Aktualisierung mit einem Quarz-Cron-Wert zu planen. 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 the streaming table once a day
-- at midnight in Los Angeles
> ALTER STREAMING TABLE my_st
  ADD SCHEDULE CRON '0 0 0 * * ? *' AT TIME ZONE 'America/Los_Angeles';

-- Alters the schedule to run every 15 minutes for a streaming table
> ALTER STREAMING TABLE my_st
  ALTER SCHEDULE CRON '0 0/15 * * * ? *';

-- Drops the schedule for a streaming table
> ALTER STREAMING TABLE my_st
  DROP SCHEDULE;