---
title: "Wizard Parameter 사용 예제"
slug: "nimoro-studio-wizard-manage-wizard-parameter-vpc"
tags: ["Wizard Manage", "NIMORO Wizard ", "wizard", "NIMORO", "마법사 관리"]
updated: 2026-09-17T09:07:29Z
published: 2026-09-17T09:07:29Z
canonical: "guide.ncloud-docs.com/nimoro-studio-wizard-manage-wizard-parameter-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 Parameter 사용 예제

VPC 환경에서 이용 가능합니다.

NIMORO Studio에서 위저드(Wizard) 개발 시 사용할 수 있는 위저드 파라미터를 설명합니다.

## 유형별 위저드 파라미터

유형별 위저드 파라미터는 다음과 같습니다.

1. 데이터 유형(Data Type)
  - [@string](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#string)
  - [@int](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#int)
  - [@double](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#double)
  - [@date](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#date)
  - [@month](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#month)
  - [@startint ~ @endint](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#startintendint)
  - [@startdouble ~ @enddouble](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#startdoubleenddouble)
  - [@startdate ~ @enddate](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#startdateenddate)
  - [@startmonth ~ @endmonth](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#startmonthendmonth)
  - [@starttime ~ @endtime](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#starttimeendtime)
2. 조건 유형(Condition Type)
  - [@yn](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#yn)
  - [@><](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#inequality)
  - [@code](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#code)
  - [@custom](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#custom)
  - [@like](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#like)
  - [@casewhen ~ @casegroupby](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#casewhencasegroupby)
  - [@serviceid](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#serviceid)
3. 온/오프 유형(On/Off Type)
  - [@--](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#onoff)
  - [@opt](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#opt)
  - [@param--](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#param)
  - [@selectparam--](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#selectparam)
4. 프롬 유형(From Type)
  - [@uploadtable](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#uploadtable)
5. 정렬 유형(Sort Type)
  - [@order](/docs/nimoro-studio-wizard-manage-wizard-parameter-vpc#order)

## @string

@string 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@string은 데이터 조회 조건으로써, 문자열 값을 입력합니다.

### 예시

@string의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and gen_cd = @string
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and gen_cd = 'F'
```

#### string Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 입력 가능한 String 길이
  - MAX
- 사용자 안내 문구
  - 자율 기재
- Preview Component Type
  - Input box 타입의 UI만 지원

## @int

@int 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@int는 주로 @>< 파라미터와 함께 쓰여 정수형 숫자 데이터를 입력합니다.

### 예시

@int의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_amt = @int
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_amt = 15000
```

#### int Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 입력 가능한 숫자 범위
  - MAX
  - MIN
- Preview Component Type
  - Input box 타입의 UI만 지원

## @double

@double 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@double은 주로 @>< 파라미터와 함께 쓰여 실수형(소수점 포함) 숫자 데이터를 입력합니다.

### 예시

@double의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_amt = @double
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_amt = 15000.12
```

#### double Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 입력 가능한 숫자 범위
  - MAX
  - MIN
- Preview Component Type
  - Input box 타입의 UI만 지원

## @date

@date 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@date는 특정 일자(yyyyMMdd)를 선택하여 조회 조건으로 활용합니다.

### 예시

@date의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = @date
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
```

#### date Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 입력 가능한 날짜 범위
  - From : 조회 가능한 최초 일자
  - To : 현재 날짜로부터 며칠 전까지 선택 가능하게 할지 입력
- Preview Component Type
  - Input box 타입의 UI만 지원

## @month

@month 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@month는 특정 월(yyyyMM)을 선택하여 조회 조건으로 활용합니다.

### 예시

@month의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_chnl_mm01
where p_ym = @month
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_chnl_mm01
where p_ym = '2021-11'
```

#### month Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 입력 가능한 날짜 범위
  - From : 조회 가능한 최초 일자
  - To : 현재 날짜로부터 며칠 전까지 선택 가능하게 할지 입력
- Default 날짜 설정
  - Front에 초기 노출되는 월 설정
- Preview Component Type
  - Input box 타입의 UI만 지원

## @startint ~ @endint

@startint ~ @endint 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@startint ~ @endint는 정수형 숫자 데이터를 범위 형태로 입력받아, 조회 조건으로 활용합니다.

- @startint ~ @endint는 페어형(Pair Type) 파라미터로 묶어서 한 번에 어드민(Admin) 설정으로 진행됨

### 예시

@startint ~ @endint의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_amt between @startint and @endint
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_amt between 1000 and 100000
```

#### startint~endint Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 입력 가능한 숫자 범위
  - MAX
  - MIN
- Preview Component Type
  - Input box 타입의 UI만 지원

## @startdouble ~ @enddouble

@startdouble ~ @enddouble 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@startdouble ~ @enddouble은 실수형 숫자 데이터를 범위 형태로 입력받아, 조회 조건으로 활용합니다.

- @startdouble~@enddouble는 페어형(Pair Type) 파라미터로 묶어서 한 번에 어드민(Admin) 설정으로 진행됨

### 예시

@startdouble ~ @enddouble의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_amt between @startdouble and @enddouble
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_amt between 1000.12 and 100000.34
```

#### startdouble~enddouble Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 입력 가능한 숫자 범위
  - MAX
  - MIN
- Preview Component Type
  - Input box 타입의 UI만 지원

## @startdate ~ @enddate

@startdate ~ @enddate 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@startdate ~ @enddate는 일자(yyyyMMdd) 형태의 기간을 선택하여 조회 조건으로 활용합니다.

- @startdate ~ @enddate는 페어형(Pair Type) 파라미터로 묶어서 한 번에 어드민(Admin) 설정으로 진행됨

### 예시

@startdate ~ @enddate의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd between @startdate and @enddate
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_chnl_mm01
where p_ym between '2021-10-01' and '2021-11-30'
```

#### startdate~enddate Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 선택 가능한 날짜 범위
  - From : 조회 가능한 최초 일자
  - To : 현재 날짜로부터 며칠 전까지 선택 가능하게 할지 입력
- Default 날짜 설정
  - Front에 초기 노출되는 월 설정
- 사용자가 설정가능한 최대 날짜 범위
  - Wizard 에서 한 번에 설정 가능한 최대 기간의 범위 설정
- Preview Component Type
  - Input box 타입의 UI만 지원

## @startmonth ~ @endmonth

@startmonth ~ @endmonth 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@startmonth ~ @endmonth는 월(yyyyMM) 형태의 기간을 선택하여 조회 조건으로 활용합니다.

- @startmonth ~ @endmonth는 페어형(Pair Type) 파라미터로 묶어서 한 번에 어드민(Admin) 설정으로 진행됨

### 예시

@startmonth ~ @endmonth의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_chnl_mm01
where p_ym between @startmonth and @endmonth
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_chnl_mm01
where p_ym between '2021-10' and '2021-11'
```

#### startmonth~endmonth Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 선택 가능한 날짜 범위
  - From : 조회 가능한 최초 일자
  - To : 현재 날짜로부터 며칠 전까지 선택 가능하게 할지 입력
- Default 날짜 설정
  - Front에 초기 노출되는 월 설정
- 사용자가 설정가능한 최대 날짜 범위
  - Wizard 에서 한 번에 설정 가능한 최대 기간의 범위 설정
- Select Component Type
  - 숫자 입력과 캘린더 제공
  - 숫자 입력만 제공

## @starttime ~ @endtime

@starttime ~ @endtime 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@starttime ~ @endtime은 일시(yyyyMMdd HH:mm:ss) 형태의 기간을 선택하여 조회 조건으로 활용합니다.

- @starttime ~ @endtime은 페어형(Pair Type) 파라미터로 묶어서 한 번에 어드민(Admin) 설정으로 진행됨

### 예시

@starttime ~ @endtime의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and ord_dt between cast(@starttime as timestamp) and cast(@endtime as timestamp)
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and ord_dt between cast('2022-01-01 18:01:01' as timestamp) and cast('2022-01-01 18:50:01' as timestamp)
```

#### starttime~endtime Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 선택 가능한 날짜 범위
  - From : 조회 가능한 최초 일자
  - To : 현재 날짜로부터 며칠 전까지 선택 가능하게 할지 입력
- Default 시간 설정
  - Front에 초기 노출되는 월 설정
- 사용자가 설정가능한 최대 날짜 범위
  - Wizard 에서 한 번에 설정 가능한 최대 기간의 범위 설정
- Select Component Type
  - 숫자 입력과 캘린더 제공
  - 숫자 입력만 제공

## @yn

@yn 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@yn은 데이터가 Y 또는 N인 경우 선택하여 조회 조건으로 활용합니다.

### 예시

@yn의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and (case when tday_dpt_yn = true then 'Y' else 'N' end) in (@yn)
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and (case when tday_dpt_yn = true then 'Y' else 'N' end) in ('Y') -- ('Y', 'N')
```

#### yn Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 선택 옵션 표시 이름
  - All(Y, N), Y, N 조건이 front에서 표시될 이름 설정
- Preview Component Type
  - Input box 타입의 UI만 지원

## @><

@>< 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@><은 부등호가 적용될 수 있는 유관 파라미터 값에 대해 크고 작음 혹은 이상 이하 조건을 받아 필터로 삽입합니다.

### 예시

@><의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_amt @>< @int
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_amt > 100000
```

#### >< Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 부등호 조건을 함께 사용할 Parameter 선택
- 선택 옵션 표시 이름
  - 부동호가 front에서 노출된 이름과 초기 노출되는 부등호 설정
- Preview Component Type
  - 목록 내의 단일 선택 타입 UI만 지원

## @code

@code 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@code는 특정 테이블의 컬럼 내에서 사용하는 코드 데이터를 조건으로 선택합니다.

- <예시> 연령대, 카테고리, 디바이스 유형 등
- NIMORO Studio의 [Data Manage > Code Group](/docs/nimoro-studio-data-manage-code-group-vpc) 메뉴에서 생성한 코드 그룹(Code Group)을 활용하여 위저드 필터로 삽입합니다.

### 예시

@code의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and gen_cd in (@code) -- = @code
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and gen_cd in ('F','M')
```

#### code Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 사용할 Code Group 선택
  - NIMORO Studio > Data Manage > Code Group 에서 선언한 Code 테이블 중 선택
- 사용할 Custom Code Column 선택
  - Join Key Column : 실제 Query에 입력되어 수행될 Column
  - Code Name Column : front 에서 노출될 Column
- Selected Component Type
  - 한 개의 Code 선택 : Code 단일 선택형
  - 여러 개의 Code 선택 가능 : Code 다중 선택형

## @custom

@custom 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@custom은 특정 테이블의 컬럼 데이터가 아닌 직접 입력한 코드 데이터를 조건으로 선택하여 조회 조건으로 활용합니다.

### 예시

@custom의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and gen_cd in (@custom)
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and gen_cd in ('F')
```

#### custom Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 선택 옵션 표시 이름
  - Option : 실제 Query에 입력되어 수행될 데이터
  - Option Name : front에서 노출될 데이터
- Selected Component Type
  - 옵션 1개만 선택
  - 여러 개 옵션 선택

## @like

@like 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@like는 입력값을 포함하는 조건의 데이터를 조회합니다.

### 예시

@like의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_device_cd @like
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

- 선택지를 활용하는 경우

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and gen_cd in ('F')
```

- 정규표현식을 직접 입력하는 경우
  - Trino 엔진일 때

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and regexp_like(pay_device_cd, 'PC|MOBI')
```
  - hive 엔진일 때

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and pay_device_cd rlike('PC|MOBI')
```

#### like Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 사용자 안내 문구
  - 자율 기재
- Preview Component Type
  - Input box 타입의 UI만

## @casewhen ~ @casegroupby

@casewhen ~ @casegroupby 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@casewhen ~ @casegroupby는 특정 컬럼을 임의 구간으로 그루핑하여 활용하거나 그루핑한 값을 기준으로 재집계합니다.

- @casewhen: 특정 컬럼을 임의 구간으로 그룹핑하여 활용
  - 단독 사용 또는 @casegroupby와 함께 사용 가능
- @casegroupby: @casewhen을 통해 그룹핑한 값을 기준으로 재집계
  - @casegroupby은 @casewhen과 반드시 함께 사용
    - @casewhen과 쌍(Pair)으로 설정됨

### 예시

@casewhen ~ @casegroupby의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

- 쌍(pair)으로 사용하는 경우

```
/* Query */
select @casewhen pay_amt as " "
    , count(prod_ord_no) as " "
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2023-01-01'
group by @casegroupby
```

- @casewhen만 사용하는 경우

```
/* Query */
select svc_user_id as " ID"
    , prod_ord_no as " "
    , pay_amt as ""
    , @casewhen pay_amt as " "
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2023-01-01'
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

- 쌍(pair)으로 사용하는 경우

```
/* Query */
select case when (pay_amt >= 0 and pay_amt < 10000) then '001 (0 ~ 10000)'
        when (pay_amt >= 10000 and pay_amt < 20000) then '002 (10000 ~ 20000)'
        when (pay_amt >= 20000 and pay_amt < 30000) then '003 (20000 ~ 30000)'
        else 'Unknown' end as " "
    , count(prod_ord_no) as " "
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2023-01-01'
group by case when (pay_amt >= 0 and pay_amt < 10000) then '001 (0 ~ 10000)'
        when (pay_amt >= 10000 and pay_amt < 20000) then '002 (10000 ~ 20000)'
        when (pay_amt >= 20000 and pay_amt < 30000) then '003 (20000 ~ 30000)'
        else 'Unknown' end
```

- @casewhen만 사용하는 경우

```
/* Query */
select svc_user_id as " ID"
    , prod_ord_no as " "
    , pay_amt as ""
    , case when (pay_amt >= 0 and pay_amt < 10000) then '001 (0 ~ 10000)'
        when (pay_amt >= 10000 and pay_amt < 20000) then '002 (10000 ~ 20000)'
        when (pay_amt >= 20000 and pay_amt < 30000) then '003 (20000 ~ 30000)'
        else 'Unknown' end as " "
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2023-01-01'
```

#### casewhen~casegroupby Parameter 설정가이드

- 조건명 입력
  - front 에서 노출될 해당 파라미터의 조건 이름 입력
- 사용할 구간 옵션 선택
  - 구간 자동 분할 : 설정 범위 내에서 자동으로 구간 분할
  - 구간 사용자 설정 : 사용자가 설정한 임의 구간으로 분할
- 부등호 옵션 표시 이름
  - 구간에 사용될 부등호가 front에서 노출될 이름과 초기 노출되는 부등호 설정
- 자동 분할 단위 설정
  - 자동 분할 단위 Default
  - 자동 분할 단위 최소값
- 사용자가 설정 가능한 구간 범위
  - 구간 자동 분할 조회 범위 Max : 분할하는 구간의 최대값 설정
  - 구간 사용자 설정 범위 Min : 조회 범위의 최솟값
  - 구간 사용자 설정 범위 Max : 조회 범위의 최댓값
- Preview Component Type
  - 구간 자동 분할, 구간 사용자 설정에 따른 단일 UI만 지원

## @serviceid

@serviceid 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@serviceid는 분석 콘텐츠 사용 시 선택한 서비스 ID를 입력값으로 받기 사용합니다.

- 구독형 서비스를 제공하는 경우, 서비스별로 다른 데이터를 제공하기 위해 테이블 내 서비스별 데이터를 적재할 수 있습니다. 그때, 구독받은 서비스 ID를 기반으로 필터링할 수 있도록 하는 기능을 제공합니다.

### 예시

@serviceid의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
/* Query */
select column as ''
from table
where service_id = @serviceid
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
/* Query */
select column as ''
from table
where service_id = 'INTRODUCE'
```

## @--

@-- 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@--는 쿼리(Query) 문의 특정 행을 선택적으로 주석 처리합니다.

### 예시

@--의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select service_id
@--    , p_ymd
    , sum(pay_amt)
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
group by service_id
@--        , p_ymd -- group by, order by
order by service_id
@--        , p_ymd
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select service_id
--    , p_ymd
    , sum(pay_amt)
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
group by service_id
--        , p_ymd
order by service_id
--        , p_ymd
```

#### -- Parameter 설정가이드

- 조건명 입력
  - front에서 노출될 해당 파라미터의 조건 이름 입력
- 선택 옵션 표시 이름
  - front에서 노출된 이름과 초기 선택값 설정
- Preview Component Type
  - Radio button 타입의 UI만 지원

## @opt

@opt 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@opt는 opt 중 단일 선택하여 선택한 하나의 행을 해제하고 이외의 모든 행을 주석 처리하거나, 또는 다중 선택하여 선택한 행을 해제하고 이외의 모든 행을 주석 처리합니다.

- 파라미터에 영어 대소문자(a~z, A~Z)를 구분하여 다양한 케이스로 적용할 수 있습니다.
  - <예시> @opta--, @optb--, @optc–, @optA--, @optB--, ...

### 예시

@opt의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select service_id
@opta--     , p_ymd
@optb--     , gen_cd
    , sum(pay_amt)
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
group by service_id
@opta--     , p_ymd -- group by, order by
@optb--     , gen_cd
order by service_id
@opta--     , p_ymd
@optb--     , gen_cd
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
# opta
select service_id
    , p_ymd
--     , gen_cd
    , sum(pay_amt)
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
group by service_id
    , p_ymd
--     , gen_cd
order by service_id
    , p_ymd
--     , gen_cd
```

```
#
select service_id
--     , p_ymd
--     , gen_cd
    , sum(pay_amt)
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
group by service_id
--     , p_ymd
--     , gen_cd
order by service_id
--     , p_ymd
--     , gen_cd
```

#### opt Parameter 설정가이드

- 조건명 입력
  - front에서 노출될 해당 파라미터의 조건 이름 입력
- 사용 방식 선택
  - 단일 또는 다중 선택 중 옵션을 선택하는 방식 설정
- 선택 옵션 표시 이름
  - front에서 노출된 이름과 초기 선택값 설정
- Preview Component Type
  - Radio button 타입의 UI만 지원

## @param--

@param-- 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@param--는 조회 조건으로 사용되는 파라미터를 온/오프(on/off)합니다. 대상 유관 파라미터 값이 포함된 쿼리 내의 행을 주석 처리하여 사용할 수 있습니다.

### 예시

@param--의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
@param--     and gen_cd in (@custom)
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
--     and gen_cd in ('F')
```

## @selectparam--

@selectparam-- 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@selectparam--는 조회 조건으로 사용되는 파라미터 그룹 중 한 가지를 선택하게 합니다. 대상 유관 파라미터 값이 포함된 쿼리 내의 행을 주석 처리하여 사용할 수 있습니다.

### 예시

@selectparam--의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
@selectparama--    and gen_cd in (@custom)
@selectparamb--    and prod_qty >= @int
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
    and gen_cd in ('F')
--  and prod_qty >= 100
```

## @uploadtable

@uploadtable 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@uploadtable는 로컬 파일을 업로드하여 연계된 데이터 조회를 수행합니다.

          
          

@uploadtable 활용 시 다음 사항을 유의해 주십시오.

- 네이버 데이터 분석 서비스(Cloud Data Box) 사용 시 지원하지 않는 옵션입니다.
- @uploadtable 내 컬럼 목록의 순서와 샘플 파일의 컬럼 순서는 맞지 않아도 됩니다.
- @uploadtable에는 항상 별칭(alias) 지정이 필요합니다.
- 업로드 가능한 데이터베이스(Uploadtable DB)는 각 서비스의 서비스매니저가 NIMORO에 연동을 위해 생성한 HDFS 커넥터에 해당하는 클러스터에 별도의 데이터베이스로써 준비되어야 합니다. 그리고 NIMORO 시스템에서 해당 데이터베이스에 업로드 테이블(Upload Table)을 물리적으로 저장할 수 있도록, NIMORO 시스템에 해당 경로에 대해 충분한 데이터 권한이 주어져야 합니다.

### 예시

@uploadtable의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

- 작성 형식: @uploadtable(컬럼리스트)
- <예시> @uploadtable(c1, c2, c3)

```
select *
from nimo__db_id.ns_id_pay_hist pay
join @uploadtable(acnt_id, acnt_name) upload
on pay.acnt_id = upload.acnt_id
where p_ymd = '2022-01-01'
group by 1,2
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist pay
join wizard_db.sample_table_name upload
on pay.acnt_id = upload.acnt_id
where p_ymd = '2022-01-01'
group by 1,2
```

## @order

@order 파라미터에 대한 설명과 예시는 다음과 같습니다.

### 용도

@order는 오름차순, 내림차순 지정하여 데이터를 정렬/조회합니다.

### 예시

@order의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

작성 쿼리 예시는 다음과 같습니다.

          참고

          

Hive를 통해 order by가 포함된 쿼리로 데이터를 조회할 때는 반드시 limit과 함께 사용해야 합니다. 따라서, Hive 커넥터를 선택하고 위저드 쿼리에서 @order 파라미터 사용 시에는 limit을 반드시 함께 작성해 주십시오.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
order by 1 @order
```

#### 수행 쿼리

작성 쿼리에 대한 수행 쿼리 예시는 다음과 같습니다.

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
order by 1 asc -- desc
```

#### order Parameter 설정가이드

- 조건명 입력
  - front에서 노출될 해당 파라미터의 조건 이름 입력
- 정렬 옵션 표시 이름
  - 정렬 옵션이 front에서 노출될 이름과 초기 노출되는 정렬 설정
- Preview Component Type
  - Radio button 타입의 UI만 지원