쿼리 편집기

쿼리에 사용할 데이터(데이터 원본, 데이터베이스, 테이블)를 선택한 후 쿼리를 실행해 주세요.

쿼리 편집기 화면

1. 데이터 원본 설정

1. 데이터 원본 선택 : Data Catalog 혹은 MySQL 유형의 연결된 모든 데이터 원본 목록을 보여줍니다.
2. 데이터베이스 선택 : 선택한 데이터 원본에 대한 모든 데이터베이스 목록을 보여줍니다.
3. 테이블 선택 : 선택한 데이터베이스의 모든 테이블 목록을 보여줍니다.

테이블 관리

테이블의 필드를 확인할 수 있으며, 테이블별로 아래와 같이 부가 기능을 이용할 수 있습니다.

1. 카카오클라우드 콘솔 > Analytics > Data Query 메뉴로 이동합니다.
2. 쿼리 편집기 메뉴에서 데이터 원본 선택 > 데이터베이스 선택 > 테이블 목록을 확인합니다.
3. 부가 기능을 사용할 테이블 우측의 더 보기 아이콘 클릭합니다.
4. 아래와 같이 세 가지 부가 기능을 활용할 수 있습니다.

테이블 부가 기능

구분	설명
테이블 미리보기	테이블 데이터 미리보기 - 선택과 동시에 쿼리가 실행됨 ex) SELECT * FROM {데이터 원본}.{데이터베이스명}.{테이블명} LIMIT 10
테이블 DDL 생성	테이블 생성 정보 보기 - 선택과 동시에 쿼리가 실행됨 ex) SHOW CREATE TABLE {데이터 원본}.{데이터베이스명}.{테이블명}
편집기에 삽입	편집기에 테이블 이름을 삽입

2. 쿼리 실행

쿼리를 수행할 데이터 소스를 모두 선택했다면, 편집기에서 SQL 쿼리를 작성 및 실행합니다.

주의

1. 쿼리 실행 시간이 1시간을 초과할 경우 Trino 엔진에 설정된 최대 실행 시간 제한에 따라 쿼리가 강제로 종료됩니다.
2. 쿼리 실행 중 실행 계획을 수립하는 데 10분을 초과하면 쿼리가 종료됩니다.

편집기

데이터 원본 선택 영역을 제외한 편집기 화면에서 제공되는 기능입니다.

구분	설명
편집기	쿼리문 작성 - 최대 10개까지 추가 가능 - 쿼리문 최대 입력 크기 : 256KB
쿼리 결과 탭	쿼리 결과 정보를 제공
결과 상세 탭	쿼리 결과에 대한 상세 정보를 제공
[쿼리 실행] 버튼	쿼리 실행 후 [쿼리 재실행]으로 변경 ⚠️ 쿼리 결과 저장 위치를 설정해야 활성화됩니다.
[실행 중지] 버튼	쿼리 실행 중 실행을 중지할 수 있음 ⚠️ 이미 실행이 완료된 쿼리에 중지 요청 시 중단이 실패할 수 있습니다.
[쿼리 결과 재사용] 드롭다운	새로 데이터를 조회하지 않고 이전 쿼리 결과를 재사용할 수 있음

저장 쿼리

주요한 쿼리 혹은 자주 사용하는 쿼리를 저장할 수 있습니다.

안내

프로젝트 멤버 당 100개까지 저장 가능합니다.

1. 카카오클라우드 콘솔 > Analytics > Data Query 메뉴로 이동합니다.
2. 저장 쿼리 기능을 사용할 편집기 우측의 더 보기 아이콘을 클릭합니다.
3. 아래와 같이 네 가지 부가 기능을 활용할 수 있습니다.

저장 쿼리 부가 기능

구분	설명
저장	쿼리를 저장하기 - 저장과 동시에 저장 쿼리 목록에 업데이트됨
다른 이름으로 저장	저장된 쿼리를 다른 이름으로 새롭게 저장하기 - 저장 쿼리 목록에 다른 이름의 쿼리가 새롭게 저장됨
이름 변경하기	쿼리의 이름을 다른 이름으로 변경하기
삭제	저장 쿼리를 삭제하기 - 저장과 동시에 편집기와 저장 쿼리 목록에서 삭제됨

저장 쿼리 목록 보기

1. 카카오클라우드 콘솔 > Analytics > Data Query 메뉴로 이동합니다.
2. 쿼리 편집기 > 저장 쿼리 탭에서 저장한 쿼리 목록을 확인합니다.

항목	설명
쿼리 ID	쿼리 실행 시 생성되는 쿼리 ID
쿼리 이름	쿼리 저장 시 지정한 쿼리 이름
쿼리문	실행한 SQL 쿼리문
쿼리 설명	쿼리에 대한 설명
저장 시간	쿼리를 저장한 일시
[쿼리 열기] 버튼	전체 쿼리문 보기 및 쿼리 편집기의 새로운 탭에서 열림

쿼리 결과 재사용

쿼리 결과 재사용 기능을 활성화하면, 동일한 쿼리를 다시 실행할 때 새로 데이터를 조회하지 않고 이전에 저장된 결과를 사용할 수 있습니다. 이를 통해 쿼리 실행 속도를 높이고 데이터 스캔 비용을 절감할 수 있습니다.

쿼리 결과 재사용을 사용하는 방법은 다음과 같습니다.

1. 카카오클라우드 콘솔 > Analytics > Data Query 메뉴로 이동합니다.
2. 쿼리 편집기 화면에서 쿼리 결과 재사용 기능을 설정할 편집기 우측 하단의 쿼리 결과 재사용 : 사용 안 함 버튼을 클릭합니다.
3. 드롭다운에서 아래와 같이 원하는 쿼리 결과 재사용 시간을 선택하여 설정합니다.

설정 옵션	설명
사용 안 함	쿼리 결과 재사용 기능을 사용하지 않음(기본 설정)
1시간 전	최근 1시간 이내의 동일 쿼리 결과를 재사용
12시간 전	최근 12시간 이내의 동일 쿼리 결과를 재사용
24시간 전	최근 24시간 이내의 동일 쿼리 결과를 재사용
사용자 설정	직접 시간(분 or 시 단위)을 입력하여 설정할 수 있음 - 최소 1분 ~ 최대 1440분(24시간)까지 입력 가능

주의

쿼리 결과 재사용 기능이 적용되기 위해 다음 조건을 모두 만족해야 합니다. 아래 조건들 중 하나라도 일치하지 않으면, 저장된 결과 대신 쿼리를 새로 실행합니다.

1. 쿼리를 실행하기 전에 쿼리 결과 재사용 기능을 설정해야 합니다.
2. 쿼리 문자열이 이전 실행과 정확히 일치해야 합니다.
   • 대/소문자, 공백 등이 동일해야 합니다.
   • WHERE, GROUP BY, JOIN 등의 조건절도 동일해야 합니다.
3. 기존 쿼리문에 포함된 Database와 Catalog가 동일해야 합니다.
4. 결과 저장 및 구성 설정이 이전 실행과 동일해야 합니다.
5. 쿼리에서 참조한 모든 테이블에 대한 접근 권한이 있어야 합니다.

3. 쿼리 실행 결과

쿼리 실행 결과에 대한 상세 정보를 제공합니다.

주의

쿼리 실행 결과는 실행 시점으로부터 24시간 이내에만 확인 가능합니다.

쿼리 결과

구분	설명
상태	쿼리 실행 상태(쿼리 상태 정보 상세) - 대기 중, 실행 중, 실행 취소, 성공, 실패 - 쿼리 결과 재사용 기능 사용 시 상태 : 성공 - 쿼리 결과가 재사용됨 으로 표기
재사용 만료 시간	쿼리 결과 재사용 만료 시간 - 쿼리 결과 재사용 기능 활성화 시 제공
대기열 시간	쿼리가 실행되기 전에 대기열에 머무는 시간 - 쿼리가 제출된 시점부터 실제 쿼리가 실행되기 전까지의 시간
쿼리 수행 시간	쿼리가 실제로 실행되어 결과가 생성되는 데 소용된 총 시간
스캔 데이터 크기	쿼리가 실행되면서 읽은 데이터의 총량

결과 상세

구분	항목	설명
기본 정보	결과 상태	쿼리 실행 상태(쿼리 상태 정보 상세) - 대기 중, 실행 중, 실행 취소, 성공, 실패 - 쿼리 결과 재사용 기능 사용 시 상태 : 성공 - 쿼리 결과가 재사용됨 으로 표기
	쿼리 ID	쿼리 실행 시마다 생성되는 쿼리 ID
실행 정보	입력 데이터 수	쿼리 수행을 위해 스캔한 데이터 행 개수
	출력 데이터 수	쿼리 결과 데이터 행 개수
	입력 데이터 크기	쿼리 수행을 위해 스캔한 데이터 크기
	출력 데이터 크기	쿼리 결과 데이터 크기
실행 시간	쿼리 실행 시작 일시	쿼리 수행이 시작된 시간
	쿼리 실행 종료 일시	쿼리 수행이 완료된 시간
	총 실행 시간	쿼리 수행 시간 + 내부 처리 시간의 합
	대기 시간	쿼리 실행 요청되고 실행되기 전까지 대기열에 머무는 시간
	계획 시간	쿼리 계획 시간
	쿼리 수행 시간	쿼리가 실제로 실행되어 결과가 생성되는 데 소용된 총 시간
[실행 구조도] 버튼		버튼 클릭 시 쿼리 이력 상세 페이지 > 실행 구조도 탭으로 이동 - 쿼리 결과 재사용 기능 활성화 시에는 미제공
[쿼리 결과 저장 위치] 버튼		버튼 클릭 시 설정된 Object Storage 버킷의 최종 경로로 이동 - 쿼리 결과 재사용 기능 활성화 시에는 미제공