ALTER STREAMING TABLE

적용 대상: Databricks SQL

다음 중 하나를 수행할 수 있습니다.

• 기존 스트리밍 table의 새로 고침 일정을 추가하세요.
• 스트리밍을 위한 table의 기존 refresh 일정을 변경합니다.
• 스트리밍 table에 대한 refresh 일정을 취소합니다. 일정이 삭제되면 최신 데이터를 반영하기 위해 개체를 수동으로 새로 고쳐야 합니다.

table 또는 그에 해당하는 columns주석을 추가하거나 변경하려면 COMMENT ON를 사용하세요.

구문

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

  정의를 변경할 스트리밍 이름은 table입니다. 이름에는 임시 사양이 포함되지 않아야 합니다.

• 일정 [ REFRESH ] 일정_조항

  스트리밍 table의 일정을 추가하거나 수정할 수 있도록 합니다.

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

    주기적으로 발생하는 refresh를 예약하려면 EVERY 구문을 사용합니다. EVERY 구문을 지정하면 스트리밍 table 또는 구체화된 뷰는 제공된 값(예: HOUR, HOURS, DAY, DAYS, WEEK또는 WEEKS)에 따라 지정된 간격으로 주기적으로 새로 고쳐집니다. 다음 table은 number의 허용되는 정수 values을 나열합니다.

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

    참고 항목

    포함된 시간 단위의 단수 및 복수 형태는 의미상 동일합니다.

  • CRON cron_string [ AT TIME ZONE timezone_id ]

    quartz cron 값을 사용하여 refresh를 예약하기 위해. 유효한 time_zone_values 허용됩니다. AT TIME ZONE LOCAL은 지원되지 않습니다.

    AT TIME ZONE이 없는 경우 세션 표준 시간대가 사용됩니다. 만약 AT TIME ZONE가 없고 세션 표준 시간대가 set이 아니면 오류가 발생합니다. SCHEDULE은 SCHEDULE REFRESH와 의미 체계가 같습니다.

예제

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

관련된 문서

• 댓글
• CREATE STREAMING TABLE
• 표준 시간대 관리