VPC 환경에서 이용 가능합니다.
UI 기반으로 데이터를 추출할 수 있는 위저드(Wizard)를 생성하고 관리하는 방법을 설명합니다. 위저드 파라미터(Wizard Parameter)를 활용해 데이터 추출을 위한 쿼리문을 작성하고, 이를 표현할 수 있도록 설정할 수 있습니다.
Wizard 화면
Wizard 화면은 다음과 같이 구성되어 있습니다.

| 영역 | 설명 |
|---|---|
| ① 메뉴 영역 | 현재 확인 중인 메뉴 이름 및 설명 |
| ② 검색 필터 | 위저드 이름 또는 설명으로 검색하여 필터링
|
| ③ ADD WIZARD | 클릭 시 위저드 생성 |
| ④ 위저드 목록 | 전체 위저드 목록 조회
|
| ⑤ 추가 기능 |
위저드 생성
위저드를 생성하는 방법은 다음과 같습니다.
- NIMORO 플랫폼에 접속해 주십시오.(NIMORO 플랫폼 접속 참조)
- NIMORO Studio 화면이 나타나면 Wizard Manage > Wizard 메뉴를 차례대로 클릭해 주십시오.
- [ADD WIZARD] 버튼을 클릭해 주십시오.
- 다음 단계를 차례대로 진행해 주십시오.
1. 위저드 기본 정보 입력(Edit Wizard Info)
위저드에 대한 기본 정보를 입력한 후 [SAVE] 버튼을 클릭해 주십시오.
- Wizard Name: 생성할 위저드 이름 입력
- Descriptions: 생성할 위저드 설명 입력
- Wizard Annotation: 생성할 위저드 주석 입력
- 리포트의 타이틀 하단과 About This Report에 노출됩니다.
- Related Link: 생성할 위저드와 연관된 리포트, 위저드, 샘플 쿼리 또는 외부 링크 설정
- Update History: 위저드 내용 변경 이력 확인
- Created: 위저드 생성 일시(yyyy-mm-dd hh:mm) 및 사용자 이름
- Last Edited: 위저드 마지막 수정 일시(yyyy-mm-dd hh:mm) 및 사용자 이름
- Last Deployed: 위저드 마지막 배포 일시(yyyy-mm-dd hh:mm) 및 사용자 이름
2. 위저드 쿼리 작성(Make Query)
위저드에 적용할 쿼리를 작성한 후 [SAVE] 버튼을 클릭해 주십시오.
- 위저드 정보: 현재 위저드 정보 조회
- 위저드 이름
- Created: 위저드 생성 일시(yyyy-mm-dd hh:mm) 및 사용자 이름
- Last Edited: 위저드 마지막 수정 일시(yyyy-mm-dd hh:mm) 및 사용자 이름
- Last Deployed: 위저드 마지막 배포 일시(yyyy-mm-dd hh:mm) 및 사용자 이름
- Descriptions: 위저드 설명
- Connector 선택: 드롭다운에서 위저드 결과 조회 시 사용할 커넥터(Connector)와 위저드를 실행할 검색 엔진 선택
- 쿼리 엔진은 선택한 커넥터에서 지원하는 것으로 설정됩니다.
- Trino
- Hive
- Query 작성
- Query 입력: 위저드의 조회 데이터 결과 추출 쿼리 작성
- 위저드의 조회 결과로 확인할 항목은
SELECT에서 모두 작성되어야 합니다. - 파라미터로 설정한 항목은 위저드에서 조회 조건으로 설정하여 데이터를 불러올 수 있습니다.
- 쿼리 작성 시 사용 가능한 위저드 파라미터에 대한 자세한 내용은 조회 조건 위저드 파라미터를 참조해 주십시오.
- 동일한 파라미터를 2개 이상 사용하려면 파라미터 뒤에 시퀀스 번호를 붙여 순서를 지정합니다.
- <예시> @code1, @code2
- 위저드의 조회 결과로 확인할 항목은
- Query 입력: 위저드의 조회 데이터 결과 추출 쿼리 작성
- Count Check Query: 결과 값 개수를 셀 수 있는 기능 활성화 여부
- 스위치를 활성화할 경우 쿼리 결과를 조회하기 전 결과 값 개수를 먼저 확인할 수 있습니다.
조회 조건 위저드 파라미터
위저드 쿼리 작성 시 조회 조건으로 사용 가능한 위저드 파라미터에 대한 설명은 다음과 같습니다.
위저드 파라미터에 대한 자세한 내용은 Wizard Parameter 사용 예제 를 참조해 주십시오.
| 파라미터 종류 | 파라미터 이름 | 설명 |
|---|---|---|
| 데이터 | @string |
문자열 입력 |
| 데이터 | @int |
정수형 숫자 데이터 입력
|
| 데이터 | @double |
실수형(소수점 포함) 숫자 데이터 입력
|
| 데이터 | @date |
특정 날짜(yyyy-mm-dd) 선택
|
| 데이터 | @month |
특정 월 선택(yyyy-mm) |
| 데이터 | @startint ~ @endint |
정수형 숫자 데이터를 범위 형태로 입력 |
| 데이터 | @startdouble ~ @enddouble |
실수형 숫자 데이터를 범위 형태로 입력 |
| 데이터 | @startdate ~ @enddate |
일자(yyyy-mm-dd) 형태 기간 선택 |
| 데이터 | @startmonth ~ @endmonth |
월(yyyy-mm) 형태 기간 선택 |
| 데이터 | @starttime ~ @endtime |
일시(yyyy-mm-dd hh:mm:ss) 형태 기간 선택 |
| 조건 | @yn |
데이터가 Y 또는 N일 경우 선택 |
| 조건 | @>< |
부등호로 값의 크고 작음 등을 조건으로 설정할 수 있는 데이터인 경우 선택 |
| 조건 | @code |
|
| 조건 | @custom |
코드 데이터 직접 입력 |
| 조건 | @like |
입력값을 포함하는 조건의 데이터 조회 |
| 조건 | @casewhen ~ @casegroupby |
특정 컬럼을 임의의 구간으로 그루핑
|
| 조건 | @serviceid |
사용 중인 서비스 ID 입력 |
| On/Off | @-- |
쿼리문의 특정 행 선택적 주석 처리 |
| On/Off | @opt |
opt 중 단일 선택하여 선택한 하나의 행을 해제하고 이외의 모든 행을 주석 처리하거나, 또는 다중 선택하여 선택한 행을 해제하고 이외의 모든 행을 주석 처리
|
| On/Off | @param-- |
|
| On/OFf | @selectparam-- |
|
| From | @uploadtable |
로컬 파일 업로드 후 연계 데이터 조회
|
| 정렬 | @order |
데이터 정렬 방식 조회
|
3. 위저드 파라미터 세부 설정(Set Parameter)
사용 가능한 모든 위저드 파라미터의 세부 설정이 완료되어 목록에
로 표시되면 [SAVE] 버튼을 클릭해 주십시오.
- 서비스 정보: 현재 서비스 정보 조회
- Created: 서비스 생성 일시(yyyy-mm-dd hh:mm) 및 사용자 이름
- Last Edited: 마지막 수정 일시(yyyy-mm-dd hh:mm) 및 사용자 이름
- Last Deployed: 마지막 배포 일시(yyyy-mm-dd hh:mm) 및 사용자 이름
- Descriptions: 서비스 설명
- Query 확인: 작성한 쿼리 내용 확인
- Parameter List: 쿼리에서 사용한 전체 위저드 파라미터 목록
- [Add Section] 버튼: 클릭하여 파라미터 사이에 섹션 영역 추가. 파라미터를 그룹별로 구분 가능
- 세부 설정 전에는
로 표시, 설정이 완료되면
로 표시
- Set Parameter
-
@string
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 입력 가능한 String 길이: 입력 가능한 텍스트 길이 설정
- 값을 입력하지 않으면 1000자로 설정
- 사용자 안내 문구: 컴포넌트 내에 표시할 안내 문구를 작성
- Preview Component Type: 인풋박스(Input box) 유형의 UI만 지원
-
@int
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 입력 가능한 숫자 범위: 최소 값(Min) / 최대 값(Max) 입력
- 값을 입력하지 않으면
Min=0,Max=제한 없음으로 설정
- 값을 입력하지 않으면
- Preview Component Type: 인풋박스(Input box) 유형의 UI만 지원
-
@double
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 입력 가능한 숫자 범위: 최소 값(Min) / 최대 값(Max) 입력
- 값을 입력하지 않으면
Min=0,Max=제한 없음으로 설정
- 값을 입력하지 않으면
- Preview Component Type: 인풋박스(Input box) 유형의 UI만 지원
-
@date
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 선택 가능한 날짜 범위
- From: 조회 가능한 최초 일자
- To: 현재 날짜로부터 며칠 전까지 선택 가능하도록 할지 입력
- Default 날짜 설정: Wizard 화면에 초기 표시되는 일자 설정
- 선택 가능한 날짜 범위 To에 설정한 값에 따라 선택할 수 있는 Default 날짜 옵션이 달라짐
- 선택 가능한 날짜 범위 To에
지난 달또는1이상의 값을 입력한 경우 Default 날짜 설정은이번 달과 그 이전 월 중에 선택 가능
- Select Component Type
- 숫자 입력과 캘린더 제공
- 숫자 입력만 제공
-
@month
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 선택 가능한 날짜 범위
- From: 조회 가능한 최초 월
- To: 현재 기준의 월로부터 몇 개월 전까지 선택 가능하도록 할지 입력
- Default 날짜 설정: Wizard 화면에 초기 표시되는 기간 설정
- 사용자가 설정 가능한 최대 날짜 범위: 위저드(Wizard)에서 한 번에 설정 가능한 최대 기간의 범위 설정
- Select Component Type
- 숫자 입력과 캘린더 제공
- 숫자 입력만 제공
-
@startint ~ @endint
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 입력 가능한 숫자 범위: 최소 값(Min) / 최대 값(Max) 입력
- 값을 입력하지 않으면
Min=0,Max=제한 없음으로 설정
- 값을 입력하지 않으면
- Preview Component Type: 인풋박스(Input box) 유형의 UI만 지원
-
@startdouble ~ @enddouble
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 입력 가능한 숫자 범위: 최소 값(Min) / 최대 값(Max) 입력
- 값을 입력하지 않으면
Min=0,Max=제한 없음으로 설정
- 값을 입력하지 않으면
- Preview Component Type: 인풋박스(Input box) 유형의 UI만 지원
-
@startdate ~ @enddate
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 선택 가능한 날짜 범위
- 데이터가 존재하는 날짜 범위로, 사용자는 설정한 범위 내에서 날짜 변경 가능
- From: 조회 가능한 최초 일자
- To: 현재 날짜로부터 며칠 전까지 선택 가능하도록 할지 입력
- Default 날짜 설정: Wizard 화면에 초기 표시되는 일자 설정
- 선택 가능한 날짜 범위 To에 설정한 값에 따라 선택할 수 있는 Default 날짜 옵션이 달라짐
- 선택 가능한 날짜 범위 To에
오늘또는1이상의 값을 입력한 경우 Default 날짜 설정은오늘과 그 이전 날짜 중에 선택 - From: 시작일은 To 날짜로부터 계산
- To: 선택 가능한 날짜 범위가 2 이상이면 해당 값으로 Default 날짜가 설정
- 사용자가 설정 가능한 최대 날짜 범위: Wizard 화면에서 사용자가 한 번에 설정 가능한 최대 기간의 범위 설정
- Select Component Type
- 숫자 입력과 캘린더 제공
- 숫자 입력만 제공
-
@startmonth ~ @endmonth
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 선택 가능한 날짜 범위
- From: 조회 가능한 최초 월
- To: 현재 기준의 월로부터 몇 개월 전까지 선택 가능하도록 할지 입력
- Default 날짜 설정: Wizard 화면에 초기 표시되는 기간 설정
- 사용자가 설정 가능한 최대 날짜 범위: 위저드(Wizard)에서 한 번에 설정 가능한 최대 기간의 범위 설정
- Select Component Type
- 숫자 입력과 캘린더 제공
- 숫자 입력만 제공
-
@starttime ~ @endtime
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 선택 가능한 날짜 범위
- From: 조회 가능한 최초 일시
- To: 현재 날짜로부터 몇 시간 전까지 선택 가능하도록 할지 입력
- Default 날짜 설정: Wizard 화면에 초기 표시되는 기간 설정
- 사용자가 설정 가능한 최대 날짜 범위: 위저드(Wizard)에서 한 번에 설정 가능한 최대 기간의 범위 설정
- Select Component Type
- 숫자 입력과 캘린더 제공
- 숫자 입력만 제공
-
@yn
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 선택 옵션 이름 표시: All(Yes, No), Yes, No 조건이 Wizard 화면에서 표시될 이름 설정
- Preview Component Type: 라디오 버튼(Radio button) 유형의 UI만 지원
-
@><
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 부등호 조건을 함께 사용할 Parameter 선택
- Wizard 화면에 표시될 때 선택한 파라미터의 조건 입력폼 앞에 부등호 옵션이 표시됨
- 선택 옵션 이름 표시: 부등호가 Wizard 화면에서 표시될 이름과 초기 표시되는 부등호 설정
- Preview Component Type: 목록 내의 단일 선택 유형의 UI만 지원
-
@code
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 사용할 Code Group 선택
- NIMO Studio > Data Manage > Code Group에서 선언한 코드 테이블 중 선택
- 코드 그룹 조회 조건: Service Manager의 Service ID가 허용된 경우 조회 가능
- 사용할 Custom Code Column 선택
- Join Key 컬럼: 실제 쿼리에 입력되어 수행될 컬럼
- 코드 이름 컬럼(Code Name Column): Wizard 화면에 표시될 컬럼
- Selected Component Type
- 한 개의 Code 선택: 코드 단일 선택형
- 여러 개의 Code 선택 가능 : 코드 다중 선택형
-
@custom
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 선택 옵션 표시 이름
- Option: 실제 쿼리에 입력되어 수행될 데이터
- Option Name: Wizard 화면에 표시될 데이터
: 옵션 삭제
* 옵션 목록을 일괄 삭제하려는 경우 컬럼 헤더에 있는
DEL All을 클릭
- Selected Component Type
- 옵션 1개만 선택
- 여러 개 옵션 선택
-
@like
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 사용자 안내 문구: 컴포넌트 내에 표시할 안내 문구를 작성
- 엔터(Enter) 키 입력으로 줄바꿈 가능
- Preview Component Type: 인풋박스(Input box) 유형의 UI만 지원
-
@casewhen ~ @casegroupby
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 사용할 구간 옵션 선택
- 구간 자동 분할: 설정 범위 내에서 자동으로 구간 분할
- 구간 사용자 설정: 사용자가 설정한 임의 구간으로 분할
- 부등호 옵션 표시 이름
- 구간에 사용될 부등호가 Wizard 화면에 표시될 이름과 초기 표시될 부등호 설정
- 조회 범위: 사용자가 설정 가능한 구간 범위 설정
- 분할 단위: 자동 분할 단위 설정(기본값: 자동 분할)
- 기본값(Default): 자동 분할
- 숫자만 입력 가능하며, 조회 범위 최대 값 이하로 설정
- 조회 범위: 사용자가 설정 가능한 구간 범위 설정
- Selected Component Type: 구간 자동 분할, 구간 사용자 설정에 따른 단일 UI만 지원
-
@--
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 선택 옵션 표시 이름: Wizard 화면에 표시될 이름과 초기 선택값 설정
- Preview Component Type: 라디오 버튼(Radio button) 유형의 UI만 지원
-
@opt
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 사용 방식 선택: 단일 또는 다중 선택 중 옵션을 선택하는 방식 설정
- 선택 옵션 표시 이름: Wizard 화면에 표시될 이름과 초기 선택값 설정
- Preview Component Type: 라디오 버튼(Radio button), 체크박스(Check Box) 유형의 UI만 지원
-
@param--
- 주석 처리할 파라미터 선택: 주석 처리를 온/오프(On/Off)할 파라미터 표시
- 선택된 파라미터를 변경하려면 쿼리 수정 필요
- 지정된 파라미터는 쿼리문의 주석 안에 포함되어, Wizard 화면에서 사용자가 조회 조건에 추가선택 시에만 입력폼이 활성화
- Preview Component Type: 온/오프(On/Off) 스위치 지원
- 주석 처리할 파라미터 선택: 주석 처리를 온/오프(On/Off)할 파라미터 표시
-
@selectparam--
- 조건 입력 방식으로 사용할 Parameter 선택: 조건 입력 방식으로 사용할 파라미터 선택
- 선택된 파라미터를 변경하려면 쿼리 수정 필요
- 선택된 파라미터는 Wizard 화면에서 사용자의 선택 옵션으로 제공되며, 옵션명은 각 파라미터의 조건명이 표시
- Wizard 화면에서 사용자가 선택한 파라미터는 쿼리문의 주석 처리에서 제외되며, 그 외 파라미터는 주석 안에 포함됨
- Preview Component Type: 라디오 버튼(Radio Button), 인풋박스(Input Box) 등 관련 UI 지원
- 조건 입력 방식으로 사용할 Parameter 선택: 조건 입력 방식으로 사용할 파라미터 선택
-
@uploadtable
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- Uploadtable DB Name: 파일 업로드 시 사용할 HDFS 커넥터 및 테이블을 생성할 데이터베이스 지정
- HDFS Connector: 등록한 HDFS 커넥터 중 하나를 선택
- Uploadtable DB Name
- 선택한 HDFS 커넥터 내에 존재하는 데이터베이스를 선택(해당 데이터베이스의 경로(Path)를 활용하기 위함)
- Sample File: 위저드에서 제공할 파일의 샘플 업로드
- 파라미터를 입력할 때 사용한 컬럼 리스트가 파일의 header(헤더)로 포함되어야 함
- 파일 형식: 100 MB 이하의 TSV, CSV
- 파일명: 영문, 숫자, 언더스코어(_)만 사용 가능
- 사용자 안내 문구: 컴포넌트 내에 표시할 안내 문구를 작성
- Preview Component Type: 파일 업로드 형태의 단일 UI 지원
참고- 네이버 데이터 분석 서비스(Cloud Data Box) 사용 시 지원하지 않는 옵션입니다.
- 업로드 가능한 데이터베이스(Uploadtable DB)는 각 서비스의 서비스매니저가 NIMORO에 연동을 위해 생성한 HDFS 커넥터에 해당하는 클러스터에 별도의 데이터베이스로써 준비되어야 합니다. 그리고 NIMORO 시스템에서 해당 데이터베이스에 업로드 테이블(Upload Table)을 물리적으로 저장할 수 있도록, NIMORO 시스템에 해당 경로에 대해 충분한 데이터 권한이 주어져야 합니다.
-
@order
- 조건명 입력: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력
- 정렬 옵션 표시 이름: 정렬 옵션이 Wizard 화면에 표시될 이름과 초기 정렬 설정
- Option: 정렬 옵션 선택
- Asc: 오름차순
- Desc: 내림차순
- Option Name: Wizard 화면에 표시될 옵션 이름
- Option: 정렬 옵션 선택
- Preview Component Type: 라디오 버튼(Radio button) 유형의 UI만 지원
-
4. 위저드 미리보기 및 배포(Preview & Deploy)
생성할 위저드에서 작성한 쿼리를 확인하고, 미리보기하여 조회한 후 [DEPLOY] 버튼을 클릭하여 배포합니다.
단, 위저드 배포는 쿼리 체크(Query Check) 시 실행 쿼리가 유효하고, 샘플 데이터(Sample Data)가 1건 이상일 때만 가능합니다.
- 작성한 Query 확인: 2. 위저드 쿼리 작성(Make Query)의 쿼리와 파라미터 확인
- Preview & Query Check: 위저드가 설정한 옵션에 맞게 조회되는지 실행 조건을 채운 후 쿼리 유효성 검증 실행
- 활성화하지 않은 조건은 쿼리 유효성이 검증되지 않아 위저드 실행 시 오류가 발생할 수 있습니다.
- 언어 탭: 언어별 위저드 생성 과정 확인 (현재 한국어만 지원)
- KR: 한국어
- EN: 영어
- JP: 일본어
- CN: 중국어
- Reset: 클릭하여 쿼리 유효성 검증 데이터 초기화
- [Query Check] 버튼: 클릭하여 쿼리 유효성 검증 실행
- Query Check Results
- 실행 Query 확인: 쿼리 유효성 검증 결과 확인
- Sample Data: 샘플 데이터 확인
- 마지막 배포 버전 내용 확인: 클릭하여 직전 버전 위저드 상세 정보 조회 표시/숨기기(토글)
위저드 수정
위저드 정보를 수정하는 방법은 다음과 같습니다
- NIMORO 플랫폼에 접속해 주십시오.(NIMORO 플랫폼 접속 참조)
- 좌측 메뉴에서
(NIMORO Studio)을 클릭해 주십시오. - Wizard Manage > Wizard 메뉴를 차례대로 클릭해 주십시오.
- 수정하려는 위저드 항목과 단계를 클릭해 주십시오.
- 정보를 수정해 주십시오.
- 수정 단계에 따라 [Save and Go to NEXT], [GO TO STEP 4] 또는 [DEPLOY] 버튼을 클릭해 주십시오.
위저드 복제
위저드를 복제하는 방법은 다음과 같습니다.
- NIMORO 플랫폼에 접속해 주십시오.(NIMORO 플랫폼 접속 참조)
- 좌측 메뉴에서
(NIMORO Studio)을 클릭해 주십시오. - Wizard Manage > Wizard 메뉴를 차례대로 클릭해 주십시오.
>
Duplicate를 차례대로 클릭해 주십시오.
위저드 삭제
위저드를 삭제하는 방법은 다음과 같습니다.
NIMORO Wizard 서비스 메뉴에 연결되어 배포 중인 라이브(LIVE) 상태의 위저드는 삭제할 수 없습니다. 먼저 NIMORO Wizard 서비스 메뉴에서 해당 위저드의 연결을 해제해 주십시오. 자세한 내용은 Service Menu를 참조해 주십시오.
- NIMORO 플랫폼에 접속해 주십시오.(NIMORO 플랫폼 접속 참조)
- 좌측 메뉴에서
(NIMORO Studio)을 클릭해 주십시오. - Wizard Manage > Wizard 메뉴를 차례대로 클릭해 주십시오.
>
Delete를 차례대로 클릭해 주십시오.- 안내 문구 확인 후 [예, 삭제합니다.] 버튼을 클릭해 주십시오.
: 클릭 시