Dela via

ALTER STREAMING TABLE

  • Artikel

Gäller för:markerad ja Databricks SQL

Gör att du kan antingen:

  • Lägg till ett schema för uppfräschning av en befintlig streaming table.
  • Ändra ett befintligt refresh-tidsschema för en strömmande table.
  • Ta bort refresh schema för en strömmande table. Om schemat tas bort måste objektet uppdateras manuellt för att återspegla de senaste data.

Om du vill lägga till eller ändra en kommentar på en table eller dess columnsanvänder du COMMENT ON.

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

Parameters

  • table_name

    Namnet på den strömmande table för att ändra dess definition. Namnet får inte innehålla någon temporal specifikation.

  • SCHEMA [ REFRESH ] schema_klausul

    Du kan lägga till eller ändra schemat för en strömmande table.

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

      För att schemalägga en refresh som sker periodiskt, använd syntaxen EVERY. Om EVERY syntax anges uppdateras den strömmande table- eller materialiserade vyn regelbundet med det angivna intervallet baserat på det angivna värdet, till exempel HOUR, HOURS, DAY, DAYS, WEEKeller WEEKS. Följande table visar godkända heltal values för number.

      Time unit Heltalsvärde
      HOUR or HOURS 1 <= H <= 72
      DAY or DAYS 1 <= D <= 31
      WEEK or WEEKS 1 <= W <= 8

      Kommentar

      Singular- och pluralformerna i den inkluderade tidsenheten är semantiskt likvärdiga.

    • CRON cron_string [ AT TIME ZONE timezone_id ]

      Så här schemalägger du en refresh genom att använda ett kvarts cron- värde. Giltiga time_zone_values accepteras. AT TIME ZONE LOCAL stöds inte.

      Om AT TIME ZONE den saknas används tidszonen för sessionen. Om AT TIME ZONE saknas och sessionens tidszon inte är setutlöses ett fel. SCHEDULE är semantiskt likvärdigt med SCHEDULE REFRESH.

Exempel

-- 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 EVERY 15 MINUTES;

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