Delen via

ALTER STREAMING TABLE

Van toepassing op:vinkje als ja aan Databricks SQL

Hiermee kunt u het volgende doen:

  • Voeg een schema toe voor het vernieuwen van een bestaande streamingtabel.
  • Een bestaand vernieuwingsschema voor een streamingtabel wijzigen.
  • Verwijder het vernieuwingsschema voor een streamingtabel. 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 tabel of kolommen wilt toevoegen of wijzigen, gebruikt u COMMENT ON.

Syntaxis

ALTER STREAMING TABLE table_name
  {
    { ADD | ALTER } SCHEDULE [ REFRESH ] schedule_clause |
    DROP SCHEDULE |
    ALTER COLUMN clause |
    SET ROW FILTER clause |
    DROP ROW FILTER |
    SET TAGS clause |
    UNSET TAGS clause |
  }

  schedule_clause
  { EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } |
    CRON cron_string [ AT TIME ZONE timezone_id ] }

Parameterwaarden

  • table_name

    De naam van de streamingtabel waarvan de definitie moet worden gewijzigd. De naam mag geen tijdelijke specificatie bevatten.

  • SCHEDULE [ REFRESH ] schedule_clause

    Hiermee kunt u een schema toevoegen aan of het schema van een streamingtabel wijzigen.

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

      Als u een vernieuwing wilt plannen die periodiek plaatsvindt, gebruikt u EVERY syntaxis. Als de EVERY syntaxis is opgegeven, wordt de streamingtabel of gematerialiseerde weergave periodiek vernieuwd op het vastgestelde tijdsinterval aan de hand van de opgegeven waarde, zoals HOUR, HOURS, DAY, DAYS, WEEKof WEEKS. De volgende tabel bevat geaccepteerde gehele getallen voor number.

      Tijdeenheid 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 vernieuwing plannen met behulp van een Quartz cron waarde. 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 is ingesteld, wordt er een fout gegenereerd. SCHEDULE is semantisch gelijk aan SCHEDULE REFRESH.

  • VERANDEREN COLUMN

    Belangrijk

    Deze functie bevindt zich in openbare preview-versie.

    Hiermee wijzigt u een eigenschap van een kolom.

  • SET ROW FILTER clausule

    Belangrijk

    Deze functie bevindt zich in openbare preview-versie.

    Hiermee voegt u een rijfilterfunctie toe aan de streamingtabel. Alle daaropvolgende query's naar de streamingtabel ontvangen een subset van de rijen waarin de functie evalueert naar een booleaanse TRUEwaarde. Dit kan handig zijn voor verfijnde toegangsbeheerdoeleinden, waarbij de functie de identiteit of groepslidmaatschappen van de aanroepende gebruiker kan inspecteren om te bepalen of bepaalde rijen moeten worden gefilterd.

  • DROP ROW FILTER

    Belangrijk

    Deze functie bevindt zich in openbare preview-versie.

    Verwijdert het rijfilter uit de streamingtabel, indien van toepassing. Toekomstige query's retourneren alle rijen uit de tabel zonder automatisch filteren.

  • SET TAGS ( { tag_name = tag_value } [, ...] )

    Belangrijk

    Deze functie bevindt zich in openbare preview-versie.

    Tags toepassen op de streamingtabel. U hebt APPLY TAG toestemming nodig om tags toe te voegen aan de streamingtabel.

    • tag_name

      Een letterlijke STRING. De tag_name moet uniek zijn binnen de streaming tabel of kolom.

    • tag_value

      Een letterlijke STRING.

  • UNSET TAGS ( tag_name [, ...] )

    Belangrijk

    Deze functie bevindt zich in openbare preview-versie.

    Verwijder tags uit de streamingtabel. U moet gemachtigd zijn APPLY TAG om tags uit de streamingtabel te verwijderen.

    • tag_name

      Een letterlijke STRING. De tag_name moet uniek zijn binnen de streaming tabel of kolom.

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

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