다음을 통해 공유

ALTER STREAMING TABLE

적용 대상:예로 표시된 확인 Databricks SQL

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

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

테이블 또는 해당 열에 주석을 추가하거나 변경하려면 COMMENT ON사용합니다.

구문

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

매개 변수

  • table_name

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

  • SCHEDULE [ REFRESH ] schedule_clause

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

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

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

      시간 단위 정수 값
      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 값을 사용하여 새로 고침을 예약할 수 있습니다. 유효한 time_zone_values 허용됩니다. AT TIME ZONE LOCAL은 지원되지 않습니다.

      AT TIME ZONE이 없는 경우 세션 표준 시간대가 사용됩니다. AT TIME ZONE이 존재하지 않고 세션 시간대가 설정되지 않으면 오류가 발생합니다. SCHEDULE은 SCHEDULE REFRESH와 의미 체계가 같습니다.

  • 바꾸다 COLUMN

    중요합니다

    이 기능은 공개 미리보기 단계에 있습니다.

    열의 속성을 변경합니다.

  • SET ROW FILTER 절

    중요합니다

    이 기능은 공개 미리보기 단계에 있습니다.

    스트리밍 테이블에 행 필터 함수를 추가합니다. 스트리밍 테이블에 대한 모든 후속 쿼리는 함수가 부울 TRUE로 평가되는 행의 하위 집합을 받습니다. 이는 함수가 호출하는 사용자의 ID 또는 그룹 멤버 자격을 검사하여 특정 행을 필터링할지 여부를 결정할 수 있는 세분화된 액세스 제어 목적에 유용할 수 있습니다.

  • DROP ROW FILTER

    중요합니다

    이 기능은 공개 미리보기 단계에 있습니다.

    스트리밍 테이블에서 행 필터를 삭제합니다(있는 경우). 이후 쿼리는 자동 필터링 없이 테이블의 모든 행을 반환합니다.

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

    중요합니다

    이 기능은 공개 미리보기 단계에 있습니다.

    스트리밍 테이블에 태그를 적용합니다. 스트리밍 테이블에 태그를 추가할 수 있는 권한이 있어야 합니다 APPLY TAG .

    • tag_name

      리터럴 STRING이라는 것입니다. tag_name 스트리밍 테이블 또는 열 내에서 고유해야 합니다.

    • tag_value

      리터럴 STRING이라는 것입니다.

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

    중요합니다

    이 기능은 공개 미리보기 단계에 있습니다.

    스트리밍 테이블에서 태그를 제거합니다. 스트리밍 테이블에서 태그를 제거할 수 있는 권한이 있어야 합니다 APPLY TAG .

    • tag_name

      리터럴 STRING이라는 것입니다. tag_name 스트리밍 테이블 또는 열 내에서 고유해야 합니다.

예제

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