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

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 목록 페이지에서 자원이 해지되었는지 확인하세요.