쿼리 편집기

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

쿼리 편집기 화면

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
쿼리 결과 탭	쿼리 결과 정보를 제공
결과 상세 탭	쿼리 결과에 대한 상세 정보를 제공
[쿼리 실행] 버튼	쿼리 실행 후 [쿼리 재실행]으로 변경 ⚠️ 쿼리 결과 저장 위치를 설정해야 활성화됩니다.
[실행 중지] 버튼	쿼리 실행 중 실행을 중지할 수 있음 ⚠️ 이미 실행이 완료된 쿼리에 중지 요청 시 중단이 실패할 수 있습니다.

3. 쿼리 실행 결과

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

주의

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

쿼리 결과

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

결과 상세

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