이 섹션의 다중 페이지 출력 화면임. 여기를 클릭하여 프린트.

Quick Query

1: Overview

2: How-to guides

3: API Reference

4: CLI Reference

5: Release Note

1 - Overview

서비스 개요

Quick Query는 대용량 데이터를 표준 SQL을 사용하여 간편하고 빠르게 분석할 수 있는 대화형 쿼리 서비스입니다. 표준 Kubernetes 클러스터 기반에 자동으로 설치되며, Cloud Hadoop, Object Storage, RDB 등 다양한 데이터 소스에 쉽고 빠르게 접근하여 데이터 조회 및 가공이 가능합니다.

특장점

쉽고 빠른 데이터 조회: Object Storage에 저장된 데이터에 대해 스키마를 정의한 후 표준 SQL을 사용하여 쿼리를 실행하면 쉽고 빠르게 조회가 가능합니다. SQL을 다룰 수 있는 사용자는 전문 분석가가 아니더라도 누구나 손쉽게 대규모 데이터 세트를 분석할 수 있습니다.
신속한 병렬 분산 처리: 병렬 분산 처리가 가능한 Trino 엔진을 사용하여 자동으로 쿼리를 분할하고, 동시에 여러 노드에서 병렬 처리하여 대용량 데이터도 빠르게 쿼리 결과를 확인할 수 있습니다.
다양한 서비스 구조: 공용 고정자원 모드와 공용 자원확장 모드, 그리고 개인용 자원확장 모드를 제공합니다. 공용 고정자원 모드는 대규모 데이터 쿼리에 대한 안정적인 응답 속도를 지원하며, 공용 자원확장 모드는 사용 빈도가 불규칙한 경우 더 저렴한 비용으로 이용할 수 있습니다. 또한 개인용 자원확장 모드는 각 사용자가 독립적인 환경에서 분석 작업을 수행할 수 있도록 지원하여 사용자 요구에 맞는 구조의 Quick Query를 이용할 수 있습니다.

서비스 구성도

제공 기능

Quick Query는 다음과 같은 기능을 제공합니다.

다양한 Data Source의 단일 엑세스 지원 (11종의 Data Source 지원)
결과 데이터에 대한 Object Storage내 자동 저장 기능
동일한 쿼리문에 대한 조회 결과 재사용 기능
Ranger 연동을 통한 접근제어 기능
데이터 사용량 제어 기능

카테고리	타입	비고
Cloud Hadoop	hive_on_cloud_hadoop iceberg_on_cloud_hadoop	Cloud Hadoop의 Hive Metastore 사용
Object Storage	hive_on_object_storage iceberg_on_object_storag	Quick Query에서 Hive Metastore 배포하여 사용
RDB	postgresql mariadb sqlserver oracle mysql	JDBC Driver Upload 필요 (라이선스)
TPCDS	tpcds	Quick Query에서 기본 제공하는 내장 Data Source
TPCH	tpch	Quick Query에서 기본 제공하는 내장 Data Source

표. 지원 Data Source

타입	select	insert	uptate	delete	create	drop	alter	analyze	call
hive_on_cloud_hadoop	O	O	O	O	O	O	O	O	O
iceberg_on_cloud_hadoop	O	O	O	O	O	O	O	O	O
hive_on_object_storage	O	O	O	O	O	O	O	O	O
iceberg_on_object_storage	O	O	O	O	O	O	O	O	O
postgresql	O	O		O	O	O	O
mariadb	O	O		O	O	O	O
sqlserver	O	O		O	O	O	O
greenplum	O	O		O	O	O	O
oracle	O	O		O	O	O	O
mysql	O	O		O	O	O	O
tpcds	O
tpch	O

표. 지원 SQL

구성 요소

쿼리엔진타입: 공용

쿼리엔진은 1개가 기동되면 여러 사용자가 공유하여 사용하는 구조입니다.

고정자원 모드(Auto Scaling 미사용): Auto Scaling을 미사용하는 경우 사용자가 선택한 리소스에 맞춰 고정된 리소스의 쿼리 엔진이 기동됩니다. 쿼리엔진이 항시 동일한 리소스로 실행되어 있는 구조라 동일한 쿼리 성능을 보장해 줄 수 있는 구조입니다.
그림. 고정자원 모드(Auto Scaling 미사용)
자원확장 모드(Auto Scaling 사용): Auto Scaling을 사용하는 경우 쿼리엔진의 Worker 노드가 처리량에 따라 자동으로 Auto Scale in/out 됩니다. 처리량이 적을 경우는 1개까지 Worker 노드가 줄어 들고 처리량이 많아지면 Worker 노드가 늘어납니다. 또한 클러스터 사이즈에 따라 리소스를 조정할 수 있습니다.
그림. 자원확장 모드(Auto Scaling 사용)

쿼리엔진타입: 개인용

자원확장 모드(Auto Scaling 사용): 개인용 쿼리엔진타입은 쿼리엔진이 사용자별로 별도 실행되는 구조입니다. 각 쿼리엔진은 Auto Scale in/out을 지원하며 장기간 미 사용시 엔진은 자동으로 Stop 되는 구조입니다. 다시 사용을 위해 재 접속시 쿼리엔진이 자동으로 다시 실행됩니다. 처리량이 적을 경우는 1개까지 Worker 노드가 줄어 들고 처리량이 많아지면 Worker 노드가 늘어납니다. 또한 클러스터 사이즈에 따라 리소스를 조정할 수 있습니다.
그림. 자원확장 모드(Auto Scaling 사용)

서버 타입

Quick Query에서 지원하는 서버 타입은 다음과 같습니다.

구분	예시	상세 설명
서버 유형	Standard	제공되는 서버 타입 Standard: 일반적으로 사용되는 표준 사양(vCPU, Memory) 구성 High Capacity: 24 Core 이상의 대용량 서버 사양
서버 크기	s1v2m4	제공되는 서버 사양 vCPU 2, Memory 4G

구분

예시

상세 설명

서버 유형

Standard

제공되는 서버 타입

Standard: 일반적으로 사용되는 표준 사양(vCPU, Memory) 구성

High Capacity: 24 Core 이상의 대용량 서버 사양

서버 크기

s1v2m4

제공되는 서버 사양

vCPU 2, Memory 4G

표. Quick Query 지원 서버 타입

Quick Query를 사용하기 위한 최소 사양은 다음과 같습니다.

구분	상세	클러스터 사이즈(사용자 입력 값)	고정 노드풀	자동 확장 노드풀
공용	고정자원 모드(Auto Scaling 미사용)	Replica: 1 CPU: 4 Core Memory: 8GB	8 Core, 16GB * 4	N/A
공용	자원확장 모드(Auto Scaling 사용)	Small(1 Core, 4GB)	8 Core, 16GB * 3	8 Core, 16GB * 1
개인용	자원확장 모드(Auto Scaling 사용)	Small(1 Core, 4GB)	8 Core, 16GB * 3	8 Core, 32GB * 2

표. Quick Query 최소 사양

리전별 제공 현황

Quick Query은 아래의 환경에서 제공 가능합니다.

리전	제공 여부
한국 서부(kr-west1)	제공
한국 동부(kr-east1)	제공
한국 남부1(kr-south1)	미제공
한국 남부2(kr-south2)	미제공
한국 남부3(kr-south3)	미제공

표. Quick Query 리전별 제공 현황

선행 서비스

해당 서비스를 생성하기 전에 미리 구성되어 있어야 하는 서비스 목록입니다. 자세한 내용은 각 서비스 별로 제공되는 가이드를 참고하여 사전에 준비하시기 바랍니다.

서비스 카테고리	서비스	상세 설명
Networking	VPC	클라우드 환경에서 독립된 가상 네트워크를 제공하는 서비스
Networking	Security Group	서버의 트래픽을 제어하는 가상 방화벽
Storage	File Storage	네트워크 연결을 통하여 다수의 클라이언트 서버가 파일을 공유하는 스토리지

표. Quick Query 선행 서비스

2 - How-to guides

사용자는 Samsung Cloud Platform Console을 통해 Quick Query의 필수 정보를 입력하고, 상세 옵션을 선택하여 해당 서비스를 생성할 수 있습니다.

Quick Query 생성하기

Samsung Cloud Platform Console에서 Quick Query 서비스를 생성하여 사용할 수 있습니다.

Quick Query를 생성하려면 다음 절차를 따르세요.

모든 서비스 > Data Analytics > Quick Query 메뉴를 클릭하세요. Quick Query의 Service Home 페이지로 이동합니다.
Service Home 페이지에서 Quick Query 생성 버튼을 클릭하세요. Quick Query 생성 페이지로 이동합니다.

Quick Query 생성 페이지에서 서비스 생성에 필요한 정보들을 입력하고, 상세 옵션을 선택하세요.

버전 선택 영역에서 필요한 정보를 선택하세요.
구분
필수 여부
상세 설명
Quick Query 필수 Quick Query 서비스 버전 선택
제공하는 버전 리스트 제공
표. Quick Query 서비스 버전 선택 항목

구분	필수 여부	상세 설명
Quick Query	필수	Quick Query 서비스 버전 선택 제공하는 버전 리스트 제공

서비스 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

구분	필수 여부	상세 설명
Quick Query명	필수	Quick Query 이름 입력 영문 소문자로 시작하며 특수문자(`-`)로 끝나지 않도록, 소문자, 숫자와 특수문자(`-`)를 사용하여 3 ~ 30자로 입력
설명	선택	Quick Query에 대한 추가 정보나 설명을 150자 이내로 입력
도메인 설정	필수	Quick Query 도메인 입력 영문 소문자로 시작하며 특수문자(`-`, `.`)로 끝나지 않도록, 소문자, 숫자와 특수문자(`-`, `.`)를 사용하여 3 ~ 50자로 입력 {Quick Query명}.{설정한 도메인}이 Quick Query 접속 주소가 됩니다.
쿼리 엔진 타입	필수	쿼리 엔진 타입 선택 공용: 한 개의 쿼리 엔진을 여러 사용자가 공유하여 사용 개인용: 사용자 별로 별도의 엔진 사용
클러스터 사이즈	필수	클러스터 구성을 위한 자원 용량 선택 엔진 타입을 공용으로 선택한 경우 Auto Scaling을 사용으로 선택하면, 클러스터 용량을 Small, Medium, Large, Extra Large 중에 선택할 수 있습니다. Auto Scaling을 사용으로 선택하지 않으면, 클러스터 용량을 Replica, CPU, Memory 입력을 통해 설정할 수 있습니다. 엔진 타입을 개인용으로 선택한 경우 클러스터 용량을 Small, Medium, Large, Extra Large 중에 선택할 수 있습니다. 엔진 용량(Auto Scaling 사용 시) Small: 1Core, 4GB Medium: 4Core, 16GB Large: 8Core, 64GB Extra Large: 16Core, 128GB 엔진 용량(Auto Scaling 미사용 시) Replica: 1 ~ 9 입력 가능, 기본값: 1 CPU: 4 ~ 24 입력 가능 (4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24 입력 가능), 기본값: 4 Memory: 8 ~ 256 입력 가능 (8, 16, 32, 64, 128, 192, 256 입력 가능), 기본값: 8
최대 동시 실행 쿼리 수	필수	Quick Query에서 동시에 실행하려는 최대 쿼리 수 선택 선택 가능 값: 32, 64, 96, 128
Data Service Console 연결	필수	Data Service Console 도메인 입력 영문 소문자로 시작하며 특수문자(`-`, `.`)로 끝나지 않도록, 소문자, 숫자와 특수문자(`-`, `.`)를 사용하여 3 ~ 50자로 입력
Host Alias	선택	Quick Query와 연결될 호스트 정보 추가 (기본 포함 총 20개 생성 가능) 사용을 선택한 후, + 버튼 클릭 Hostname: 호스트명 또는 도메인 형식으로, 소문자, 숫자와 특수문자(`-`, `.`)를 사용하여 3~63자로 입력 IP: IP 형식으로 입력 삭제하려면 X 버튼 클릭 클러스터와 해당 서버와의 방화벽이 오픈되어 있어야 추가한 호스트 정보 사용 가능

표. Quick Query 서비스 정보 입력 항목

클러스터 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

구분	필수 여부	상세 설명
클러스터명	필수	클러스터 이름 입력 영문 소문자로 시작하며 특수문자(`-`)로 끝나지 않도록, 소문자, 숫자와 특수문자(`-`)를 사용하여 3 ~ 30자로 입력
제어영역 설정	필수/선택	Kubernetes 버전: Kubernetes 버전 표시 프로비저닝 이후 Kubernetes 버전을 업그레이드할 수 있습니다. 퍼블릭 엔드포인트 엑세스: 외부에서 Kubernetes API 서버 엔드포인트를 엑세스하도록 설정하려면 사용을 선택한 후, 접근 제어 IP 범위를 입력하세요(서비스 신청 후 변경 불가). 제어영역 로깅: 제어영역 로깅의 사용 여부 선택 사용을 선택하면, Management > Cloud Monitoring > 로그 분석에서 클러스터 제어영역의 Audit/이벤트 로그를 확인할 수 있습니다. 프로젝트 내의 전체 서비스를 대상으로 1GB의 로그 저장은 무료로 제공되며, 1GB를 넘을 경우에는 순차적으로 삭제됩니다.
네트워크 설정	필수	네트워크 연결 설정 VPC: Data Service Console과 동일한 VPC 사용 서브넷: 선택한 VPC의 서브넷 중에서 사용할 항목 선택 Security Group: 검색을 클릭한 후, Security Group 선택 팝업창에서 보안 그룹 선택
File Storage 설정	필수	클러스터에서 사용할 파일 스토리지 볼륨 선택 기본 Volume (NFS): 검색을 클릭한 후, File Storage 선택 팝업창에서 파일 스토리지 선택

표. Quick Query 서비스 클러스터 정보 입력 항목

노드 풀 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

구분	필수 여부	상세 설명
노드 풀 구성	필수/선택	추가할 노드 풀의 상세 정보 입력 * 표시된 항목은 필수 입력 항목 쿼리 엔진 타입이 공용이고 Auto Scaling을 미사용으로 선택한 경우에는, 노드 풀 구성(고정) 항목만 설정할 수 있습니다. Keypair: Virtual Server에 연결할 때 사용하는 증명 방법 선택

표. Quick Query 서비스 노드 풀 정보 입력 항목

추가 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

구분	필수 여부	상세 설명
태그	선택	태그 추가 태그 추가 버튼을 클릭하여 태그를 생성하여 추가하거나 기존 태그 추가 가능 최대 50개까지 태그 추가 가능 추가된 신규 태그는 서비스 생성 완료 후 적용

구분

필수 여부

상세 설명

태그

선택

태그 추가

태그 추가 버튼을 클릭하여 태그를 생성하여 추가하거나 기존 태그 추가 가능

최대 50개까지 태그 추가 가능

추가된 신규 태그는 서비스 생성 완료 후 적용

표. Quick Query 서비스 추가 정보 입력 항목

요약 패널에서 생성한 상세 정보와 예상 청구 금액을 확인하고, 완료 버튼을 클릭하세요.
- 생성이 완료되면, Quick Query 목록 페이지에서 생성한 자원을 확인하세요.

Quick Query 상세 정보 확인하기

Quick Query 서비스의 전체 자원 목록과 상세 정보를 확인하고 수정할 수 있습니다. Quick Query 상세 페이지에서는 상세 정보, 태그, 작업 이력 탭으로 구성되어 있습니다.

Quick Query 서비스의 상세 정보를 확인하려면 다음 절차를 따르세요.

모든 서비스 > Data Analytics > Quick Query 메뉴를 클릭하세요. Quick Query의 Service Home 페이지로 이동합니다.
Service Home 페이지에서 Quick Query 메뉴를 클릭하세요. Quick Query 목록 페이지로 이동합니다.

Quick Query 목록 페이지에서 상세 정보를 확인할 자원을 클릭하세요. Quick Query 상세 페이지로 이동합니다.

Quick Query 상세 페이지 상단에는 상태 정보 및 부가 기능에 대한 정보가 표시됩니다.

구분	상세 설명
상태 표시	사용자가 생성한 Quick Query의 상태 Creating: 생성 중 Running: 생성 완료, 서비스 사용 가능 상태 Updating: 설정 업데이트 중 Terminating: 서비스 해지 중 Error: 생성 중 오류 발생 또는 서비스 이상 상태
Hosts 파일 셋팅 정보	Quick Query와 Data Service Console에 접속하기 위한 호스트 파일 정보를 확인하고 복사하는 버튼
서비스 해지	서비스를 해지하는 버튼

구분

상세 설명

상태 표시

사용자가 생성한 Quick Query의 상태

Creating: 생성 중

Running: 생성 완료, 서비스 사용 가능 상태

Updating: 설정 업데이트 중

Terminating: 서비스 해지 중

Error: 생성 중 오류 발생 또는 서비스 이상 상태

Hosts 파일 셋팅 정보

Quick Query와 Data Service Console에 접속하기 위한 호스트 파일 정보를 확인하고 복사하는 버튼

서비스 해지

서비스를 해지하는 버튼

표. Quick Query 상태 정보 및 부가 기능

상세 정보

Quick Query 목록 페이지에서 선택한 자원의 상세 정보를 확인하고, 필요한 경우 정보를 수정할 수 있습니다.

구분	상세 설명
서비스	서비스명
자원 유형	자원 유형
SRN	Samsung Cloud Platform에서의 고유 자원 ID 클러스터 SRN을 의미
자원명	자원 이름 클러스터명을 의미
자원 ID	서비스에서의 고유 자원 ID
생성자	서비스를 생성한 사용자
생성 일시	서비스를 생성한 일시
수정자	서비스 정보를 수정한 사용자
수정 일시	서비스 정보를 수정한 일시
Quick Query명	Quick Query 이름
설명	Quick Query에 대한 추가 정보나 설명
버전	Quick Query 버전
서비스 유형	Quick Query 서비스 유형
쿼리 엔진 타입	Quick Query 엔진 타입
엔진 Spec	Auto Scaling 사용 여부 클러스터 구성을 위한 자원 용량
최대 동시 실행 쿼리 수	Quick Query에서 동시에 실행하려는 최대 쿼리 수
도메인 설정	Quick Query 도메인
Data Service Console	Data Service Console 도메인
Host Alias	Quick Query와 연결될 호스트 정보
Web URL	Data Service Console과 Quick Query의 웹 URL
클러스터명	서버들이 구성된 클러스터 이름
설치 노드 정보	설치된 노드 풀의 상세 정보

표. Quick Query 상세 정보 탭 항목

구분	상세 설명
태그 목록	태그 목록 태그의 Key, Value 정보 확인 가능 태그는 자원 당 최대 50개까지 추가 가능 태그 입력 시 기존에 생성된 Key와 Value 목록을 검색하여 선택

작업 이력

Quick Query 목록 페이지에서 선택한 자원의 작업 이력을 확인할 수 있습니다.

구분	상세 설명
작업 이력 목록	자원 변경 이력 작업 일시, 자원 유형, 자원명, 작업 내역, 작업 결과, 작업자 정보 확인 가능 작업 이력 목록에서 해당하는 자원을 클릭하세요. 작업 이력 상세 팝업창이 열립니다. 상세 검색 버튼을 통해 상세 검색 기능 제공

구분

상세 설명

작업 이력 목록

자원 변경 이력

작업 일시, 자원 유형, 자원명, 작업 내역, 작업 결과, 작업자 정보 확인 가능

작업 이력 목록에서 해당하는 자원을 클릭하세요. 작업 이력 상세 팝업창이 열립니다.

상세 검색 버튼을 통해 상세 검색 기능 제공

표. Quick Query 작업 이력 탭 상세 정보 항목

Quick Query 접속하기

Quick Query에 접속하려면 다음 절차를 따르세요.

Quick Query에 접속하려는 Windows 시스템(PC)의 IP를 확인하세요.
- 외부 접속이 필요하므로 시스템의 Public IP를 확인해야 합니다.
Quick Query가 설치된 VPC에 IGW 연결이 사용으로 되어있는지 확인하세요.
- 외부에서 접속 시 연결 가능한 Internet Gateway 설정이 되어있어야 합니다.
Windows 시스템의 hosts 파일에 다음 내용을 추가하세요. Quick Query 상세 화면에서 Hosts 파일 세팅정보를 클릭하여 확인할 수 있습니다.
- Data Service Console의 도메인 주소
- Data Service Console IAM의 도메인 주소
- Quick Query의 도메인 주소
Quick Query 서비스 신청 시 선택했던 VPC IGW Firewall에 다음 규칙을 추가하세요.
구분 Protocol Source Target IP Port
Inbound TCP User IP Load Balancer 서비스 IP 80,443
표. VPC IGW Firewall 규칙

구분	Protocol	Source	Target IP	Port
Inbound	TCP	User IP	Load Balancer 서비스 IP	80,443

Quick Query 서비스 신청 시 선택했던 Load Balancer Firewall에 다음 규칙을 추가하세요.

구분	Protocol	Source	Target IP	Port
Outbound	TCP	User IP	Load Balancer 서비스 IP	80,443
Inbound	TCP	Load Balancer의 Source NAT IP	Kubernetes Node Pool의 Subnet 대역	30000-32767
	TCP	Load Balancer의 Health Check IP	Kubernetes Node Pool의 Subnet 대역	30000-32767

표. Load Balancer Firewall 규칙

Quick Query 서비스 신청 시 선택했던 Security Group에 다음 규칙을 추가하세요.
구분 Protocol Target IP Port
Inbound TCP Load Balancer의 Source NAT IP 30000-32767
TCP Load Balancer의 Health Check IP 30000-32767
표. Security Group 규칙
접속하려는 Windows 시스템(PC)에서 Chrome 브라우저를 실행한 후 Quick Query URL에 접속하세요.

구분	Protocol	Target IP	Port
Inbound	TCP	Load Balancer의 Source NAT IP	30000-32767
	TCP	Load Balancer의 Health Check IP	30000-32767

Quick Query 해지하기

사용하지 않는 해당 서비스를 해지하여 운영 비용을 절감할 수 있습니다. 단, 서비스를 해지하면 운영 중인 서비스가 즉시 중단될 수 있으므로 서비스 중단 시 발생하는 영향을 충분히 고려한 후 해지 작업을 진행해야 합니다.

Quick Query를 해지하려면 다음 절차를 따르세요.

모든 서비스 > Data Analytics > Quick Query 메뉴를 클릭하세요. Quick Query의 Service Home 페이지로 이동합니다.
Service Home 페이지에서 Quick Query 메뉴를 클릭하세요. Quick Query 목록 페이지로 이동합니다.
Quick Query 목록 페이지에서 해지할 자원을 선택하고, 서비스 해지 버튼을 클릭하세요.
해지가 완료되면, Quick Query 목록 페이지에서 자원이 해지되었는지 확인하세요.

3 - API Reference

API Reference

4 - CLI Reference

CLI Reference

5 - Release Note

Quick Query

2025.07.01

NEW Quick Query 서비스 정식 버전 출시

대용량 데이터를 표준 SQL을 사용하여 간편하게 분석할 수 있는 Quick Query 서비스가 출시되었습니다.