Delen via

ALTER STREAMING TABLE

  • Artikel

Van toepassing op:vinkje als ja aan Databricks SQL

Hiermee kunt u het volgende doen:

  • Voeg een vernieuwingsschema toe voor een bestaande stream table.
  • Een bestaand refresh schema voor een streaming-tablewijzigen.
  • Verwijder het refresh schema voor een streaming-table. Als het schema wordt verwijderd, moet het object handmatig worden vernieuwd om de meest recente gegevens weer te geven.

Als u een opmerking aan een table of de bijbehorende columnswilt toevoegen of wijzigen, gebruikt u COMMENT ON.

Syntaxis

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

    De naam van het streaming-table om de definitie te wijzigen. De naam mag geen tijdelijke specificatie bevatten.

  • SCHEDULE [ REFRESH ] schedule_clause

    Hiermee kunt u een schema toevoegen aan of het schema van een table-streaming wijzigen.

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

      Belangrijk

      Deze functie is beschikbaar als openbare preview.

      Als u een refresh wilt plannen die periodiek plaatsvindt, gebruik dan de syntaxis EVERY. Als EVERY syntaxis is opgegeven, wordt de streaming table of gematerialiseerde weergave periodiek vernieuwd met het opgegeven interval op basis van de opgegeven waarde, zoals HOUR, HOURS, DAY, DAYS, WEEKof WEEKS. In de volgende table worden geaccepteerde gehele getallen weergegeven values voor number.

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

      Notitie

      De enkelvoudige en meervoudvormen van de opgenomen tijdseenheid zijn semantisch gelijkwaardig.

    • CRON cron_string [ AT TIME ZONE timezone_id ]

      Een refresh plannen met behulp van een Quartz cron-uitdrukking. Geldige time_zone_values worden geaccepteerd. AT TIME ZONE LOCAL wordt niet ondersteund.

      Als AT TIME ZONE deze afwezig is, wordt de sessietijdzone gebruikt. Als AT TIME ZONE afwezig is en de sessietijdzone niet set, wordt er een fout gegenereerd. SCHEDULE is semantisch gelijk aan SCHEDULE REFRESH.

Voorbeelden

-- 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;