Wizard Parameter 사용 예제

Prev Next

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

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

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

유형별 위저드 파라미터

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

  1. 데이터 유형(Data Type)

  2. 조건 유형(Condition Type)

  3. 온/오프 유형(On/Off Type)

  4. 프롬 유형(From Type)

  5. 정렬 유형(Sort Type)

@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'

@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

@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

@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'

@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'

@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

@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

@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'

@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'

@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)

@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')

@><

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

용도

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

예시

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

작성 쿼리

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

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

@code

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

용도

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

  • <예시> 연령대, 카테고리, 디바이스 유형 등
  • NIMORO Studio의 Data Manage > Code Group 메뉴에서 생성한 코드 그룹(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')

@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')

@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')
      

@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'

@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

@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

@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