ALTER STREAMING TABLE

Dotyczy:check oznaczone tak Databricks SQL

Ważne

Ta funkcja jest dostępna w publicznej wersji zapoznawczej. Aby zarejestrować się w celu uzyskania dostępu, wypełnij ten formularz.

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

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

Składni

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

Parametry

  • Nazwa_tabeli

    Nazwa tabeli przesyłania strumieniowego, która ma zmienić definicję. Nazwa nie może zawierać specyfikacji czasowej.

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

    Jeśli zostanie podana, zaplanuje tabelę przesyłania strumieniowego lub zmaterializowany widok, aby odświeżyć swoje dane za pomocą danego harmonogramu kronu kwarcowego . Akceptowane są tylko time_zone_values . AT TIME ZONE LOCAL nie jest obsługiwane. 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 ustawiona, zgłaszany jest błąd. SCHEDULEjest semantycznie równoważne .SCHEDULE REFRESH

    Nie można użyć SCHEDULE składni w definicji potoku delta Live Tables.

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 CRON '0 0/15 * * * ? *';

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