--- title: "Wizard" slug: "nimoro-studio-wizard-manage-wizard-vpc" tags: ["nimoro", "NIMORO Studio", "wizard", "마법사 관리", "Wizard Manage", "wizard parameter"] updated: 2026-09-17T09:29:55Z published: 2026-09-17T09:29:55Z canonical: "guide.ncloud-docs.com/nimoro-studio-wizard-manage-wizard-vpc" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Wizard **最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。** VPC 환경에서 이용 가능합니다. UI 기반으로 데이터를 추출할 수 있는 위저드(Wizard)를 생성하고 관리하는 방법을 설명합니다. 위저드 파라미터(Wizard Parameter)를 활용해 데이터 추출을 위한 쿼리문을 작성하고, 이를 표현할 수 있도록 설정할 수 있습니다. ## Wizard 화면 Wizard 화면은 다음과 같이 구성되어 있습니다. ![nimoro-studio-wizard_manage-wizard-vpc_screen_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/nimoro-studio-wizard_manage-wizard-vpc_screen_ko.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D) | 영역 | 설명 | | --- | --- | | ① 메뉴 영역 | 현재 확인 중인 메뉴 이름 및 설명 | | ② 검색 필터 | 위저드 이름 또는 설명으로 검색하여 필터링 - **LIVE만 보기** 체크 박스 클릭 시 NIMORO Wizard 메뉴의 배포 버전에 연결된 위저드만 조회 | | ③ **ADD WIZARD** | 클릭 시 [위저드 생성](/docs/ja/nimoro-studio-wizard-manage-wizard-vpc#%EC%9C%84%EC%A0%80%EB%93%9C%EC%83%9D%EC%84%B1) | | ④ 위저드 목록 | 전체 위저드 목록 조회 - **ID**: 위저드 목록 번호 - **Wizard Name**: 위저드 이름 - **Descriptions**: 위저드 설명 - **Last Edited**: 마지막 수정 일시(yyyy-mm-dd hh:mm:ss) 및 사용자 이름 - **Last Deployed**: 마지막 배포 일시(yyyy-mm-dd hh:mm:ss) 및 사용자 이름 - **Status**: 현재 위저드 편집 및 배포 상태 - **Step 1 Editing**~**Step5 Editing**: 단계별로 위저드 편집 중인 상태 - **Deployed**: 위저드가 배포 완료된 상태 | | ⑤ 추가 기능 | - ![i-nimoro_edit](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_edit.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D): 클릭 시 [위저드 수정](/docs/ja/nimoro-studio-wizard-manage-wizard-vpc#%EC%9C%84%EC%A0%80%EB%93%9C%EC%88%98%EC%A0%95) 가능 - ![i-nimoro_more](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_more.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D): 클릭 시 [위저드 복제](/docs/ja/nimoro-studio-wizard-manage-wizard-vpc#%EC%9C%84%EC%A0%80%EB%93%9C%EB%B3%B5%EC%A0%9C) 또는 [위저드 삭제](/docs/ja/nimoro-studio-wizard-manage-wizard-vpc#%EC%9C%84%EC%A0%80%EB%93%9C%EC%82%AD%EC%A0%9C) 가능 | ## 위저드 생성 위저드를 생성하는 방법은 다음과 같습니다. 1. NIMORO 플랫폼에 접속해 주십시오.([NIMORO 플랫폼 접속](/docs/nimoro-access-vpc#NIMORO%ED%94%8C%EB%9E%AB%ED%8F%BC%EC%A0%91%EC%86%8D) 참조) 2. NIMORO Studio 화면이 나타나면 **Wizard Manage > Wizard** 메뉴를 차례대로 클릭해 주십시오. 3. **[ADD WIZARD]** 버튼을 클릭해 주십시오. 4. 다음 단계를 차례대로 진행해 주십시오. - [1. 위저드 기본 정보 입력(Edit Wizard Info)](/docs/ja/nimoro-studio-wizard-manage-wizard-vpc#1%EC%9C%84%EC%A0%80%EB%93%9C%EA%B8%B0%EB%B3%B8%EC%A0%95%EB%B3%B4%EC%9E%85%EB%A0%A5EditWizardInfo) - [2. 위저드 쿼리 작성(Make Query)](/docs/ja/nimoro-studio-wizard-manage-wizard-vpc#2%EC%9C%84%EC%A0%80%EB%93%9C%EC%BF%BC%EB%A6%AC%EC%9E%91%EC%84%B1MakeQuery) - [3. 위저드 파라미터 세부 설정(Set Parameter)](/docs/ja/nimoro-studio-wizard-manage-wizard-vpc#3%EC%9C%84%EC%A0%80%EB%93%9C%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0%EC%84%B8%EB%B6%80%EC%84%A4%EC%A0%95SetParameter) - [4. 위저드 미리보기 및 배포(Preview & Deploy)](/docs/ja/nimoro-studio-wizard-manage-wizard-vpc#4%EC%9C%84%EC%A0%80%EB%93%9C%EB%AF%B8%EB%A6%AC%EB%B3%B4%EA%B8%B0%EB%B0%8F%EB%B0%B0%ED%8F%ACPreviewDeploy) ### 1. 위저드 기본 정보 입력(Edit Wizard Info) 위저드에 대한 기본 정보를 입력한 후 **[SAVE]** 버튼을 클릭해 주십시오. - **Wizard Name**: 생성할 위저드 이름 입력 - **Descriptions**: 생성할 위저드 설명 입력 - **Wizard Annotation**: 생성할 위저드 주석 입력 - 리포트의 타이틀 하단과 **About This Report**에 노출됩니다. - **Related Link**: 생성할 위저드와 연관된 리포트, 위저드, 샘플 쿼리 또는 외부 링크 설정 - **No**: 링크 목록 번호 - **Type**: 연관 링크 유형 - **Report**: 연결할 [리포트](/docs/nimoro-studio-report-manage-report-vpc) 선택 - **Wizard**: 연결할 [위저드](/docs/nimoro-studio-wizard-manage-wizard-vpc) 선택 - **웹 링크**: 연결할 URL 입력 - **Sample Query**: 연결할 [샘플 쿼리](/docs/nimoro-studio-probe-manage-sample-query-vpc) 선택 - **Text**: 링크 제공 시 표시될 문구 입력 - **Link** 리포트 연결 링크 선택 - ![i-nimoro_delete](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_delete.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D): 연관 링크 삭제 - 연관 링크 목록을 일괄 삭제하려는 경우 컬럼 헤더에 있는 **![i-nimoro_delete](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_delete.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D) DEL All**을 클릭해 주십시오. - **[Add 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`에서 모두 작성되어야 합니다. - 파라미터로 설정한 항목은 위저드에서 조회 조건으로 설정하여 데이터를 불러올 수 있습니다. - 쿼리 작성 시 사용 가능한 위저드 파라미터에 대한 자세한 내용은 [조회 조건 위저드 파라미터](/docs/ja/nimoro-studio-wizard-manage-wizard-vpc#%EC%A1%B0%ED%9A%8C%EC%A1%B0%EA%B1%B4%EC%9C%84%EC%A0%80%EB%93%9C%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)를 참조해 주십시오. - 동일한 파라미터를 2개 이상 사용하려면 파라미터 뒤에 시퀀스 번호를 붙여 순서를 지정합니다. - <예시> @code1, @code2 - **Count Check Query**: 결과 값 개수를 셀 수 있는 기능 활성화 여부 - 스위치를 활성화할 경우 쿼리 결과를 조회하기 전 결과 값 개수를 먼저 확인할 수 있습니다. #### 조회 조건 위저드 파라미터 위저드 쿼리 작성 시 조회 조건으로 사용 가능한 위저드 파라미터에 대한 설명은 다음과 같습니다. 위저드 파라미터에 대한 자세한 내용은 [Wizard Parameter 사용 예제](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc) 를 참조해 주십시오. | 파라미터 종류 | 파라미터 이름 | 설명 | | --- | --- | --- | | 데이터 | `@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` | 특정 컬럼을 임의의 구간으로 그루핑 - 단독 사용 또는 `@casegroupby`와 함께 사용 가능 - `@casegroupby`: `@casewhen`을 통해 그루핑한 값을 기준으로 재집계 | | 조건 | `@serviceid` | 사용 중인 서비스 ID 입력 | | On/Off | `@--` | 쿼리문의 특정 행 선택적 주석 처리 | | On/Off | `@opt` | opt 중 단일 선택하여 선택한 하나의 행을 해제하고 이외의 모든 행을 주석 처리하거나, 또는 다중 선택하여 선택한 행을 해제하고 이외의 모든 행을 주석 처리 - 파라미터에 영어 대소문자(a~z, A~Z)를 구분하여 다양한 케이스로 적용 가능 - <예시> `@opta--`, `@optb--`, `@optc–`, `@optA--` 등 | | On/Off | `@param--` | - 조회 조건으로 사용되는 파라미터 활성화 또는 비활성화 처리 - 관련 파라미터 값이 포함된 쿼리 내 행을 주석 처리 후 사용 가능 | | On/OFf | `@selectparam--` | - 조회 조건 파라미터 그룹 중 1개 선택 - 관련 파라미터 값이 포함된 쿼리 내 행을 주석 처리 후 사용 가능 | | From | `@uploadtable` | 로컬 파일 업로드 후 연계 데이터 조회 - 네이버 데이터 분석 서비스(Cloud Data Box) 사용 시 미지원 | | 정렬 | `@order` | 데이터 정렬 방식 조회 - 오름차순 - 내림차순 | ### 3. 위저드 파라미터 세부 설정(Set Parameter) 사용 가능한 모든 위저드 파라미터의 세부 설정이 완료되어 목록에 ![i-nimoro_after](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_after.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D)로 표시되면 **[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]** 버튼: 클릭하여 파라미터 사이에 섹션 영역 추가. 파라미터를 그룹별로 구분 가능 - 세부 설정 전에는 ![i-nimoro_before](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_before.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D)로 표시, 설정이 완료되면 ![i-nimoro_after](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_after.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D)로 표시 - **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 화면에 표시될 데이터 - ![i-nimoro_delete](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_delete.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D): 옵션 삭제 * 옵션 목록을 일괄 삭제하려는 경우 컬럼 헤더에 있는 **![i-nimoro_delete](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_delete.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D) 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) 스위치 지원 - **@selectparam--** - **조건 입력 방식으로 사용할 Parameter 선택**: 조건 입력 방식으로 사용할 파라미터 선택 - 선택된 파라미터를 변경하려면 쿼리 수정 필요 - 선택된 파라미터는 Wizard 화면에서 사용자의 선택 옵션으로 제공되며, 옵션명은 각 파라미터의 조건명이 표시 - Wizard 화면에서 사용자가 선택한 파라미터는 쿼리문의 주석 처리에서 제외되며, 그 외 파라미터는 주석 안에 포함됨 - **Preview Component Type**: 라디오 버튼(Radio Button), 인풋박스(Input Box) 등 관련 UI 지원 - **@uploadtable** 참고 - 네이버 데이터 분석 서비스(Cloud Data Box) 사용 시 지원하지 않는 옵션입니다. - 업로드 가능한 데이터베이스(Uploadtable DB)는 각 서비스의 서비스매니저가 NIMORO에 연동을 위해 생성한 HDFS 커넥터에 해당하는 클러스터에 별도의 데이터베이스로써 준비되어야 합니다. 그리고 NIMORO 시스템에서 해당 데이터베이스에 업로드 테이블(Upload Table)을 물리적으로 저장할 수 있도록, NIMORO 시스템에 해당 경로에 대해 충분한 데이터 권한이 주어져야 합니다. - **조건명 입력**: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력 - **Uploadtable DB Name**: 파일 업로드 시 사용할 HDFS 커넥터 및 테이블을 생성할 데이터베이스 지정 - **HDFS Connector**: 등록한 HDFS 커넥터 중 하나를 선택 - **Uploadtable DB Name** - 선택한 HDFS 커넥터 내에 존재하는 데이터베이스를 선택(해당 데이터베이스의 경로(Path)를 활용하기 위함) - **Sample File**: 위저드에서 제공할 파일의 샘플 업로드 - 파라미터를 입력할 때 사용한 컬럼 리스트가 파일의 header(헤더)로 포함되어야 함 - 파일 형식: 100 MB 이하의 TSV, CSV - 파일명: 영문, 숫자, 언더스코어(_)만 사용 가능 - **사용자 안내 문구**: 컴포넌트 내에 표시할 안내 문구를 작성 - **Preview Component Type**: 파일 업로드 형태의 단일 UI 지원 - **@order** - **조건명 입력**: Wizard 화면에 표시될 해당 파라미터의 조건 이름 입력 - **정렬 옵션 표시 이름**: 정렬 옵션이 Wizard 화면에 표시될 이름과 초기 정렬 설정 - **Option**: 정렬 옵션 선택 - **Asc**: 오름차순 - **Desc**: 내림차순 - **Option Name**: Wizard 화면에 표시될 옵션 이름 - **Preview Component Type**: 라디오 버튼(Radio button) 유형의 UI만 지원 ### 4. 위저드 미리보기 및 배포(Preview & Deploy) 생성할 위저드에서 작성한 쿼리를 확인하고, 미리보기하여 조회한 후 **[DEPLOY]** 버튼을 클릭하여 배포합니다. 단, 위저드 배포는 쿼리 체크(Query Check) 시 실행 쿼리가 유효하고, 샘플 데이터(Sample Data)가 1건 이상일 때만 가능합니다. - **작성한 Query 확인**: [2. 위저드 쿼리 작성(Make Query)](/docs/ja/nimoro-studio-wizard-manage-wizard-vpc#2%EC%9C%84%EC%A0%80%EB%93%9C%EC%BF%BC%EB%A6%AC%EC%9E%91%EC%84%B1MakeQuery)의 쿼리와 파라미터 확인 - **Preview & Query Check**: 위저드가 설정한 옵션에 맞게 조회되는지 실행 조건을 채운 후 쿼리 유효성 검증 실행 - 활성화하지 않은 조건은 쿼리 유효성이 검증되지 않아 위저드 실행 시 오류가 발생할 수 있습니다. - 언어 탭: 언어별 위저드 생성 과정 확인 (현재 한국어만 지원) - **KR**: 한국어 - **EN**: 영어 - **JP**: 일본어 - **CN**: 중국어 - **Reset**: 클릭하여 쿼리 유효성 검증 데이터 초기화 - **[Query Check]** 버튼: 클릭하여 쿼리 유효성 검증 실행 - **Query Check Results** - **실행 Query 확인**: 쿼리 유효성 검증 결과 확인 - **Sample Data**: 샘플 데이터 확인 - **마지막 배포 버전 내용 확인**: 클릭하여 직전 버전 위저드 상세 정보 조회 표시/숨기기(토글) ## 위저드 수정 위저드 정보를 수정하는 방법은 다음과 같습니다 1. NIMORO 플랫폼에 접속해 주십시오.([NIMORO 플랫폼 접속](/docs/nimoro-access-vpc#NIMORO%ED%94%8C%EB%9E%AB%ED%8F%BC%EC%A0%91%EC%86%8D) 참조) 2. 좌측 메뉴에서 ![i-nimoro_studio](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_studio.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D)(NIMORO Studio)을 클릭해 주십시오. 3. **Wizard Manage > Wizard** 메뉴를 차례대로 클릭해 주십시오. 4. 수정하려는 위저드 항목과 단계를 클릭해 주십시오. 5. 정보를 수정해 주십시오. 6. 수정 단계에 따라 **[Save and Go to NEXT]**, **[GO TO STEP 4]** 또는 **[DEPLOY]** 버튼을 클릭해 주십시오. ## 위저드 복제 위저드를 복제하는 방법은 다음과 같습니다. 1. NIMORO 플랫폼에 접속해 주십시오.([NIMORO 플랫폼 접속](/docs/nimoro-access-vpc#NIMORO%ED%94%8C%EB%9E%AB%ED%8F%BC%EC%A0%91%EC%86%8D) 참조) 2. 좌측 메뉴에서 ![i-nimoro_studio](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_studio.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D)(NIMORO Studio)을 클릭해 주십시오. 3. **Wizard Manage > Wizard** 메뉴를 차례대로 클릭해 주십시오. 4. **![i-nimoro_more](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_more.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D) > ![i-nimoro_duplicate](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_duplicate.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D) Duplicate**를 차례대로 클릭해 주십시오. ## 위저드 삭제 위저드를 삭제하는 방법은 다음과 같습니다. 참고 NIMORO Wizard 서비스 메뉴에 연결되어 배포 중인 라이브(LIVE) 상태의 위저드는 삭제할 수 없습니다. 먼저 NIMORO Wizard 서비스 메뉴에서 해당 위저드의 연결을 해제해 주십시오. 자세한 내용은 [Service Menu](/docs/nimoro-studio-menu-manage-service-menu-vpc)를 참조해 주십시오. 1. NIMORO 플랫폼에 접속해 주십시오.([NIMORO 플랫폼 접속](/docs/nimoro-access-vpc#NIMORO%ED%94%8C%EB%9E%AB%ED%8F%BC%EC%A0%91%EC%86%8D) 참조) 2. 좌측 메뉴에서 ![i-nimoro_studio](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_studio.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D)(NIMORO Studio)을 클릭해 주십시오. 3. **Wizard Manage > Wizard** 메뉴를 차례대로 클릭해 주십시오. 4. **![i-nimoro_more](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_more.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D) > ![i-nimoro_delete](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-nimoro_delete.png?sv=2026-02-06&spr=https&st=2026-10-26T17%3A11%3A30Z&se=2026-10-26T18%3A11%3A30Z&sr=c&sp=r&sig=7oLXosdrat6EJblJYMtqAZHBR45J47jNGCUmttNr%2B4U%3D) Delete**를 차례대로 클릭해 주십시오. 5. 안내 문구 확인 후 **[예, 삭제합니다.]** 버튼을 클릭해 주십시오.