Dela via

ÄNDRA STRÖMNINGSTABELL

  • Artikel

Gäller för: markerad ja Databricks SQL

Gör att du kan antingen:

  • Lägg till ett schema för uppdatering av en befintlig strömningstabell.
  • Ändra ett befintligt uppdateringsschema för en strömningstabell.
  • Släpp uppdateringsschemat för en strömningstabell. Om schemat tas bort måste objektet uppdateras manuellt för att återspegla de senaste data.

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

Parametrar

  • table_name

    Namnet på den strömmande tabellen för att ändra definitionen av. Namnet får inte innehålla någon temporal specifikation.

  • SCHEMA [ UPPDATERA ] schedule_clause

    Gör att du kan lägga till ett schema i eller ändra schemat för en strömmande tabell.

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

      Viktigt!

      Den här funktionen finns som allmänt tillgänglig förhandsversion.

      Om du vill schemalägga en uppdatering som sker regelbundet använder du EVERY syntax. Om EVERY syntax anges uppdateras strömningstabellen eller den materialiserade vyn regelbundet med det angivna intervallet baserat på det angivna värdet, till exempel HOUR, HOURS, DAY, DAYS, WEEKeller WEEKS. I följande tabell visas godkända heltalsvärden 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 uppdatering med hjälp av ett quartz 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 är frånvarande och sessionens tidszon inte har angetts utlö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 CRON '0 0/15 * * * ? *';

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