본문으로 건너뛰기
최종 수정: 에

MV_INFOS

설명​

비동기 구체화된 뷰용 임시 테이블을 생성하는 테이블 함수로, 특정 데이터베이스에 생성된 비동기 구체화된 뷰의 정보를 조회할 수 있습니다.

구문​

MV_INFOS("database"="<database>")

매개변수​

매개변수설명
<database>필수 항목입니다. 문자열 타입입니다. 비동기 구체화된 뷰의 메타데이터를 조회할 데이터베이스의 이름입니다.

반환 값​

이 테이블 함수는 비동기 구체화된 뷰를 설명하는 행을 반환하며, 반환되는 행이 없을 수도 있습니다. 함수 자체는 NULL을 반환하지 않습니다. 해당 메타데이터를 사용할 수 없는 경우 개별 필드는 비어 있거나 NULL일 수 있습니다.

필드타입설명
IdBIGINT구체화된 뷰 ID
NameTEXT구체화된 뷰 이름
JobNameTEXT구체화된 뷰에 해당하는 새로 고침 작업의 이름입니다. 이 이름으로 jobs("type"="mv")와 tasks("type"="mv")를 쿼리할 수 있습니다.
StateTEXT구체화된 뷰의 메타데이터 상태입니다. 가능한 값은 INIT, NORMAL, SCHEMA_CHANGE입니다.
SchemaChangeDetailTEXTState가 SCHEMA_CHANGE로 변경된 이유입니다. 구체화된 뷰가 스키마 변경 상태가 아니면 비어 있습니다.
RefreshStateTEXT가장 최근 새로 고침의 상태입니다. 가능한 값은 INIT, SUCCESS, FAIL입니다.
RefreshInfoTEXT구체화된 뷰에 정의된 새로 고침 전략으로, 빌드 모드, 새로 고침 방식, 트리거 모드를 포함합니다.
QuerySqlTEXT구체화된 뷰에 정의된 SQL 쿼리
EnvInfoTEXT구체화된 뷰를 생성할 당시의 환경 정보
MvPropertiesTEXT구체화된 뷰의 속성
MvPartitionInfoTEXT구체화된 뷰의 파티션 정보
SyncWithBaseTablesBOOLEAN구체화된 뷰의 데이터가 기본 테이블과 동기화되어 있는지 여부입니다. 동기화되지 않은 파티션을 확인하려면 SHOW PARTITIONS를 사용하세요.

RefreshInfo는 BUILD <BuildMode> REFRESH <RefreshMethod> ON <RefreshTrigger> [schedule] 형식으로 표시됩니다. 각 부분의 의미는 아래 열거형 필드 절에서 설명합니다.

구체화된 뷰 정보의 열거형 필드​

다음 열거형 필드는 구체화된 뷰의 정의와 정상 동작 여부를 확인할 때 자주 사용됩니다.

  • State: 구체화된 뷰의 메타데이터 상태입니다.
    • INIT: 구체화된 뷰가 생성되었지만 메타데이터가 아직 정상적으로 사용할 수 있는 상태에 도달하지 않았습니다.
    • NORMAL: 구체화된 뷰의 메타데이터가 정상입니다. 대부분의 경우 이 상태가 예상되는 정상 상태입니다.
    • SCHEMA_CHANGE: 기본 테이블이나 관련 객체의 스키마 변경이 이 구체화된 뷰에 영향을 미쳤습니다. 이유는 SchemaChangeDetail에서 확인하세요. 일반적으로 구체화된 뷰를 직접 쿼리할 수 있지만, 새로 고침이 성공할 때까지 투명한 쿼리 재작성에 사용하지 못할 수 있습니다.
  • RefreshState: 가장 최근 새로 고침의 결과 상태입니다.
    • INIT: 아직 새로 고침 결과가 기록되지 않았습니다.
    • SUCCESS: 가장 최근 새로 고침이 성공적으로 완료되었습니다.
    • FAIL: 가장 최근 새로 고침이 실패했습니다. JobName을 사용하여 tasks("type"="mv")를 쿼리하고 실패한 작업의 ErrorMsg를 확인하세요.
  • RefreshInfo.BuildMode: Doris가 구체화된 뷰의 데이터를 빌드하는 시점입니다.
    • IMMEDIATE: 생성 직후 구체화된 뷰를 빌드합니다.
    • DEFERRED: 생성 시에는 빌드하지 않습니다. 구체화된 뷰에 최신 데이터를 반영하려면 이후에 새로 고침이 필요합니다.
  • RefreshInfo.RefreshMethod: Doris가 새로 고칠 데이터를 선택하는 방식입니다.
    • COMPLETE: 항상 구체화된 뷰 전체를 새로 고칩니다.
    • AUTO: Doris가 모든 파티션을 새로 고칠지, 변경된 파티션만 새로 고칠지 결정합니다.
  • RefreshInfo.RefreshTrigger: 새로 고침 작업을 트리거하는 조건입니다.
    • MANUAL: 새로 고침을 수동으로 트리거합니다.
    • COMMIT: 관련 기본 테이블의 데이터 변경으로 새로 고침이 트리거됩니다.
    • SCHEDULE: 일정에 따라 새로 고침이 트리거됩니다. 일정 세부 정보는 ON SCHEDULE 뒤에 표시되며, RefreshInfo에서 확인할 수 있습니다.
  • MvPartitionInfo.partitionType: 구체화된 뷰의 파티션 구성 방식입니다.
    • FOLLOW_BASE_TABLE: 구체화된 뷰의 파티션이 기본 테이블의 파티션 열을 따릅니다.
    • SELF_MANAGE: 구체화된 뷰가 자체적으로 파티션을 관리합니다.
    • EXPR: 구체화된 뷰의 파티션을 표현식으로 정의합니다.
  • SyncWithBaseTables: 구체화된 뷰의 데이터가 기본 테이블과 동기화되어 있는지 여부입니다.
    • 1 또는 true: 동기화되어 있습니다.
    • 0 또는 false: 완전히 동기화되지 않았습니다. 파티션으로 나뉜 구체화된 뷰의 경우 SHOW PARTITIONS FROM <mv_name>을 사용하여 파티션별 동기화 상태를 확인하세요.

예제​

데이터베이스 test에 있는 구체화된 뷰를 조회합니다.

select *
from mv_infos("database"="test")
where Name = "mv1"\G
*************************** 1. row ***************************
                Id: 19494
              Name: mv1
           JobName: inner_mtmv_19494
             State: NORMAL
SchemaChangeDetail:
      RefreshState: SUCCESS
       RefreshInfo: BUILD DEFERRED REFRESH AUTO ON MANUAL
          QuerySql: SELECT `internal`.`test`.`user`.`k2`, `internal`.`test`.`user`.`k3` FROM `internal`.`test`.`user`
           EnvInfo: EnvInfo{ctlId='0', dbId='16813'}
      MvProperties: {partition_sync_limit=100, partition_sync_time_unit=YEAR}
   MvPartitionInfo: MTMVPartitionInfo{partitionType=FOLLOW_BASE_TABLE, relatedTable=user, relatedCol='k2', partitionCol='k2'}
SyncWithBaseTables: 1

이 결과의 각 필드는 다음과 같습니다.

  • Id와 Name은 구체화된 뷰를 식별합니다.
  • JobName은 이 구체화된 뷰의 새로 고침 작업 이름입니다. 이 이름으로 작업이나 새로 고침 태스크를 쿼리할 수 있습니다. 예를 들어 select * from jobs("type"="mv") where Name = "inner_mtmv_19494";를 사용할 수 있습니다.
  • State는 NORMAL이며, 구체화된 뷰의 메타데이터가 정상임을 의미합니다. INIT는 구체화된 뷰가 방금 생성되었거나 초기화되었음을 의미합니다. SCHEMA_CHANGE는 기본 테이블의 스키마 변경이 이 구체화된 뷰에 영향을 미쳤음을 의미합니다. 이 상태에서는 SchemaChangeDetail을 확인하세요.
  • SchemaChangeDetail은 비어 있습니다. State가 SCHEMA_CHANGE가 아니기 때문입니다.
  • RefreshState는 SUCCESS이며, 가장 최근 새로 고침이 성공했음을 의미합니다. INIT는 아직 성공한 새로 고침 상태가 기록되지 않았음을 의미합니다. FAIL은 가장 최근 새로 고침이 실패했음을 의미합니다. tasks("type"="mv")를 JobName으로 쿼리하여 실패한 작업과 해당 작업의 ErrorMsg를 확인하세요.
  • RefreshInfo는 BUILD DEFERRED REFRESH AUTO ON MANUAL입니다. BUILD DEFERRED는 생성 시 구체화된 뷰를 즉시 빌드하지 않았음을 의미합니다. REFRESH AUTO는 Doris가 모든 파티션을 새로 고칠지, 변경된 파티션만 새로 고칠지 결정함을 의미합니다. ON MANUAL은 일정에 따르지 않고 수동으로 새로 고침을 트리거함을 의미합니다.
  • QuerySql은 구체화된 뷰의 쿼리 정의입니다.
  • EnvInfo는 구체화된 뷰를 생성할 당시의 환경 정보를 기록합니다.
  • MvProperties는 구체화된 뷰의 속성을 보여 줍니다. 이 예제에서는 partition_sync_limit=100과 partition_sync_time_unit=YEAR에 의해 파티션 동기화가 제한됩니다.
  • MvPartitionInfo는 구체화된 뷰의 파티션 구성 방식을 보여 줍니다. FOLLOW_BASE_TABLE은 구체화된 뷰가 기본 테이블의 파티션 열을 따름을 의미합니다. SELF_MANAGE는 구체화된 뷰가 자체적으로 파티션을 관리함을 의미합니다. EXPR은 구체화된 뷰가 표현식 기반 파티션 정의를 사용함을 의미합니다.
  • SyncWithBaseTables는 1이며, 구체화된 뷰의 데이터가 기본 테이블과 동기화되어 있음을 의미합니다. 0은 완전히 동기화되지 않았음을 의미합니다. 파티션으로 나뉜 구체화된 뷰의 경우 SHOW PARTITIONS FROM <mv_name>을 사용하여 파티션별 동기화 상태를 확인하세요.

이 구체화된 뷰의 가장 최근 새로 고침 태스크를 조회하려면 다음을 실행합니다.

select TaskId, JobName, MvName, Status, ErrorMsg, CreateTime, FinishTime
from tasks("type"="mv")
where JobName = "inner_mtmv_19494"
order by CreateTime desc
limit 1;
+-----------------+------------------+--------+---------+----------+---------------------+---------------------+
| TaskId          | JobName          | MvName | Status  | ErrorMsg | CreateTime          | FinishTime          |
+-----------------+------------------+--------+---------+----------+---------------------+---------------------+
| 437156301250803 | inner_mtmv_19494 | mv1    | SUCCESS |          | 2025-01-07 22:13:48 | 2025-01-07 22:17:45 |
+-----------------+------------------+--------+---------+----------+---------------------+---------------------+
Report issue