Compute — 쿼리와 워크하우스

Compute 는 SQL을 실행하고 그 실행 자원을 관리하는 화면입니다. 쿼리 엔진은 Trino이며, 화면은 세 개 탭으로 구성됩니다.

탭	역할
Warehouses	워크하우스 목록과 SQL Editor
Queries	현재 실행 중인 쿼리
Resource Groups	리소스 그룹별 사용 현황

요약 지표

지표	의미
Warehouses	워크하우스 수와 실행 중 개수
Total Workers	전체 워커 수
Active Queries	실행 중 쿼리 수와 대기 수
Default WH	기본 워크하우스의 워커 수

SQL Editor

쿼리를 입력하고 Run Query 로 실행합니다.

• 문법은 Trino SQL 을 따릅니다.
• 결과는 하단 표에 표시되며, 반환 행 수 · 소요 시간 · 컬럼 수를 함께 보여줍니다.
• 실행 실패 시 오류 메시지가 그대로 표시됩니다.

-- 일별 집계 예
SELECT date_trunc('day', measured_at) AS d, count(*) AS cnt
FROM iceberg.<schema>.<table>
WHERE measured_at >= current_date - interval '7' day
GROUP BY 1
ORDER BY 1

조회 대상 찾기

어떤 테이블을 조회할지 모를 때는 Data Catalogs에서 위치를 확인하거나, Data Hub에서 데이터셋 설명을 먼저 읽는 것이 빠릅니다.

Virtual Warehouse

워크하우스는 쿼리 실행에 쓰는 워커 자원의 묶음입니다. 용도별로 나눠 두면 무거운 분석이 일반 조회를 지연시키는 상황을 줄일 수 있습니다.

항목	의미
이름	워크하우스 식별
워커 수	할당된 워커 개수
상태	running · suspended · error
기본 여부	지정하지 않았을 때 사용되는 워크하우스

관리 동작

동작	설명
스케일	워커 수를 하나 단위로 늘리거나 줄입니다. 최소 1개입니다.
Suspend	일시 정지해 자원을 반환합니다.
Resume	정지된 워크하우스를 다시 시작합니다.
Delete	워크하우스를 삭제합니다.

워크하우스 생성 · 삭제와 스케일 조정은 플랫폼 관리자 권한이 필요합니다.

💡 팁

크기를 늘리기 전에 쿼리를 먼저 점검하세요. 필요한 컬럼만 조회하고 파티션 조건을 넣는 것이 워커 추가보다 효과가 큰 경우가 많습니다.

Queries

현재 실행 중인 쿼리 목록입니다.

항목	의미
쿼리 ID	실행 식별자
상태	실행 · 대기 상태
사용자	실행 주체
태그	리소스 그룹(rg:) · 워크하우스(wh:) 태그
경과 시간	실행 시간

태그를 보면 이 쿼리가 어느 리소스 그룹에 배정됐는지 알 수 있습니다. 장시간 실행 중인 쿼리가 자원을 점유하고 있는지 여기서 확인합니다.

Resource Groups

리소스 그룹은 쿼리를 용도별로 격리하는 단위입니다.

항목	의미
그룹 이름	리소스 그룹
실행 중	현재 실행 쿼리 수
대기	큐에 있는 쿼리 수
한도	동시 실행 상한

대기가 계속 쌓이는 그룹이 있으면 동시 실행 한도나 워크하우스 규모를 검토합니다. 서비스 쿼리와 사용자 임시 쿼리를 서로 다른 그룹으로 분리해 두면, 임시 쿼리가 몰려도 서비스 응답이 유지됩니다.

권한과 가시성

• 접근 정책에 따라 조회할 수 없는 카탈로그 · 테이블이 있습니다.
• 개인정보 컬럼은 역할에 따라 마스킹된 값으로 반환됩니다.
• 쿼리 실행은 감사 로그에 기록됩니다.

성능 지침

지침	이유
LIMIT 을 습관적으로 붙인다	실수로 대량 스캔하는 것을 막습니다
파티션 컬럼을 WHERE 에 넣는다	스캔 범위가 줄어듭니다
SELECT * 를 피한다	컬럼 지향 저장의 이점을 살립니다
반복 조회는 데이터셋으로 저장한다	매번 같은 집계를 다시 계산하지 않습니다
무거운 작업은 별도 워크하우스에서	다른 사용자 영향이 줄어듭니다

자주 발생하는 오류

상황	원인	조치
접근 거부	카탈로그 · 테이블 권한 부족	거버넌스 담당자에게 권한 요청
자원 한도 초과	워크하우스 규모 부족 또는 과도한 스캔	쿼리 최적화 후 재실행, 필요 시 워커 증설
카탈로그 사용 불가	원천 연결 오류	운영 담당자에게 카탈로그 상태 확인 요청
쿼리가 취소됨	시간 초과 또는 사용자 취소	조건을 좁혀 재실행