system.view_refreshes 시스템 테이블

system.view_refreshes 는 Refreshable Materialized Views 에 대한 정보를 담고 있어요. 새로 고침이 진행 중인지 여부와 무관하게 모든 refreshable materialized view를 포함해요.

출처: 문서

본문

ClickHouse Cloud에서의 조회 — 이 시스템 테이블의 데이터는 ClickHouse Cloud에서 각 노드에 로컬로 저장돼요. 따라서 모든 데이터의 완전한 뷰를 얻으려면 clusterAllReplicas 함수가 필요해요. 자세한 내용은 여기 를 참고하세요.

Description

Refreshable Materialized Views 에 대한 정보를 포함해요. 새로 고침이 진행 중인지 여부와 무관하게 모든 refreshable materialized view를 포함해요.

Columns

database (String) — 테이블이 있는 데이터베이스의 이름이에요.
view (String) — 테이블 이름이에요.
uuid (UUID) — 테이블 uuid(Atomic 데이터베이스)예요.
status (String) — 새로 고침의 현재 상태예요.
last_success_time (Nullable(DateTime)) — 마지막으로 성공한 새로 고침이 시작된 시각이에요. 서버 시작 또는 테이블 생성 이후 성공적인 새로 고침이 없었으면 NULL이에요.
last_success_duration_ms (Nullable(UInt64)) — 마지막 새로 고침이 걸린 시간이에요.
last_refresh_time (Nullable(DateTime)) — 마지막 새로 고침 시도가 끝난(알려진 경우) 또는 시작된(알려지지 않았거나 아직 실행 중인 경우) 시각이에요. 서버 시작 또는 테이블 생성 이후 새로 고침 시도가 없었으면 NULL이에요.
last_refresh_replica (String) — 조정(coordination)이 활성화된 경우, 현재(실행 중인 경우) 또는 이전(실행 중이 아닌 경우) 새로 고침 시도를 한 복제본의 이름이에요.
next_refresh_time (Nullable(DateTime)) — 다음 새로 고침이 시작되도록 예약된 시각이에요. 다음 새로 고침 시간을 현재 알 수 없는 경우(예: 의존성을 기다릴 때, 상태 WaitingForDependencies 또는 MissingDependencies) NULL이에요.
exception (String) — 이전 시도가 실패한 경우 그 오류 메시지예요.
retry (UInt64) — 현재 새로 고침에 대해 지금까지 실패한 시도 횟수예요. 상태가 RunningOnAnotherReplica 인 경우 사용할 수 없어요.
progress (Nullable(Float64)) — 주어진 복제본에서 현재 실행 중이거나 가장 최근에 완료된 새로 고침의 진행 상황으로, 0과 1 사이예요. 상태가 RunningOnAnotherReplica 이거나 새로 고침이 실행 중이 아니면 NULL이에요.
read_rows (Nullable(UInt64)) — 주어진 복제본에서 현재 실행 중이거나 가장 최근에 완료된 새로 고침이 읽은 행 수예요. 상태가 RunningOnAnotherReplica 이면 NULL이에요.
read_bytes (Nullable(UInt64)) — 주어진 복제본에서 현재 실행 중이거나 가장 최근에 완료된 새로 고침이 읽은 바이트 수예요. 상태가 RunningOnAnotherReplica 이면 NULL이에요.
total_rows (Nullable(UInt64)) — 주어진 복제본에서 현재 실행 중이거나 가장 최근에 완료된 새로 고침이 읽어야 하는 총 행 수의 추정값이에요. 상태가 RunningOnAnotherReplica 이면 NULL이에요.
written_rows (Nullable(UInt64)) — 주어진 복제본에서 현재 실행 중이거나 가장 최근에 완료된 새로 고침이 쓴 행 수예요. 상태가 RunningOnAnotherReplica 이면 NULL이에요.
written_bytes (Nullable(UInt64)) — 주어진 복제본에서 현재 실행 중이거나 가장 최근에 완료된 새로 고침이 쓴 바이트 수예요. 상태가 RunningOnAnotherReplica 이면 NULL이에요.

Example

SELECT
    database,
    view,
    status,
    last_refresh_time,
    next_refresh_time
FROM system.view_refreshes

┌─database─┬─view───────────────────────┬─status────┬───last_refresh_time─┬───next_refresh_time─┐
│ default  │ hello_documentation_reader │ Scheduled │ 2023-12-01 01:24:00 │ 2023-12-01 01:25:00 │
└──────────┴────────────────────────────┴───────────┴─────────────────────┴─────────────────────┘