보고서에 매개 변수 추가

Reporting Services에서 매개 변수 사용

매개 변수의 주 용도는 데이터 집합 쿼리에 의해 검색되는 보고서 데이터의 변경입니다. 이 시나리오에서는 사용자가 보고서를 실행할 때 값을 입력하라는 메시지가 표시되며 데이터 집합 쿼리는 요청된 데이터만 검색합니다. 데이터 집합 쿼리에는 쿼리 매개 변수가 포함되며 Reporting Services는 쿼리 매개 변수에 간접적으로 연결되는 해당 보고서 매개 변수를 자동으로 만듭니다. 보고서 디자인 도구에서 보고서 매개 변수 속성을 변경하여 유효한 값 목록 및 런타임에 표시되는 사용자 프롬프트를 포함하도록 할 수 있습니다.

또한 데이터 원본에서 계층적 데이터를 검색하는 연계 매개 변수를 만들 수도 있습니다. 예를 들어 첫 번째 매개 변수로 제품 범주를 필터링하고 두 번째 매개 변수로 제품을 필터링할 수 있습니다. 연계 매개 변수는 사용자에게 제공되는 값을 구성하고 그 수를 제한하는 데 사용됩니다.

일부 데이터 원본은 쿼리 매개 변수를 지원하지 않습니다. 원본에서 데이터를 필터링할 수 없는 경우 보고서 매개 변수를 사용하여 데이터가 보고서용으로 검색된 후 사용자가 이를 필터링할 수 있는 기능을 제공할 수 있습니다. 모든 쿼리 매개 변수에는 해당 보고서 매개 변수가 있지만 보고서 디자이너 도구에서 독립적으로 보고서 매개 변수를 정의할 수 있습니다. 보고서 매개 변수는 데이터가 검색된 후 보고서의 모양 또는 구성을 변경하는 데 사용할 수도 있습니다.

매개 변수는 포함된 보고서 및 드릴스루 보고서에 보고서를 연결하는 데 사용됩니다. 이러한 보고서 매개 변수는 숨겨진 상태로 주 보고서의 값을 사용하여 연결된 보고서에 대한 올바른 데이터를 선택하거나 런타임에 사용자에게 표시될 수도 있습니다.

보고서 매개 변수를 만든 다음에는 기본값 및 기타 매개 변수 속성(예: 표시 유형)을 수정할 수 있습니다. 예를 들어 보고서 매개 변수는 UserID와 같은 기본 제공 변수를 사용할 수 있으므로 보고서를 실행하는 사용자와 관련된 데이터를 선택하는 숨겨진 매개 변수를 사용하여 보고서를 만들 수 있습니다. 매개 변수는 단일 값이나 다중값을 포함하고 정적 또는 쿼리 기반 유효 값 목록을 사용하고 Null 또는 빈 값을 허용할 수 있습니다. 다중값 매개 변수를 통해 사용자는 런타임에 두 개 이상의 값을 선택할 수 있습니다.

보고서가 게시된 후 보고서 정의로부터 독립적으로 매개 변수를 관리할 수 있습니다. 디자인 타임에 보고서에서 매개 변수를 구성하는 방법에 따라 보고서 서버 관리자가 게시된 보고서에서 많은 매개 변수 속성을 수정할 수 있습니다. 또한 동일한 보고서 정의에 연결되어 여러 대상에 대한 보고서를 사용자 지정하는 일련의 매개 변수를 만들 수도 있습니다. 자세한 내용은 게시된 보고서의 매개 변수 속성 설정을 참조하십시오.

URL 액세스를 사용하여 보고서를 실행하고 매개 변수 값을 지정할 수도 있습니다. 자세한 내용은 URL 액세스 매개 변수 사용을 참조하십시오.

보안 정보

String 형식의 매개 변수가 포함된 보고서에서는 유효한 값 목록이라고도 하는 사용 가능한 값 목록을 사용해야 하며 보고서를 실행하는 모든 사용자가 보고서의 데이터를 보는 데 필요한 권한만 갖도록 해야 합니다. String 형식의 매개 변수를 정의할 경우 모든 값을 사용할 수 있는 입력란이 사용자에게 제공됩니다. 사용 가능한 값 목록은 입력할 수 있는 값을 제한합니다. 보고서 매개 변수가 쿼리 매개 변수에 연결되어 있고 사용 가능한 값 목록을 사용하지 않는 경우에는 보고서 사용자가 입력란에 SQL 구문을 입력할 수 있으므로 보고서와 서버가 SQL 삽입 공격을 받을 가능성이 있습니다. 사용자에게 새 SQL 문 실행을 위한 충분한 권한이 있으면 서버에 원하지 않은 결과가 발생할 수 있습니다. 보고서 매개 변수가 쿼리 매개 변수에 연결되어 있지 않고 매개 변수 값이 보고서에 포함된 경우에는 보고서 사용자가 식 구문 또는 URL을 매개 변수 값에 입력하고 보고서를 Excel 또는 HTML로 렌더링할 수 있습니다. 이후 다른 사용자가 보고서를 보면서 렌더링된 매개 변수 내용을 클릭할 경우 악의적인 스크립트나 링크가 실수로 실행될 수 있습니다. 악의적인 스크립트를 실수로 실행하는 위험을 줄이기 위해 신뢰할 수 있는 출처의 렌더링된 보고서만 여십시오. 보고서 보안 설정 방법은 보고서 및 리소스 보안을 참조하십시오.

섹션 내용

• 매개 변수를 사용하여 보고서 데이터 제어
  매개 변수를 사용하여 보고서 데이터를 필터링하는 방법, 정보 및 그룹 데이터에 대한 정렬 순서를 변경하는 방법, 특정 데이터 공급자를 사용하도록 쿼리를 수정하는 방법을 설명합니다.

• 특정 데이터 원본에 쿼리 매개 변수 사용(Reporting Services)
  다양한 데이터 원본에서 예상되는 쿼리 구문을 설명합니다.

• 매개 변수를 사용하여 보고서 모양 제어
  매개 변수를 통해 식 기반 속성을 사용하여 보고서 모양을 변경하는 방법을 설명합니다. 여기에는 조건부로 보고서 항목을 숨기는 방법과 입력란의 값을 기반으로 조건부로 텍스트 색을 변경하는 방법이 포함됩니다.

• 매개 변수를 사용하여 다른 보고서에 연결
  매개 변수를 사용하여 드릴스루 보고서, 포함된 보고서 및 링크된 보고서에 연결하는 방법을 설명합니다.

• 단일 값 및 다중값 매개 변수 사용
  단일 값 및 다중값 매개 변수를 사용하는 방법을 설명합니다.

• 보고서 매개 변수 만들기 및 보고서 매개 변수 속성 설정
  보고서를 제작할 때 보고서 매개 변수에 대한 속성을 만들고 설정하는 방법을 설명합니다. 여기에는 데이터 형식, 기본값, 매개 변수 프롬프트, 사용 가능한 값, 다중값, 런타임에 사용자에 대해 매개 변수가 내부적인지, 숨겨지는지 또는 표시되는지 등이 포함됩니다.

참고 항목

태스크

참조

개념

관련 자료