The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.
VPC 환경에서 이용 가능합니다.
데이터 디자인(Data Design)을 쿼리로 생성 또는 쿼리 유효성 검사 시 사용할 수 있는 시스템 파라미터를 설명합니다.
데이터 유형별 시스템 파라미터
데이터 유형별 시스템 파라미터는 다음과 같습니다.
-
문자형
-
숫자형
-
날짜형
시스템 파라미터 입력 형식 및 조건
시스템 파라미터의 입력 형식 및 조건은 다음과 같습니다.
-
파라미터 입력 형식
- 문자형:
@{파라미터 이름}_{별칭(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'