ALTER STREAMING TABLE

  • Artikel

Van toepassing op:vinkje als ja aan Databricks SQL

Belangrijk

Deze functie is beschikbaar als openbare preview.

Hiermee kunt u het volgende doen:

  • Voeg een schema toe voor het vernieuwen van een bestaande gerealiseerde weergave of streamingtabel.
  • Wijzig een bestaand vernieuwingsschema voor een gerealiseerde weergave of streamingtabel.
  • Verwijder het vernieuwingsschema voor een gerealiseerde weergave of streamingtabel. Als het schema wordt verwijderd, moet het object handmatig worden vernieuwd om de meest recente gegevens weer te geven.

Syntaxis

ALTER STREAMING TABLE table_name
  {
    { ADD | ALTER } SCHEDULE [ REFRESH ]
      CRON cron_string [ AT TIME ZONE timezone_id ] |
    DROP SCHEDULE
  }

Parameters

  • Table_name

    De naam van de streamingtabel om de definitie van te wijzigen. De naam mag geen tijdelijke specificatie bevatten.

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

    Indien opgegeven, plant u de streamingtabel of de gerealiseerde weergave om de gegevens te vernieuwen met het opgegeven kwarts cron-schema . Alleen 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 deze afwezig is en de sessietijdzone niet is ingesteld, wordt er een fout gegenereerd. SCHEDULE is semantisch gelijk aan SCHEDULE REFRESH.

    U kunt de SCHEDULE syntaxis niet gebruiken in een pijplijndefinitie van Delta Live Tables.

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;