데이터세트 파라미터를 사용자 지정 SQL에 삽입

SQL 문에서 <<$parameter_name>>을(를) 참조하여 직접 쿼리 모드에서 데이터 세트의 사용자 지정 SQL에 데이터 세트 파라미터를 삽입할 수 있습니다. 런타임 시 대시보드 사용자는 데이터 세트 파라미터와 연결된 필터 제어 값을 입력할 수 있습니다. 그러면 값이 SQL 쿼리로 전파된 후 대시보드 시각적 객체에서 결과를 확인할 수 있습니다. 파라미터를 사용하여 where 조항에 대한 고객 입력을 기반으로 기본 필터를 만들 수 있습니다. case when 또는 if else절을 추가하여 파라미터 입력에 따라 SQL 쿼리의 로직을 동적으로 변경할 수 있습니다.

예를 들어 최종 사용자의 리전 이름을 기준으로 데이터를 필터링하는 WHERE절을 사용자 지정 SQL에 추가한다고 가정해 보겠습니다. 이 경우 RegionName(이)라고 하는 다음과 같은 단일 값 파라미터를 생성합니다.

SELECT *
FROM transactions
WHERE region = <<$RegionName>>

사용자가 파라미터에 여러 값을 제공하도록 할 수도 있습니다.

SELECT *
FROM transactions
WHERE region in (<<$RegionNames>>)

다음의 좀 더 복잡한 예제에서 데이터 세트 작성자는 대시보드 필터 제어에서 선택할 수 있는 사용자의 이름과 성을 기준으로 두 개의 데이터 세트 파라미터를 두 번 참조합니다.

SELECT Region, Country, OrderDate, Sales
FROM transactions
WHERE region=
(Case
WHEN <<$UserFIRSTNAME>> In 
    (select firstname from user where region='region1') 
    and <<$UserLASTNAME>> In 
    (select lastname from user where region='region1') 
    THEN 'region1'
WHEN <<$UserFIRSTNAME>> In 
    (select firstname from user where region='region2') 
    and <<$UserLASTNAME>> In 
    (select lastname from user where region='region2') 
    THEN 'region2'
ELSE 'region3'
END)

또한 SELECT 절의 파라미터를 사용하여 사용자 입력으로 데이터 세트에 새 열을 만들 수 있습니다.

SELECT Region, Country, date, 
    (case 
    WHEN <<$RegionName>>='EU'
    THEN sum(sales) * 0.93   --convert US dollar to euro
    WHEN <<$RegionName>>='CAN'
    THEN sum(sales) * 0.78   --convert US dollar to Canadian Dollar
    ELSE sum(sales) -- US dollar
    END
    ) as "Sales"
FROM transactions
WHERE region = <<$RegionName>>

사용자 지정 SQL 쿼리를 만들거나 데이터 세트 파라미터를 추가하기 전에 기존 쿼리를 수정하려면 SQL을 사용하여 데이터 사용자 지정을(를) 참조하십시오.

데이터 세트 파라미터와 함께 사용자 지정 SQL을 적용하면 <<$parameter_name>>이(가) 자리 표시자 값으로 사용됩니다. 사용자가 컨트롤에서 파라미터 값 중 하나를 선택하면 QuickSight는 자리 표시자를 사용자가 대시보드에서 선택한 값으로 대체합니다.

다음 예제에서 사용자는 데이터를 상태별로 필터링하는 새로운 사용자 지정 SQL 쿼리를 입력합니다.

select * from all_flights
where origin_state_abr = <<$State>>

파라미터의 기본값이 SQL 쿼리에 적용되고 결과가 미리 보기 창에 표시됩니다. 다음 스크린샷에서 State 파라미터의 기본값은 IL 또는 일리노이입니다. SQL 쿼리는 데이터 세트에서 데이터를 필터링하고 원본 상태가 IL인 데이터 세트의 모든 항목을 반환합니다.