Udostępnij za pośrednictwem

ALTER STREAMING TABLE

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL

Umożliwia wykonywanie następujących czynności:

  • Dodaj harmonogram odświeżania dla istniejącego przesyłania strumieniowego table.
  • Zmień istniejący harmonogram refresh dla przesyłania strumieniowego table.
  • Usuń harmonogram refresh dla tableprzesyłania strumieniowego. Jeśli harmonogram zostanie porzucony, obiekt musi zostać odświeżony ręcznie, aby odzwierciedlić najnowsze dane.

Aby dodać lub zmienić komentarz na temat table lub jego columns, użyj COMMENT ON.

Składnia

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

    Nazwa strumienia table, aby zmienić jego definicję. Nazwa nie może zawierać specyfikacji czasowej.

  • harmonogram [ REFRESH ] klauzula_harmonogramu

    Umożliwia dodanie lub zmianę harmonogramu przesyłania strumieniowego table.

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

      Aby zaplanować refresh, które występuje okresowo, użyj składni EVERY. Jeśli określono składnię EVERY, przesyłający strumieniowo widok table lub widok zmaterializowany jest okresowo odświeżany w określonym przedziale czasowym, na podstawie podanej wartości, takiej jak HOUR, HOURS, DAY, DAYS, WEEKlub WEEKS. Poniższa table zawiera listę akceptowanych liczb całkowitych values dla number.

      Time unit Wartość całkowita
      HOUR or HOURS 1 <= H <= 72
      DAY or DAYS 1 <= D <= 31
      WEEK or WEEKS 1 <= W <= 8

      Uwaga

      Liczba pojedyncza i mnoga dołączonej jednostki czasowej są semantycznie równoważne.

    • CRON cron_string [ AT TIME ZONE timezone_id ]

      Aby zaplanować refresh przy użyciu wartości cron. Akceptowane są prawidłowe time_zone_values . AT TIME ZONE LOCAL nie jest obsługiwana.

      Jeśli AT TIME ZONE jest nieobecny, używana jest strefa czasowa sesji. Jeśli AT TIME ZONE jest nieobecny, a strefa czasowa sesji nie jest set, zostanie zgłoszony błąd. SCHEDULEjest semantycznie równoważne .SCHEDULE REFRESH

Przykłady

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