보고서 매개 변수(보고서 작성기 및 SSRS)
보고서 매개 변수를 사용하면 보고서 데이터를 제어하고, 관련된 보고서를 서로 연결하고, 다양하게 보고서를 표현할 수 있습니다. 매개 변수를 효율적으로 사용하는 보고서를 디자인하려면 매개 변수와 데이터 집합 쿼리의 관련성, 매개 변수를 식에 포함하는 방법, 매개 변수를 보고서 서버나 SharePoint 사이트의 보고서 정의와 독립적으로 관리하는 방법을 알아야 합니다. 보고서를 게시한 후에는 보고서 정의로부터 독립적으로 매개 변수를 관리할 수 있습니다. 링크된 보고서를 만들면 동일 보고서에 대해 여러 매개 변수 집합을 만들 수도 있습니다.
보고서를 볼 때 보고서 뷰어 도구 모음에 각 매개 변수가 표시되므로 사용자가 대화형으로 값을 지정할 수 있습니다. 다음 그림은 @StartDate, @EndDate, @Subcategory 및 @ShowAllRows 매개 변수가 있는 보고서의 매개 변수 영역을 보여 줍니다.
.gif "rs_ParameterStory")
매개 변수 창 보고서 뷰어 도구 모음에 프롬프트와 각 매개 변수에 대한 기본값이 표시됩니다. 도구 모음의 매개 변수 레이아웃 서식은 자동으로 지정됩니다. 순서는 매개 변수가 보고서 데이터 창에 표시되는 순서에 의해 결정됩니다.
@StartDate 및 @EndDate 매개 변수 @StartDate 매개 변수의 데이터 형식은 DateTime입니다. 시작 날짜 프롬프트가 입력란 옆에 표시됩니다. 이 날짜를 수정하려면 입력란에 새 날짜를 입력하거나 달력 컨트롤을 사용합니다.
@EndDate 매개 변수는 @StartDate 옆에 표시됩니다.
@Subcategory 매개 변수 @Subcategory 매개 변수의 데이터 형식은 Text입니다. @Subcategory에 사용 가능한 값 목록이 있으므로 유효한 값이 드롭다운 목록에 표시됩니다. 이 목록에서 값을 선택해야 합니다. @Subcategory는 다중값을 가지므로 모두 지우고 목록에서 모든 값을 선택할 수 있는 모두 선택 옵션이 표시됩니다.
@ShowAllRows 매개 변수 @ShowAllRows 매개 변수의 데이터 형식은 Boolean입니다. 라디오 단추를 사용하여 True 또는 False를 지정합니다.
매개 변수 영역 핸들 표시 또는 숨기기 보고서 뷰어 도구 모음에서 이 화살표를 클릭하여 매개 변수 창을 표시하거나 숨깁니다.
매개 변수 단추 보고서 작성기 미리 보기에서 리본에 있는 매개 변수 단추를 클릭하여 매개 변수 창을 표시하거나 숨깁니다.
보고서 보기 단추 보고서 뷰어 도구 모음에서 보고서 보기를 클릭하면 매개 변수 값이 입력된 후 보고서가 실행됩니다. 모든 매개 변수에 기본값이 있는 경우 보고서를 처음으로 볼 때 보고서가 자동으로 실행됩니다.
매개 변수를 즉시 사용하는 방법에 대한 자세한 내용은 자습서: 보고서에 매개 변수 추가(보고서 작성기) 또는 보고서 예제(보고서 작성기 및 SSRS)를 참조하십시오.
[!참고]
SQL Server Data Tools의 보고서 작성기 및 보고서 디자이너에서 보고서 정의(.rdl)를 만들고 수정할 수 있습니다. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다. 자세한 내용은 microsoft.com 웹에서 보고서 디자이너 및 보고서 작성기에서 보고서 디자인(SSRS)을 참조하십시오.
문서 내용
매개 변수의 일반적인 용도
매개 변수 유형
매개 변수 만들기
보고서 매개 변수
데이터 집합 매개 변수
연계 매개 변수
보고서에 매개 변수 값 표시
드릴스루 보고서에 대한 매개 변수 설정
하위 보고서에 대한 매개 변수 설정
게시된 보고서에 대한 매개 변수 관리
보고서 URL에 대한 매개 변수 설정
구독에 대한 매개 변수 설정
스냅숏에 대한 매개 변수 설정
매개 변수 및 데이터 보안
방법 도움말 항목
섹션 내용
관련 항목
매개 변수의 일반적인 용도
다음은 매개 변수를 사용하는 가장 일반적인 몇 가지 방법입니다.
쿼리 변수를 포함하는 데이터 집합 쿼리를 작성하여 데이터 원본의 보고서 데이터를 필터링합니다.
공유 데이터 집합에서 데이터를 필터링합니다. 보고서에 공유 데이터 집합을 추가하면 쿼리를 변경할 수 없습니다. 만들어진 보고서 매개 변수에 대한 참조가 포함되어 있는 데이터 집합 필터를 보고서에 추가할 수 있습니다.
사용자가 값을 지정하여 보고서의 데이터를 사용자 지정할 수 있도록 합니다. 예를 들어 매출 데이터의 시작 날짜와 종료 날짜에 대한 두 개의 매개 변수를 제공합니다.
사용자가 값을 지정하여 보고서 모양을 사용자 지정할 수 있도록 합니다. 예를 들어 테이블에서 중첩된 모든 행 그룹을 확장하거나 축소할 것인지 여부를 나타내는 부울 매개 변수를 제공합니다.
선택할 값에 대한 드롭다운 목록을 만들어 사용자가 유효한 값만 선택할 수 있도록 합니다.
각 매개 변수에 대한 기본값을 만들어 보고서를 처음 볼 때 보고서가 자동으로 실행되도록 합니다.
연계 값을 만들어 한 매개 변수에 대한 드롭다운 목록이 이전 매개 변수에 대한 선택을 기반으로 유효한 값 집합이 되도록 합니다. 따라서 수천 개 값의 매개 변수 값을 관리 가능한 수치로 연속적으로 필터링할 수 있습니다.
매개 변수를 사용하여 주 보고서를 드릴스루 보고서, 하위 보고서 및 링크된 보고서에 연결합니다. 일련의 보고서를 디자인할 때 특정 질문에 응답하도록 각 보고서를 디자인할 수 있습니다. 각 보고서는 관련된 세부 정보를 다른 뷰 또는 다른 수준으로 표시할 수 있습니다. 서로 관련된 일련의 보고서를 제공하려면 대상 보고서의 관련 데이터에 대한 매개 변수를 만듭니다.
여러 사용자에 대한 매개 변수 집합을 사용자 지정합니다. 보고서 서버에서 판매 보고서를 기반으로 하는 링크된 보고서 두 개를 만듭니다. 한 링크된 보고서에서는 영업 사원에 대해 미리 정의된 매개 변수 값을 사용하고 링크된 나머지 보고서에서는 영업 관리자에 대해 미리 정의된 매개 변수 값을 사용합니다. 두 보고서 모두 동일한 보고서 정의를 사용합니다.
보고서 스냅숏, 기록 또는 게시된 보고서에 대한 구독을 만들려는 경우 보고서 매개 변수가 보고서의 디자인 요구 사항에 미치는 영향을 이해해야 합니다.
.gif "맨 위 링크와 함께 사용되는 화살표 아이콘")
맨 위로 이동
매개 변수 만들기
다음과 같은 방법으로 보고서 매개 변수를 만들 수 있습니다.
쿼리 변수가 포함된 쿼리가 있는 데이터 집합(포함 또는 공유)을 만들거나 추가합니다. 자세한 내용은 보고서 데이터 집합 및 쿼리 이해를 참조하십시오.
보고서 데이터 창에서 매개 변수를 수동으로 만듭니다. 자세한 내용은 보고서 매개 변수 추가, 변경 또는 삭제(보고서 작성기 및 SSRS)를 참조하십시오.
매개 변수에 대한 참조를 포함하거나 변수가 포함된 공유 데이터 집합을 참조하는 보고서 파트를 추가합니다.
[!참고]
매개 변수는 매개 변수가 포함된 종속 데이터 집합이 있는 데이터 영역에 대해 개별 보고서 파트로 게시할 수 있습니다. 매개 변수는 보고서 파트로 나열되지만 보고서에 보고서 파트 매개 변수를 직접 추가할 수 없습니다. 대신 보고서 파트를 추가하면 보고서 파트에 의해 포함되었거나 참조되는 데이터 집합 쿼리에서 필요한 보고서 매개 변수가 자동으로 생성됩니다. 보고서 파트에 대한 자세한 내용은 보고서 파트(보고서 작성기 및 SSRS) 및 보고서 디자이너의 보고서 파트(SSRS)를 참조하십시오.
매개 변수 유형
보고서에는 데이터 집합 매개 변수와 보고서 매개 변수의 두 가지 매개 변수 유형이 있습니다.
데이터 집합 매개 변수 포함된 데이터 집합이나 공유 데이터 집합에 대한 데이터 집합 매개 변수는 데이터 집합 쿼리 명령에서 각 쿼리 변수에 대해 자동으로 만들어집니다. 일부 쿼리 디자이너에서는 필터 이름을 기반으로 적용된 필터를 추가할 영역과 필드 이름을 기반으로 데이터 집합 매개 변수를 추가하는 옵션이 제공됩니다.
데이터 집합 매개 변수는 데이터 집합 쿼리를 정의한 후에 구성됩니다. 각 데이터 집합 매개 변수에 대한 기본값을 독립적으로 지정할 수 있습니다. 보고서에 공유 데이터 집합을 추가하면 내부로 표시된 데이터 집합 매개 변수를 보고서에서 재정의할 수 없습니다. 내부로 표시되지 않은 데이터 집합 매개 변수를 재정의할 수 있습니다. 추가 매개 변수를 만들 수도 있습니다. 자세한 내용은 이 항목의 데이터 집합 매개 변수를 참조하십시오.
보고서 매개 변수 보고서 매개 변수는 각 데이터 집합 매개 변수에 대해 자동으로 생성됩니다. 보고서 매개 변수를 직접 만들 수도 있습니다. 사용자가 보고서 내용이나 모양을 사용자 지정하기 쉽게 대화형으로 값을 입력할 수 있도록 보고서 매개 변수를 구성할 수 있습니다. 사용자가 미리 구성된 값을 변경하지 못하도록 보고서 매개 변수를 구성할 수도 있습니다. 보고서 매개 변수는 보고서 서버에서 게시된 보고서와 별도로 관리됩니다. 자세한 내용은 이 항목의 보고서 매개 변수를 참조하십시오.
보고서 매개 변수를 보고서와는 별도로 보고서 파트로 저장할 수도 있습니다. 보고서 파트는 보고서 서버에 저장되며 다른 사용자가 자신의 보고서에 사용할 수 있습니다. 매개 변수인 보고서 파트는 보고서 서버에서 관리할 수 없습니다. 보고서 파트 갤러리에서 매개 변수를 검색하여 추가한 후에 보고서에서 구성할 수 있습니다. 자세한 내용은 보고서 파트(보고서 작성기 및 SSRS)를 참조하십시오.
맨 위로 이동
보고서 매개 변수
매개 변수는 주로 데이터 집합 쿼리에 의해 검색되는 보고서 데이터를 다양하게 설정하는 데 사용됩니다. 이 시나리오에서는 사용자가 보고서를 실행할 때 값을 입력하라는 메시지가 표시되며 데이터 집합 쿼리는 요청된 데이터만 검색합니다. 데이터 집합 쿼리는 쿼리 매개 변수를 포함하며 보고서 처리기는 쿼리 매개 변수에 간접적으로 연결되는 보고서 매개 변수를 자동으로 만듭니다.
[!참고]
매개 변수는 서버에서 독립적으로 관리되므로 새 매개 변수 설정을 가진 주 보고서를 다시 게시하더라도 보고서의 기존 매개 변수 설정을 덮어쓰지 않습니다.
보고서 매개 변수는 다음과 같은 방법으로 생성됩니다.
쿼리 변수가 포함된 데이터 집합 쿼리를 정의할 때 자동으로 생성됩니다. 각 쿼리 변수의 경우 해당 데이터 집합 쿼리 매개 변수 및 보고서 매개 변수가 같은 이름으로 생성됩니다. 쿼리 매개 변수는 저장 프로시저의 입력 매개 변수 또는 쿼리 변수에 대한 참조일 수 있습니다.
쿼리 집합 매개 변수가 포함된 공유 데이터 집합에 참조를 추가할 때 자동으로 생성됩니다.
보고서 데이터 창에서 보고서 매개 변수를 만들 때 수동으로 생성됩니다. 매개 변수는 보고서의 식에 포함할 수 있는 기본 제공 컬렉션 중 하나입니다. 보고서 정의 전반에서 값을 정의하는 데 식이 사용되기 때문에 매개 변수를 사용하여 보고서 모양을 제어하거나 관련 하위 보고서나 매개 변수를 사용하는 다른 보고서에 값을 전달할 수 있습니다.
기본적으로 자동으로 만들어지는 매개 변수는 자동으로 생성된 이름, 프롬프트 및 데이터 형식을 사용합니다. 보고서 속성 대화 상자를 사용하여 보고서 데이터 창에서 보고서 매개 변수 속성을 변경할 수 있습니다. 다음 표에는 각 매개 변수에 대해 설정할 수 있는 속성이 요약되어 있습니다.
속성 |
설명 |
||
|---|---|---|---|
이름 |
매개 변수의 대/소문자를 구분하는 이름을 입력합니다. 이 이름은 문자로 시작해야 하고 문자, 숫자 및 밑줄(_)을 포함할 수 있으며 공백은 포함할 수 없습니다. 자동으로 생성된 매개 변수의 이름은 데이터 집합 쿼리의 쿼리 매개 변수와 일치합니다. 기본적으로 수동으로 만든 매개 변수는 ReportParameter1과 이름이 유사합니다. |
||
프롬프트 |
보고서 뷰어 도구 모음에서 매개 변수 옆에 표시되는 텍스트입니다. |
||
데이터 형식 |
보고서 매개 변수는 다음 데이터 형식 중 하나여야 합니다.
매개 변수에 대해 사용할 수 있는 값이 정의된 경우 사용자는 데이터 형식이 DateTime인 경우에도 드롭다운 목록에서 값을 선택합니다. 보고서 데이터 형식에 대한 자세한 내용은 RDL 데이터 형식을 참조하십시오. |
||
빈 값 허용 |
매개 변수 값에 빈 문자열이나 공백을 허용하려면 이 옵션을 선택합니다. 매개 변수에 대한 유효한 값을 지정할 경우 공백 값을 유효한 값 중 하나로 허용하려면 지정한 값 중 하나로 공백 값을 포함시켜야 합니다. 이 옵션을 선택해도 사용 가능한 값에 공백이 자동으로 포함되지는 않습니다. |
||
Null 값 허용 |
매개 변수 값이 Null이 될 수 있도록 허용하려면 이 옵션을 선택합니다. 매개 변수에 대한 유효한 값을 지정할 경우 null을 유효한 값 중 하나로 허용하려면 지정한 값 중 하나로 null을 포함시켜야 합니다. 이 옵션을 선택해도 사용 가능한 값에 null이 자동으로 포함되지는 않습니다. |
||
다중 값 허용 |
사용자가 선택할 수 있는 드롭다운 목록을 만드는 데 사용 가능한 값을 제공합니다. 이렇게 하면 데이터 집합 쿼리에서 유효한 값만 제출되도록 할 수 있습니다. 매개 변수의 값이 드롭다운 목록에 표시되는 다중 값이 될 수 있도록 허용하려면 이 옵션을 선택합니다. Null 값은 허용되지 않습니다. 이 옵션을 선택하면 매개 변수 드롭다운 목록의 사용 가능한 값 목록에 확인란이 추가되고 목록의 맨 위에 모두 선택에 대한 확인란이 포함됩니다. 사용자는 원하는 값을 선택할 수 있습니다. 값을 제공하는 데이터가 빠르게 변동될 경우 사용자에게 표시되는 목록이 최신 상태가 아닐 수도 있습니다. |
||
표시 |
보고서를 실행할 때 보고서 위쪽에 보고서 매개 변수를 표시하려면 이 옵션을 선택합니다. 이 옵션을 설정하면 사용자가 런타임에 매개 변수 값을 선택할 수 있습니다. |
||
숨김 |
게시된 보고서에서 보고서 매개 변수를 숨기려면 이 옵션을 선택합니다. 보고서 매개 변수 값은 여전히 보고서 URL, 구독 정의 또는 보고서 서버에 설정할 수 있습니다. |
||
내부 |
보고서 매개 변수를 숨기려면 이 옵션을 선택합니다. 게시된 보고서에서 보고서 매개 변수는 보고서 정의에서만 볼 수 있습니다. |
||
사용 가능한 값 |
매개 변수에 대해 사용 가능한 값을 지정한 경우에는 유효한 값이 항상 드롭다운 목록으로 표시됩니다. 예를 들어 DateTime 매개 변수에 사용할 수 있는 값을 제공하면 날짜에 대한 드롭다운 목록이 달력 컨트롤 대신 매개 변수 창에 표시됩니다. 값 목록이 보고서와 하위 보고서 간에 일관되도록 하려면 데이터 원본과 연관된 데이터 집합의 모든 쿼리에 단일 트랜잭션을 사용하도록 데이터 원본에서 옵션을 설정할 수 있습니다.
|
||
기본값 |
쿼리 또는 정적 목록에서 기본값을 설정합니다. 매개 변수마다 기본값이 있을 경우에는 보고서를 처음으로 볼 때 보고서가 자동으로 실행됩니다. |
||
고급 |
이 매개 변수가 보고서의 데이터에 직접 또는 간접으로 영향을 주는지를 나타내는 값인 보고서 정의 특성 UsedInQuery를 설정합니다.
|
.gif "주의 사항")
주의맨 위로 이동
데이터 집합 매개 변수
쿼리 매개 변수는 쿼리 디자이너에서 쿼리를 작성할 때 정의됩니다. 일부 데이터 확장 프로그램은 매개 변수로 포함할 필드를 선택하는 방법을 제공합니다. 다른 데이터 확장 프로그램은 쿼리 명령에서 쿼리 변수를 확인합니다. 쿼리 매개 변수는 모든 쿼리 변수에 대해 자동으로 생성됩니다.
일부 데이터 원본은 쿼리 매개 변수를 지원하지 않습니다. 원본에서 데이터를 필터링할 수 없는 경우 보고서 매개 변수를 사용하여 데이터가 보고서용으로 검색된 후 사용자가 이를 필터링할 수 있는 기능을 제공할 수 있습니다. 모든 쿼리 매개 변수에는 해당 보고서 매개 변수가 있지만 보고서 매개 변수를 독립적으로 정의할 수 있습니다. 보고서 매개 변수는 데이터가 검색된 후 보고서의 모양 또는 구성을 변경하는 데 사용할 수도 있습니다.
데이터 집합 쿼리에서 데이터를 필터링하려면 결과 집합에서 포함하거나 제외할 값을 지정하여 검색된 데이터를 제한하는 제한 절을 포함합니다.
데이터 원본에 관련된 쿼리 디자이너를 사용하여 매개 변수가 있는 쿼리를 작성할 수 있습니다.
Transact-SQL 쿼리의 경우 서로 다른 데이터 원본이 매개 변수에 대한 서로 다른 구문을 지원합니다. 위치 또는 이름으로 쿼리에서 식별되는 매개 변수의 범위를 지원합니다. 자세한 내용은 보고서에 데이터 추가(보고서 작성기 및 SSRS)에서 특정 외부 데이터 원본 유형에 대한 항목을 참조하십시오. 관계형 쿼리 디자이너에서 매개 변수가 있는 쿼리를 만들려면 필터에 대해 매개 변수 옵션을 선택해야 합니다. 자세한 내용은 관계형 쿼리 디자이너 사용자 인터페이스(보고서 작성기)를 참조하십시오.
Microsoft SQL Server Analysis Services, SAP NetWeaver BI 또는 Hyperion Essbase처럼 다차원 데이터 원본을 기반으로 하는 쿼리에서는 쿼리 디자이너에서 지정한 필터를 기반으로 하는 매개 변수를 만들 것인지 여부를 지정할 수 있습니다. 자세한 내용은 쿼리 디자이너(보고서 작성기)에서 데이터 확장 프로그램에 해당하는 쿼리 디자이너 항목을 참조하십시오.
맨 위로 이동
연계 매개 변수
사용자가 특정 순서로 각 매개 변수에 대한 값을 선택하고 각 선택이 연속적으로 다음 매개 변수에 대한 값을 제한하는 연계 매개 변수를 만들 수 있습니다. 연계 매개 변수는 수천 개의 선택을 관리 가능한 개수로 잠재적으로 줄일 수 있습니다. 예를 들어 사용자가 제품 범주를 선택하고 해당 범주에서 사용 가능한 제품 목록을 선택한 다음 크기와 색을 차례로 선택합니다.
자세한 내용은 보고서에 연계 매개 변수 추가(보고서 작성기 및 SSRS)를 참조하십시오.
맨 위로 이동
보고서에 매개 변수 표시
보고서 매개 변수는 식에서 참조할 수 있는 기본 제공 컬렉션 중 하나입니다. 식 구문은 보고서 매개 변수가 단일 값만 허용하는지 여러 값을 허용하는지에 따라 달라집니다. 자세한 내용은 일반적으로 사용되는 필터(보고서 작성기 및 SSRS) 및 매개 변수 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하십시오.
드릴스루 보고서에 대한 매개 변수 설정
드릴스루 동작은 속성 페이지에서 보고서 항목의 입력란에 대해 설정되거나 차트 또는 계기의 일부에서 설정됩니다. 이러한 보고서 매개 변수는 숨겨진 상태로 주 보고서의 값을 사용하여 연결된 보고서에 대한 올바른 데이터를 선택하거나 런타임에 사용자에게 표시될 수도 있습니다. 드릴스루 동작에 대한 대상 보고서의 이름을 설정하는 방법은 사용자가 보고서 서버에 연결되어 있는지 여부에 따라 달라집니다. 자세한 내용은 외부 항목에 대한 경로 지정(보고서 작성기 및 SSRS)을 참조하십시오.
또한 URL 주소 지정 가능 보고서에 대해 URL 액세스를 사용할 수 있으며 보고서 매개 변수 값을 URL 구문의 일부로 포함할 수 있습니다. 자세한 내용은 URL 액세스(SSRS)를 참조하십시오.
하위 보고서에 대한 매개 변수 설정
하위 보고서에 대한 매개 변수를 설정하려면 하위 보고서 속성 대화 상자의 매개 변수 페이지를 사용합니다. 하위 보고서의 이름을 설정하는 방법은 사용자가 보고서 서버에 연결되어 있는지 여부에 따라 달라집니다. 자세한 내용은 외부 항목에 대한 경로 지정(보고서 작성기 및 SSRS)을 참조하십시오.
[!참고]
하위 보고서를 테이블릭스 데이터 영역에서 사용하는 경우 하위 보고서 및 해당 매개 변수는 모든 행에 대해 처리됩니다. 행이 많을 경우 드릴스루 보고서가 더 적합한지 여부를 고려해 보십시오.
자세한 내용은 하위 보고서 및 매개 변수 추가(보고서 작성기 및 SSRS)를 참조하십시오.
보고서 서버 또는 SharePoint 사이트에서 매개 변수 관리
보고서를 디자인할 때는 보고서 매개 변수가 보고서 정의에 저장되고, 보고서를 게시할 때는 보고서 매개 변수가 보고서 정의와 별개로 저장 및 관리됩니다.
게시된 보고서의 경우 다음을 사용할 수 있습니다.
보고서 매개 변수 속성. 보고서 정의로부터 독립적으로 보고서 서버에서 보고서 매개 변수 값을 직접 변경합니다.
**캐시된 보고서. **보고서에 대한 캐시 계획을 만들려면 각 매개 변수에 기본값이 있어야 합니다. 자세한 내용은 보고서 캐시(SSRS)을 참조하십시오.
**캐시된 공유 데이터 집합. **공유 데이터 집합에 대한 캐시 계획을 만들려면 각 매개 변수에 기본값이 있어야 합니다. 자세한 내용은 보고서 캐시(SSRS)을 참조하십시오.
링크된 보고서. 다양한 대상에 대한 데이터를 필터링하기 위해 미리 설정된 매개 변수 값을 사용하여 링크된 보고서를 만들 수 있습니다. 자세한 내용은 링크된 보고서 만들기를 참조하십시오.
보고서 구독. 구독을 통해 데이터를 필터링하고 보고서를 전달하는 매개 변수 값을 지정할 수 있습니다. 자세한 내용은 구독 및 배달(Reporting Services)을 참조하십시오.
URL 액세스. 보고서 URL에 매개 변수 값을 지정할 수 있습니다. URL 액세스를 사용하여 보고서를 실행하고 매개 변수 값을 지정할 수도 있습니다. 자세한 내용은 보고서 URL에 대한 매개 변수 설정을 참조하십시오.
게시된 보고서에 대한 매개 변수 속성은 일반적으로 보고서 정의를 다시 게시할 경우 유지됩니다. 보고서 정의가 동일한 보고서로 다시 게시되고 매개 변수 이름 및 데이터 형식이 그대로 유지되면 속성 설정도 그대로 유지됩니다. 보고서 정의에서 매개 변수를 추가 또는 삭제하거나 데이터 형식 또는 기존 매개 변수의 이름을 변경할 경우 게시된 보고서의 매개 변수 속성을 변경해야 할 수 있습니다.
매개 변수를 수정할 수 없는 경우도 있습니다. 보고서 매개 변수가 쿼리에서 기본값을 가져오는 경우 이 값을 게시된 보고서에 맞게 수정할 수 없습니다. "쿼리 기반"으로 지정되는 기본 매개 변수 값은 보고서 정의에 정의되며 보고서 서버에서 수정할 수 없습니다. 쿼리 기반 매개 변수 값은 상수 값이 아닙니다. 런타임 시 사용되는 값은 쿼리를 실행할 때 결정되거나 식 기반 매개 변수의 경우 식을 계산할 때 결정됩니다.
보고서 실행 옵션이 매개 변수 처리 방법에 영향을 줄 수 있습니다. 스냅숏으로 실행되는 보고서는 쿼리에 매개 변수의 기본값이 포함되지 않는 한 쿼리에서 파생된 매개 변수를 사용할 수 없습니다.
맨 위로 이동
보고서 URL에 대한 매개 변수 설정
매개 변수가 있는 보고서를 실행하는 다른 방법은 URL을 사용하는 것입니다. 인코딩된 이름-값 쌍으로 된 하나 이상의 매개 변수를 앰퍼샌드 문자(&)로 구분하여 지정할 수 있습니다.
Null 매개 변수. Null 매개 변수는 특수 구문을 사용하므로 Null 값에 대해 isnull을 지정해야 합니다. 매개 변수에 대해 Null 값을 지정하면 동일한 매개 변수에 대해 지정된 다른 값은 모두 무시됩니다. 다음은 Null 및 상수 값에 대한 여러 매개 변수를 설명하는 예입니다.
http://exampleWebServerName/reportserver?/foldercontainingreports/orders&division=mailorder®ion=west&sales:isnull=true
여러 값을 갖는 매개 변수. 다음과 같이 매개 변수 이름을 반복하여 여러 값을 지정할 수 있습니다.
http://exampleWebServerName/reportserver? %2ffoldercontainingreports%2forders®ion=east®ion=west
Boolean. false의 경우 값 0을 사용하고 true의 경우 1을 사용합니다.
Float. 서버 로캘의 소수 구분 기호를 포함합니다.
DateTime. ISO(국제 표준화 기구) 8601 표준을 기반으로 하여 YYYY-MM-DDTHH:MM:SS 형식을 사용합니다.
보고서 매개 변수 값을 설정하는 것은 URL 액세스 구문을 사용하여 보고서를 보는 한 가지 방법일 뿐입니다. 다른 예로, URL 매개 변수를 지정하여 특정 페이지 번호에서 시작하는 보고서를 볼 수 있습니다. 다음 예에서는 AdventureWorks2012의 예제 Product Catalog 2008 보고서에서 30 페이지를 엽니다.
http://exampleWebServerName/reportserver? %2fAdventureWorks2012+Sample+Reports%2fProduct+Catalog+2008&rs:Command=Render&rc:Section=30
자세한 내용은 URL 액세스 매개 변수 참조을 참조하십시오.
맨 위로 이동
구독에 대한 매개 변수 설정
요청 시 또는 스냅숏에 대한 구독을 정의하고 구독을 처리하는 중에 사용할 매개 변수 값을 지정할 수 있습니다.
요청 시 실행 보고서. 요청 시 실행 보고서의 경우 보고서에 대해 나열된 각 매개 변수의 게시된 값과는 다른 매개 변수 값을 지정할 수 있습니다. 예를 들어 Time Period 매개 변수를 사용하여 현재 날짜, 주 또는 월에 해당하는 고객 서비스 요청을 반환하는 서비스 호출 보고서가 있다고 가정합니다. 보고서의 기본 매개 변수 값이 today로 설정된 경우 구독에서는 다른 매개 변수 값(예: week 또는 month)을 사용하여 주 또는 월을 나타내는 숫자가 포함된 보고서를 생성할 수 있습니다.
스냅숏. 스냅숏의 경우 구독에서는 스냅숏에 대해 정의된 매개 변수 값을 사용해야 합니다. 스냅숏에 대해 정의된 매개 변수를 구독에서 재정의할 수 없습니다. 예를 들어 보고서 스냅숏으로 실행되는 서부 지역 판매 보고서를 구독하고 스냅숏에서 지역 매개 변수 값으로 Western을 지정한다고 가정합니다. 이 보고서에 대한 구독을 만들 경우 구독의 매개 변수 값으로 Western을 사용해야 합니다. 매개 변수 무시를 시각적으로 나타내기 위해 구독 페이지의 매개 변수 필드는 읽기 전용 필드로 설정됩니다.
[!참고]
데이터 기반 구독은 구독자 데이터 원본에서 가져오는 매개 변수 값을 사용할 수 있습니다. 자세한 내용은 구독자 데이터에 외부 데이터 원본 사용(데이터 기반 구독)를 참조하십시오.
구독을 정의한 후 보고서 스냅숏의 매개 변수 값을 변경하면 보고서 서버에서 구독이 비활성화됩니다. 구독을 비활성화하면 보고서가 수정된 것으로 표시됩니다. 구독을 활성화하려면 구독을 열어서 저장합니다.
자세한 내용은 구독 및 배달(Reporting Services)을 참조하십시오.
맨 위로 이동
스냅숏에 대한 매개 변수 설정
보고서 실행 옵션이 매개 변수 처리 방법에 영향을 줄 수 있습니다. 보고서 스냅숏으로 실행되는 매개 변수가 있는 보고서는 보고서 스냅숏에 대해 정의된 매개 변수 값을 사용합니다. 매개 변수 값은 보고서의 매개 변수 속성 페이지에 정의됩니다. 스냅숏으로 실행되는 보고서는 쿼리에 매개 변수의 기본값이 포함되지 않는 한 쿼리에서 파생된 매개 변수를 사용할 수 없습니다.
보고서 스냅숏의 매개 변수 값을 변경하면 스냅숏의 구독이 비활성화됩니다 구독을 활성화하려면 구독을 열어서 저장합니다.
자세한 내용은 성능, 스냅숏, 캐싱(Reporting Services)을 참조하십시오.
맨 위로 이동
매개 변수 및 데이터 보안
자격 증명이나 중요한 정보가 포함된 매개 변수가 있는 보고서를 배포할 때는 주의해야 합니다. 사용자가 보고서 매개 변수를 다른 값으로 쉽게 바꿀 수 있으므로 원치 않는 정보가 공개될 수 있기 때문입니다.
직원 또는 개인 데이터에 대해 매개 변수를 사용하는 대신 안전하게 사용자 컬렉션의 UserID 필드가 포함된 식을 기반으로 데이터를 선택할 수 있습니다. 사용자 컬렉션은 보고서를 실행하는 사용자의 ID를 가져온 다음 이 ID를 사용하여 사용자별 데이터를 검색하는 방법을 제공합니다.
.gif "보안 정보") 보안 정보 |
|---|
String 형식의 매개 변수가 포함된 보고서에서는 유효한 값 목록이라고도 하는 사용 가능한 값 목록을 사용해야 하며 보고서를 실행하는 모든 사용자가 보고서의 데이터를 보는 데 필요한 권한만 갖도록 해야 합니다. String 유형의 매개 변수를 정의할 경우 모든 값을 사용할 수 있는 입력란이 사용자에게 제공됩니다. 사용 가능한 값 목록은 입력할 수 있는 값을 제한합니다. 보고서 매개 변수가 쿼리 매개 변수에 연결되어 있고 사용 가능한 값 목록을 사용하지 않는 경우에는 보고서 사용자가 입력란에 SQL 구문을 입력할 수 있으므로 보고서와 서버가 SQL 인젝션 공격을 받을 가능성이 있습니다. 사용자에게 새 SQL 문 실행을 위한 충분한 권한이 있으면 서버에 원하지 않은 결과가 발생할 수 있습니다. 보고서 매개 변수가 쿼리 매개 변수에 연결되어 있지 않고 매개 변수 값이 보고서에 포함된 경우에는 보고서 사용자가 식 구문 또는 URL을 매개 변수 값에 입력하고 보고서를 Excel 또는 HTML로 렌더링할 수 있습니다. 이후 다른 사용자가 보고서를 보면서 렌더링된 매개 변수 내용을 클릭할 경우 악의적인 스크립트나 링크가 실수로 실행될 수 있습니다. 악의적인 스크립트를 실수로 실행하는 위험을 줄이기 위해 신뢰할 수 있는 원본의 렌더링된 보고서만 여십시오. 보고서 보안 설정 방법은 보고서 및 리소스 보안을 참조하십시오. |
맨 위로 이동
방법 도움말 항목
이 섹션에는 매개 변수와 필터를 사용하여 작업하는 방법을 단계별로 보여 주는 절차가 나열되어 있습니다.
맨 위로 이동
관련 섹션
데이터 필터링, 그룹화 및 정렬(보고서 작성기 및 SSRS)
맨 위로 이동
참고 항목
개념
대화형 정렬, 문서 구조 및 링크(보고서 작성기 및 SSRS)
드릴스루, 드릴다운, 하위 보고서 및 중첩 데이터 영역(보고서 작성기 및 SSRS)