기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 데이터세트 파라미터를 사용자 지정 SQL에 삽입
<a name="dataset-parameters-insert-parameter"></a>

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을 사용하여 데이터 사용자 지정](adding-a-SQL-query.md)을(를) 참조하십시오.

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

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

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

파라미터의 기본값이 SQL 쿼리에 적용되고 결과가 **미리 보기 창**에 표시됩니다.