---
title: "Data Design Parameter ユースケース"
slug: "nimoro-studio-data-manage-data-design-parameter-vpc"
tags: ["Data Manage", "NIMORO Studio", "NIMORO Report", "데이터 디자인", "Data Design"]
updated: 2026-09-17T09:55:41Z
published: 2026-09-17T09:55:41Z
canonical: "guide.ncloud-docs.com/nimoro-studio-data-manage-data-design-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.

# Data Design Parameter ユースケース

**最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。**

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

데이터 디자인(Data Design)을 쿼리로 생성 또는 쿼리 유효성 검사 시 사용할 수 있는 시스템 파라미터를 설명합니다.

## 데이터 유형별 시스템 파라미터

데이터 유형별 시스템 파라미터는 다음과 같습니다.

1. 문자형
  - [@string_{alias}](/docs/ja/nimoro-studio-data-manage-data-design-parameter-vpc#stringalias)
2. 숫자형
  - [@number_{alias}](/docs/ja/nimoro-studio-data-manage-data-design-parameter-vpc#numberalias)
3. 날짜형
  - [@date](/docs/ja/nimoro-studio-data-manage-data-design-parameter-vpc#date)
  - [@startdate ~ @enddate](/docs/ja/nimoro-studio-data-manage-data-design-parameter-vpc#startdateenddate)
  - [@month](/docs/ja/nimoro-studio-data-manage-data-design-parameter-vpc#month)
  - [@startmonth ~ @endmonth](/docs/ja/nimoro-studio-data-manage-data-design-parameter-vpc#startmonthendmonth)
  - [@starttime ~ @endtime](/docs/ja/nimoro-studio-data-manage-data-design-parameter-vpc#starttimeendtime)

## 시스템 파라미터 입력 형식 및 조건

시스템 파라미터의 입력 형식 및 조건은 다음과 같습니다.

- 파라미터 입력 형식
  - 문자형: `@{파라미터 이름}_{별칭(alias)}`
  - 날짜형: `@{파라미터 이름}`
- 조건
  - 날짜형 파라미터(`@date`, `@month` 등)는 별칭(alias)을 입력할 수 없습니다.
  - 별칭(alias)은 한글, 영문, 숫자, 특수 문자 '_'를 사용하여 공백 없이 최대 50자까지 입력할 수 있습니다.
  - 파라미터를 작은따옴표(') 또는 큰따옴표(")로 묶어서 표기할 수 없습니다.

이외 시스템 파라미터에 대한 설명은 다음의 개별 시스템 파라미터를 참조해 주십시오.

## @string_{alias}

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

### 용도

@string_{alias}는 문자 형식의 데이터를 입력받을 때 사용합니다.

- <예시> `@string_gender`

### 조건

@string_{alias}에 대한 설명 및 설정 조건은 다음과 같습니다.

- `@string_`은 필수 접두사이며, 뒤에는 문자 또는 기호를 입력할 수 있습니다.
  - 작은따옴표(') 사용 시 작은따옴표를 하나 더 추가하면 문자열로 사용할 수 있습니다.
    - <예시> `select &apos;Park&apos;&apos;s Query&apos;`
  - 큰따옴표(") 사용 시 작은따옴표로 감싸면 그대로 사용할 수 있습니다.
- IN 절 안에서 여러 문자열을 사용하려는 경우 콤마(,)로 구분합니다.
  - <예시> `&apos;Apple&apos;, &apos;Google&apos;, &apos;Naver&apos;`

### 예시

@string_{alias}의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

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

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

#### 수행 쿼리

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

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

## @number_{alias}

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

### 용도

@number_{alias}는 숫자 형식의 데이터를 입력받을 때 사용합니다.

- <예시> `@number_&#xAD6C;&#xB9E4;&#xD69F;&#xC218;`

### 조건

@number_{alias}에 대한 설명 및 설정 조건은 다음과 같습니다.

- `@number_`은 필수 접두사이며, 뒤에는 문자 또는 숫자, 기호를 입력할 수 있습니다.
- 값으로 숫자형(정수형, Double형)을 입력할 수 있습니다.

### 예시

@number_{alias}의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

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

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

#### 수행 쿼리

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

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

## @date

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

### 용도

@date는 yyyy-MM-dd 형식의 날짜 데이터를 입력받을 때 사용합니다.

- <예시> `2024-11-12`

### 조건

@date에 대한 설명 및 설정 조건은 다음과 같습니다.

- [리포트](/docs/nimoro-studio-report-manage-report-vpc)에서 선택하는 데이트 핸들러(Date Handler) 파라미터와 동일한 파라미터를 사용할 수 있습니다.
  - 데이터 디자인에서 사용한 날짜형 파라미터와 리포트의 데이트 핸들러(Date Handler) 파라미터가 일치하지 않는 경우, 리포트 생성 쿼리가 정상적으로 변환되지 않아 오류가 발생할 수 있습니다.

### 예시

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

#### 작성 쿼리

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

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

#### 수행 쿼리

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

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

## @startdate ~ @enddate

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

### 용도

@startdate ~ @enddate는 기간 형태의 날짜 데이터를 yyyy-MM-dd 형식으로 입력받을 때 사용합니다.

- <예시> `2024-11-01 ~ 2024-11-12`

### 조건

@startdate ~ @enddate에 대한 설명 및 설정 조건은 다음과 같습니다.

- 기간 시작 파라미터인 `@startdate`와 기간 종료 파라미터인 `@enddate`는 쌍으로 같이 사용되어야 합니다.
- [리포트](/docs/nimoro-studio-report-manage-report-vpc)에서 선택하는 데이트 핸들러(Date Handler) 파라미터와 동일한 파라미터를 사용할 수 있습니다.
  - 데이터 디자인에서 사용한 날짜형 파라미터와 리포트의 데이트 핸들러(Date Handler) 파라미터가 일치하지 않는 경우, 리포트 생성 쿼리가 정상적으로 변환되지 않아 오류가 발생할 수 있습니다.

### 예시

@string_{alias}의 작성 쿼리 및 수행 쿼리 예시는 다음과 같습니다.

#### 작성 쿼리

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

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

#### 수행 쿼리

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

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd between '2022-01-01' and '2022-02-28'
```

## @month

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

### 용도

@month는 윌 단위의 날짜 데이터를 yyyy-MM 형식으로 입력받을 때 사용합니다.

- <예시> `2024-11`

### 조건

- [리포트](/docs/nimoro-studio-report-manage-report-vpc)에서 선택하는 데이트 핸들러(Date Handler) 파라미터와 동일한 파라미터를 사용할 수 있습니다.
  - 데이터 디자인에서 사용한 날짜형 파라미터와 리포트의 데이트 핸들러(Date Handler) 파라미터가 일치하지 않는 경우, 리포트 생성 쿼리가 정상적으로 변환되지 않아 오류가 발생할 수 있습니다.

### 예시

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

#### 작성 쿼리

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

```
select *
from nimo__db_id.ns_id_pay_hist
where substr(p_ymd,1,7) = @month
```

#### 수행 쿼리

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

```
select *
from nimo__db_id.ns_id_pay_hist
where substr(p_ymd,1,7) = '2022-01'
```

## @startmonth ~ @endmonth

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

### 용도

@startmonth ~ @endmonth는 기간 형태의 날짜 데이터를 yyyy-MM 형식으로 입력받을 때 사용합니다.

- <예시> `2024-01 ~ 2024-11`

### 조건

- 기간 시작 파라미터인 `@startmonth`와 기간 종료 파라미터인 `@endmonth`는 쌍으로 같이 사용되어야 합니다.
- [리포트](/docs/nimoro-studio-report-manage-report-vpc)에서 선택하는 데이트 핸들러(Date Handler) 파라미터와 동일한 파라미터를 사용할 수 있습니다.
  - 데이터 디자인에서 사용한 날짜형 파라미터와 리포트의 데이트 핸들러(Date Handler) 파라미터가 일치하지 않는 경우, 리포트 생성 쿼리가 정상적으로 변환되지 않아 오류가 발생할 수 있습니다.

### 예시

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

#### 작성 쿼리

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

```
select *
from nimo__db_id.ns_id_pay_hist
where substr(p_ymd,1,7) = @month
```

#### 수행 쿼리

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

```
select *
from nimo__db_id.ns_id_pay_hist
where substr(p_ymd,1,7) = '2022-01'
```

## @starttime ~ @endtime

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

### 용도

@starttime ~ @endtime는 기간 형태의 날짜 및 시간 데이터를 yyyy-MM-dd HH:mm:ss 형식으로 입력받을 때 사용합니다.

- <예시> `2024-11-01 12:00:05 ~ 2024-11-12 23:59:59`

### 조건

- 기간 시작 파라미터인 `@starttime`와 기간 종료 파라미터인 `@endtime`은 쌍으로 같이 사용되어야 합니다.
- [리포트](/docs/nimoro-studio-report-manage-report-vpc)에서 선택하는 데이트 핸들러(Date Handler) 파라미터와 동일한 파라미터를 사용할 수 있습니다.
  - 데이터 디자인에서 사용한 날짜형 파라미터와 리포트의 데이트 핸들러(Date Handler) 파라미터가 일치하지 않는 경우, 리포트 생성 쿼리가 정상적으로 변환되지 않아 오류가 발생할 수 있습니다.

### 예시

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

#### 작성 쿼리

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

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

#### 수행 쿼리

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

```
select *
from nimo__db_id.ns_id_pay_hist
where p_ymd = '2022-01-01'
and cast(base_dt as varchar) between '2022-01-01 09:00:00' and '2022-01-01 10:59:59'
```