Freigeben über

ALTER STREAMING TABLE

  • Artikel

Gilt für: Häkchen Databricks SQL

Wichtig

Dieses Feature befindet sich in der Public Preview.

Ermöglicht Folgendes:

  • Hinzufügen eines Zeitplans zum Aktualisieren einer vorhandenen materialisierten Ansicht oder Streamingtabelle
  • Ändern eines vorhandenen Aktualisierungszeitplans für eine materialisierte Ansicht oder Streamingtabelle
  • Löschen des Aktualisierungszeitplans für eine materialisierte Ansicht oder 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 ]
      CRON cron_string [ AT TIME ZONE timezone_id ] |
    DROP SCHEDULE
  }

Parameter

  • table_name

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

  • SCHEDULE [ REFRESH ] CRON cron_string [ AT TIME ZONE timezone_id ]

    Falls angegeben, legt dieser Parameter fest, dass die Daten der Streamingtabelle oder der materialisierten Sicht nach dem angegebenen quarz cron-Zeitplan aktualisiert werden. Es werden nur time_zone_values 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.

    Sie können die Syntax SCHEDULE nicht in einer Delta Live Tables-Pipelinedefinition verwenden.

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;