Data Design Parameter 사용 예제

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

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

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

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

1. 문자형

   • @string_{alias}

2. 숫자형

   • @number_{alias}

3. 날짜형

   • @date
   • @startdate ~ @enddate
   • @month
   • @startmonth ~ @endmonth
   • @starttime ~ @endtime

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

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

• 파라미터 입력 형식

  • 문자형: @{파라미터 이름}_{별칭(alias)}
  • 날짜형: @{파라미터 이름}

• 조건

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

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

@string_{alias}

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

용도

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

• <예시> @string_gender

조건

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

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

예시

@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_구매횟수

조건

@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에 대한 설명 및 설정 조건은 다음과 같습니다.

• 리포트에서 선택하는 데이트 핸들러(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는 쌍으로 같이 사용되어야 합니다.
• 리포트에서 선택하는 데이트 핸들러(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

조건

• 리포트에서 선택하는 데이트 핸들러(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는 쌍으로 같이 사용되어야 합니다.
• 리포트에서 선택하는 데이트 핸들러(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은 쌍으로 같이 사용되어야 합니다.
• 리포트에서 선택하는 데이트 핸들러(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'