ALTER STREAMING TABLE

적용 대상: Databricks SQL

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

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

구문

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 ] }

매개 변수

• table_name

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

• 일정 [ 새로 고침 ] schedule_clause

  스트리밍 테이블의 일정에 일정을 추가하거나 변경할 수 있습니다.

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

    Important

    이 기능은 공개 미리 보기 상태입니다.

    주기적으로 발생하는 새로 고침을 예약하려면 구문을 사용합니다 EVERY . 구문을 지정하면 EVERY 스트리밍 테이블 또는 구체화된 뷰는 제공된 값(예: HOUR, , DAYSWEEKHOURSDAY, 또는 WEEKS)에 따라 지정된 간격으로 주기적으로 새로 고쳐집니다. 다음 표에서는 에 허용되는 정수 값을 나열합니다 number.

    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 ]

    석영 cron 값을 사용하여 새로 고침을 예약하려면 유효한 time_zone_values 허용됩니다. AT TIME ZONE LOCAL은 지원되지 않습니다.

    AT TIME ZONE이 없는 경우 세션 표준 시간대가 사용됩니다. AT TIME ZONE이 없고 세션 표준 시간대가 설정되어 있지 않은 경우 오류가 throw됩니다. 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 CRON '0 0/15 * * * ? *';

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

관련된 문서

• 스트리밍 테이블 생성하기
• 표준 시간대 관리