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

# URL에서 파라미터 사용
<a name="parameters-in-a-url"></a>

Amazon Quick의 URL에서 파라미터 이름과 값을 사용하여 대시보드 또는 분석에서 해당 파라미터의 기본값을 설정할 수 있습니다.

다음 예제에서는 다른 대시보드에 대한 파라미터를 설정하는 대시보드의 URL을 보여 줍니다.

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.myParameter=12345
```

앞의 예제에서는 첫 번째 부분이 다음의 타겟 대시보드로 향하는 링크입니다. `https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234` 해시 기호(`#)`는 첫 번째 부분을 따라, 사용자가 설정하려는 값을 담은 *조각*을 도입합니다.

조각의 값은 AWS 서버에서 수신하거나 로깅하지 않습니다. 이 기능을 통해 데이터 값을 보다 안전하게 유지할 수 있습니다.

`#` 다음의 조각은 다음과 같은 규칙을 따릅니다.
+ 파라미터는 접두사 `p.`로 시작합니다. 이름은 컨트롤 이름이 아니라 파라미터 이름입니다. 분석을 열고 왼쪽 사이드바에서 **파라미터**를 선택하여 파라미터 이름을 볼 수 있습니다.
+ 이 값은 등호(`=`)를 사용하여 설정됩니다. 다음 규칙이 적용됩니다.
  + 리터럴 값은 인용 부호를 사용하지 않습니다.
  + 값에 포함된 공백은 브라우저가 자동으로 인코딩합니다. 그러므로 수동으로 URL을 생성할 때 이스케이프 문자를 사용할 필요가 없습니다.
  + 모든 값을 반환하려면 파라미터를 `"[ALL]"`와 같게 설정합니다.
  + 파라미터 값을 `null`에 할당하려면 `%00`와 동일하게 설정합니다. 예를 들어 `p.population=%00`입니다.
  + 사용자 지정 작업에서 대상 파라미터 이름은 `$`로 시작합니다(예: `<<$passThroughParameter>>`).
  + 사용자 지정 작업에서 파라미터 값은 꺾쇠괄호 `<< >>` 안에 표시됩니다(예: `<<dashboardParameter1>>`). 대시보드 사용자에게는 변수가 아나라 조회 값이 표시됩니다.
+ 사용자 지정 URL 작업의 경우, 다중 값 파라미터는 조각에서 동일한 파라미터의 인스턴스가 하나만 필요합니다(예: `p.city=<<$city>>`).
+ 직접 URL의 경우, 단일 파라미터의 다중 값은 조각에서 동일한 파라미터의 인스턴스를 두 개 포함합니다. 예는 다음을 참조하십시오.
+ 앰퍼샌드(`&`)는 여러 파라미터를 구분합니다. 예는 다음을 참조하십시오.

서버는 날짜를 UTC로 변환하여 시간대가 없는 문자열로서 백엔드로 보냅니다. 협정 세계시(UTC) 날짜를 사용하려면 시간대를 제외합니다. 다음은 몇 가지 유효한 날짜 형식의 예입니다.
+ `2017-05-29T00%3A00%3A00` 
+ `2018-04-04 14:51 -08:00`
+ `Wed Apr 04 2018 22:51 GMT+0000`

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30 08:01&p.city=New York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3
```

브라우저에서 이 코드는 다음과 같은 의미를 갖습니다.

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30%2008:01&p.city=New%20York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3
```

앞의 예제에서는 다음 4개의 파라미터를 설정합니다.
+ `shipDate`는 다음과 같은 날짜 파라미터입니다. `Sept 30, 2018`.
+ `city`는 다중 값 문자열 파라미터입니다. `New York` 및 `Seattle`
+ `teamMember`는 다음과 같은 정수 파라미터입니다. `12`.
+ `percentageRank`는 다음과 같은 소수점 파라미터입니다. `2.3` 

다음 예는 다중 값을 수락하는 파라미터에 값을 설정하는 방법을 보여줍니다.

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.MultiParam=WA&p.MultiParam=OR&p.MultiParam=CA
```

사용자의 데이터 포인트 선택에 따라 값을 한 대시보드(또는 분석)에서 다른 대시보드로 전달하려면 사용자 지정 URL 작업을 사용합니다. 원할 경우, 이러한 URL을 수동으로 생성하고 이를 사용해 데이터의 특정 보기를 공유할 수도 있습니다.

사용자 지정 작업 생성에 대한 자세한 내용은 [필터링 및 탐색을 위한 사용자 지정 동작 사용](quicksight-actions.md) 단원을 참조하십시오.