보고서 매개 변수(보고서 작성기 및 보고서 디자이너)Report Parameters (Report Builder and Report Designer)

이 항목에서는 Reporting ServicesReporting Services 보고서 매개 변수의 일반적인 용도와 설정할 수 있는 속성 등에 대해 설명합니다.This topic describes the common uses for Reporting ServicesReporting Services report parameters, the properties you can set, and much more. 보고서 매개 변수를 사용하면 보고서 데이터를 제어하고, 관련된 보고서를 서로 연결하고, 다양하게 보고서를 표현할 수 있습니다.Report parameters enable you to control report data, connect related reports together, and vary report presentation. 보고서 작성기Report Builder 및 보고서 디자이너에서 만드는 페이지를 매긴 보고서와 SQL Server Mobile Report PublisherSQL Server Mobile Report Publisher에서 만드는 모바일 보고서에서 보고서 매개 변수를 사용할 수 있습니다.You can use report parameters in paginated reports you create in 보고서 작성기Report Builder and Report Designer, and also in mobile reports you create in SQL Server Mobile Report PublisherSQL Server Mobile Report Publisher. 자세한 내용은 보고서 매개 변수 개념을 참조하세요.Read more about Report Parameters Concepts.

||
|-|
| 적용 대상:Applies to: 보고서 작성기Report Builder, Reporting ServicesReporting Services SharePoint 모드 및 기본 모드 보고서 작성기Report Builder, Reporting ServicesReporting Services SharePoint mode and Native mode|

직접 보고서에 매개 변수를 추가하려면 자습서: 보고서에 매개 변수 추가(보고서 작성기)에서 만드는 모바일 보고서에서 보고서 매개 변수를 사용할 수 있습니다.To try adding a parameter to a report yourself, see Tutorial: Add a Parameter to Your Report (Report Builder).

매개 변수의 일반적인 용도Common Uses for Parameters

다음은 매개 변수를 사용하는 가장 일반적인 몇 가지 방법입니다.Here are some of the most common ways to use parameters.

페이지를 매긴 보고서 및 모바일 보고서 데이터 제어Control Paginated and Mobile Report Data

  • 변수를 포함하는 데이터 집합 쿼리를 작성하여 데이터 원본에서 페이지를 매긴 보고서 데이터를 필터링합니다.Filter paginated report data at the data source by writing dataset queries that contain variables.

  • 공유 데이터 집합에서 데이터를 필터링합니다.Filter data from a shared dataset. 페이지를 매긴 보고서에 공유 데이터 집합을 추가하면 쿼리를 변경할 수 없습니다.When you add a shared dataset to a paginated report, you cannot change the query. 만들어진 보고서 매개 변수에 대한 참조가 포함되어 있는 데이터 집합 필터를 보고서에 추가할 수 있습니다.In the report, you can add a dataset filter that includes a reference to a report parameter that you create.

  • SQL ServerSQL Server 모바일 보고서의 공유 데이터 집합에서 데이터를 필터링합니다.Filter data from a shared dataset in a SQL ServerSQL Server mobile report. 자세한 내용은 Create mobile reports with SQL Server Mobile Report Publisher 을 참조하세요.See Create mobile reports with SQL Server Mobile Report Publisher for more information.

  • 사용자가 값을 지정하여 페이지를 매긴 보고서의 데이터를 사용자 지정할 수 있도록 합니다.Enable users to specify values to customize the data in a paginated report. 예를 들어 매출 데이터의 시작 날짜와 종료 날짜에 대한 두 개의 매개 변수를 제공합니다.For example, provide two parameters for the start date and end date for sales data.

    관련된 보고서 연결Connect Related Reports

  • 매개 변수를 사용하여 주 보고서를 드릴스루 보고서, 하위 보고서 및 링크된 보고서에 연결합니다.Use parameters to relate main reports to drillthrough reports, to subreports, and to linked reports. 일련의 보고서를 디자인할 때 특정 질문에 응답하도록 각 보고서를 디자인할 수 있습니다.When you design a set of reports, you can design each report to answer certain questions. 각 보고서는 관련된 세부 정보를 다른 뷰 또는 다른 수준으로 표시할 수 있습니다.Each report can provide a different view or a different level of detail for related information. 서로 관련된 일련의 보고서를 제공하려면 대상 보고서의 관련 데이터에 대한 매개 변수를 만듭니다.To provide a set of interrelated reports, create parameters for the related data on target reports.

    자세한 내용은 드릴스루 보고서(보고서 작성기 및 SSRS), 하위 보고서(보고서 작성기 및 SSRS)연결된 보고서 만들기를 참조하세요.For more information, see Drillthrough Reports (Report Builder and SSRS), Subreports (Report Builder and SSRS), and Create a Linked Report.

  • 여러 사용자에 대한 매개 변수 집합을 사용자 지정합니다.Customize sets of parameters for multiple users. 보고서 서버에서 판매 보고서를 기반으로 하는 링크된 보고서 두 개를 만듭니다.Create two linked reports based on a sales report on the report server. 한 링크된 보고서에서는 영업 사원에 대해 미리 정의된 매개 변수 값을 사용하고 링크된 나머지 보고서에서는 영업 관리자에 대해 미리 정의된 매개 변수 값을 사용합니다.One linked report uses predefined parameter values for sales persons and the second linked report uses predefined parameter values for sales managers. 두 보고서 모두 동일한 보고서 정의를 사용합니다.Both reports use the same report definition.

    다양한 보고서 표현Vary Report Presentation

  • URL 요청을 통해 보고서 서버에 보고서의 렌더링을 사용자 지정하는 명령을 보냅니다.Send commands to a report server through a URL request, to customize the rendering of a report. 자세한 내용은 URL 액세스(SSRS)URL에 보고서 매개 변수 전달을 참조하세요.For more information, see URL Access (SSRS) and Pass a Report Parameter Within a URL.

  • 사용자가 값을 지정하여 보고서 모양을 사용자 지정할 수 있도록 합니다.Enable users to specify values to help customize the appearance of a report. 예를 들어 테이블에서 중첩된 모든 행 그룹을 확장하거나 축소할 것인지 여부를 나타내는 부울 매개 변수를 제공합니다.For example, provide a Boolean parameter to indicate whether to expand or collapse all nested row groups in a table.

  • 사용자는 식에 매개 변수를 포함하여 보고서 데이터 및 모양을 사용자 지정할 수 있습니다.Enable users to customize report data and appearance by including parameters in an expression.

    자세한 내용은 매개 변수 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Parameters Collection References (Report Builder and SSRS).

매개 변수가 있는 보고서 보기Viewing a Report with Parameters

매개 변수가 있는 보고서를 보는 경우 보고서 뷰어 도구 모음에 각 매개 변수가 표시되므로 대화형으로 값을 지정할 수 있습니다.When you view a report that has parameters, the report viewer toolbar displays each parameter so you can interactively specify values. 다음 일러스트레이션에서는 @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota 및 @SalesDate 매개 변수를 포함하는 보고서의 매개 변수 영역을 보여줍니다.The following illustration shows the parameter area for a report withparameters @ReportMonth, @ReportYear, @EmployeeID, @ShowAll, @ExpandTableRows, @CategoryQuota, and @SalesDate.

매개 변수가 있는 보고서 보기View report with parameters

  1. 매개 변수 창 보고서 뷰어 도구 모음에 프롬프트와 각 매개 변수에 대한 기본값이 표시됩니다.Parameters pane The report viewer toolbar displays a prompt and default value for each parameter. 매개 변수 창에서 매개 변수 레이아웃을 사용자 지정할 수 있습니다.You can customize the layout of parameters in the parameters pane. 자세한 내용은 보고서에서 매개 변수 창 사용자 지정(보고서 작성기)에서 만드는 모바일 보고서에서 보고서 매개 변수를 사용할 수 있습니다.For more information, see Customize the Parameters Pane in a Report (Report Builder).

  2. @SalesDate 매개 변수 @SalesDate 매개 변수는 DateTime 데이터 형식입니다.@SalesDate parameter The parameter @SalesDate is data type DateTime. 날짜 선택 프롬프트가 입력란 옆에 표시됩니다.The prompt Select the Date appears next to the text box. 이 날짜를 수정하려면 입력란에 새 날짜를 입력하거나 달력 컨트롤을 사용합니다.To modify the date, type a new date in the text box or use the calendar control.

  3. @ShowAll 매개 변수 @ShowAll 매개 변수는 부울 데이터 형식입니다.@ShowAll parameter The parameter @ShowAll is data type Boolean. 라디오 단추를 사용하여 True 또는 False를 지정합니다.Use the radio buttons to specify True or False.

  4. 매개 변수 영역 핸들 표시 또는 숨기기 보고서 뷰어 도구 모음에서 이 화살표를 클릭하여 매개 변수 창을 표시하거나 숨깁니다.Show or Hide Parameter Area handle On the report viewer toolbar, click this arrow to show or hide the parameters pane.

  5. @CategoryQuota 매개 변수 @CategoryQuota 매개 변수는 부동 데이터 형식이므로 숫자 값을 사용합니다.@CategoryQuota parameter The parameter @CategoryQuota is data type Float, so it takes a numeric value. @CategoryQuota은 다중 값 허용하도록 설정됩니다.@CategoryQuota is set to allow multiple values.

  6. 보고서 보기 매개 변수 값을 입력한 후 보고서 보기 를 클릭하여 보고서를 실행합니다.View Report After you enter parameter values, click View Report to run the report. 모든 매개 변수에 기본값이 있는 경우 보고서를 처음으로 볼 때 보고서가 자동으로 실행됩니다.If all parameters have default values, the report runs automatically on first view.

매개 변수 만들기Creating Parameters

몇 가지 다른 방법으로 보고서 매개 변수를 만들 수 있습니다.You can create report parameters in a few different ways.

참고

일부 데이터 원본은 매개 변수를 지원하지 않습니다.Not all data sources support parameters.

매개 변수가 있는 저장 프로시저 또는 데이터 집합 쿼리Dataset query or stored procedure with parameters

변수를 포함하는 데이터 집합 쿼리 또는 입력 매개 변수를 포함하는 데이터 집합 저장 프로시저를 추가합니다.Add a dataset query that contains variables or a dataset stored procedure that contains input parameters. 각 변수 또는 입력 매개 변수에 대해 데이터 집합 매개 변수가 생성되며 각 데이터 집합 매개 변수에 대해 보고서 매개 변수가 생성됩니다.A dataset parameter is created for each variable or input parameter, and a report parameter is created for each dataset parameter.

보고서 작성기 매개 변수 데이터 집합 속성Report Builder Parameter Dataset Properties

보고서 작성기의 이 이미지는 다음을 보여 줍니다.This image from Report Builder shows:

  1. 보고서 데이터 창의 보고서 매개 변수The report parameters in the Report Data pane.

  2. 매개 변수가 있는 데이터 집합The dataset with the parameters.

  3. 매개 변수 창The Parameters pane.

  4. 데이터 집합 속성 대화 상자에 나열된 매개 변수The parameters listed in the Dataset Properties dialog box.

    데이터 집합은 포함하거나 공유할 수 있습니다.The dataset can be embedded or shared. 보고서에 공유 데이터 집합을 추가하면 내부로 표시된 데이터 집합 매개 변수를 보고서에서 재정의할 수 없습니다.When you add a shared dataset to a report, dataset parameters that are marked internal cannot be overridden in the report. 내부로 표시되지 않은 데이터 집합 매개 변수를 재정의할 수 있습니다.You can override dataset parameters that are not marked internal.

    자세한 내용은 이 항목의 데이터 집합 쿼리 를 참조하세요.For more information, see Dataset Query in this topic.

    수동으로 매개 변수 만들기Create a parameter manually

    보고서 데이터 창에서 매개 변수를 수동으로 만듭니다.Create a parameter manually from the Report Data pane. 사용자가 보고서 내용이나 모양을 사용자 지정하기 쉽게 대화형으로 값을 입력할 수 있도록 보고서 매개 변수를 구성할 수 있습니다.You can configure report parameters so that a user can interactively enter values to help customize the contents or appearance of a report. 사용자가 미리 구성된 값을 변경하지 못하도록 보고서 매개 변수를 구성할 수도 있습니다.You can also configure report parameters so that a user cannot change preconfigured values.

참고

매개 변수는 서버에서 독립적으로 관리되므로 새 매개 변수 설정을 가진 주 보고서를 다시 게시하더라도 보고서의 기존 매개 변수 설정을 덮어쓰지 않습니다.Because parameters are managed independently on the server, republishing a main report with new parameter settings does not overwrite the existing parameters settings on the report.

매개 변수가 있는 보고서 파트Report part with a parameter

매개 변수에 대한 참조를 포함하거나 변수가 포함된 공유 데이터 집합을 참조하는 보고서 파트를 추가합니다.Add a report part that contains references to a parameter or to a shared dataset that contains variables.

보고서 파트는 보고서 서버에 저장되며 다른 사용자가 자신의 보고서에 사용할 수 있습니다.Report parts are stored on the report server and available for others to use in their reports. 매개 변수인 보고서 파트는 보고서 서버에서 관리할 수 없습니다.Report parts that are parameters cannot be managed from the report server. 보고서 파트 갤러리에서 매개 변수를 검색하여 추가한 후에 보고서에서 구성할 수 있습니다.You can search for parameters in the Report Part Gallery and after you add them, configure them in your report. 자세한 내용은 보고서 파트(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Report Parts (Report Builder and SSRS).

참고

매개 변수는 매개 변수가 포함된 종속 데이터 집합이 있는 데이터 영역에 대해 개별 보고서 파트로 게시할 수 있습니다.Parameters can be published as a separate report part for data regions that have dependent datasets with parameters. 매개 변수는 보고서 파트로 나열되지만 보고서에 보고서 파트 매개 변수를 직접 추가할 수 없습니다.Although parameters are listed as a report part, you cannot add a report part parameter directly to a report. 대신 보고서 파트를 추가하면 보고서 파트에 의해 포함되었거나 참조되는 데이터 집합 쿼리에서 필요한 보고서 매개 변수가 자동으로 생성됩니다.Instead, add the report part, and any necessary report parameters are automatically generated from dataset queries that are contained or referenced by the report part. 보고서 파트에 대한 자세한 내용은 보고서 파트(보고서 작성기 및 SSRS)보고서 디자이너의 보고서 파트(SSRS)를 참조하세요.For more information about report parts, see Report Parts (Report Builder and SSRS) and Report Parts in Report Designer (SSRS).

매개 변수 값Parameter Values

다음은 보고서에서 매개 변수 값을 선택할 수 있는 옵션입니다.The following are options for selecting parameter values in the report.

  • 드롭다운 목록에서 단일 매개 변수 값을 선택합니다.Select a single parameter value from a drop-down list.

  • 드롭다운 목록에서 여러 매개 변수 값을 선택합니다.Select multiple parameter values from a drop-down list.

  • 드롭다운 목록에서 단일 매개 변수의 값을 선택합니다. 이 선택에 따라 드롭다운 목록에서 다른 매개 변수에 사용할 수 있는 값이 결정됩니다.Select a value from a drop-down list for one parameter, which determines the values that are available in the drop-down list for another parameter. 이들은 연계 매개 변수입니다.These are cascading parameters. 연계 매개 변수를 사용하면 수천 개 값의 매개 변수 값을 관리 가능한 수치로 연속적으로 필터링할 수 있습니다.Cascading parameters enables you to successively filter parameter values from thousands of values to a manageable number.

    자세한 내용은 보고서에 연계 매개 변수 추가(보고서 작성기 및 SSRS)에서 만드는 모바일 보고서에서 보고서 매개 변수를 사용할 수 있습니다.For more information, see Add Cascading Parameters to a Report (Report Builder and SSRS).

  • 매개 변수의 기본값이 생성되었으므로 먼저 매개 변수 값을 선택하지 않고 보고서를 실행합니다.Run the report without having to first select a parameter value because a default value has been created for the parameter.

보고서 매개 변수 속성Report Parameter Properties

보고서 속성 대화 상자를 사용하여 보고서 매개 변수 속성을 변경할 수 있습니다.You can change the report parameter properties by using the Report Properties dialog box. 다음 표에는 각 매개 변수에 대해 설정할 수 있는 속성이 요약되어 있습니다.The following table summarizes the properties that you can set for each parameter:

속성Property DescriptionDescription
이름Name 매개 변수의 대/소문자를 구분하는 이름을 입력합니다.Type a case-sensitive name for the parameter. 이 이름은 문자로 시작해야 하고 문자, 숫자 및 밑줄()을 포함할 수 있습니다.The name must begin with a letter and can have letters, numbers, an underscore (). 이름에 공백은 포함할 수 없습니다.The name cannot have spaces. 자동으로 생성된 매개 변수의 이름은 데이터 집합 쿼리의 매개 변수와 일치합니다.For automatically-generated parameters, the name matches the parameter in the dataset query. 기본적으로 수동으로 만든 매개 변수는 ReportParameter1과 이름이 유사합니다.By default, manually-created parameters are similar to ReportParameter1.
프롬프트Prompt 보고서 뷰어 도구 모음에서 매개 변수 옆에 표시되는 텍스트입니다.The text that appears next to the parameter on the report viewer toolbar.
데이터 형식Data type 보고서 매개 변수는 다음 데이터 형식 중 하나여야 합니다.A report parameter must be one of the following data types:

Boolean.Boolean. 사용자가 라디오 단추에서 True 또는 False를 선택합니다.The user selects True or False from a radio button.

DateTime.DateTime. 사용자가 달력 컨트롤에서 날짜를 선택합니다.The user selects a date from a calendar control.

Integer.Integer. 사용자가 입력란에 값을 입력합니다.The user types values in a text box.

Float.Float. 사용자가 입력란에 값을 입력합니다.The user types values in a text box.

Text.Text. 사용자가 입력란에 값을 입력합니다.The user types values in a text box.

매개 변수에 대해 사용할 수 있는 값을 정의할 때 사용자는 데이터 형식이 DateTime인 경우에도 드롭다운 목록에서 값을 선택합니다.Note that when available values are defined for a parameter, the user chooses values from a drop-down list, even when the data type is DateTime.

보고서 데이터 형식에 대한 자세한 내용은 RDL Data Types을 참조하세요.For more information about report data types, see RDL Data Types.
빈 값 허용Allow blank value 매개 변수 값에 빈 문자열이나 공백을 허용하려면 이 옵션을 선택합니다.Select this option if the value of the parameter can be an empty string or a blank.

매개 변수에 대한 유효한 값을 지정할 경우 공백 값을 유효한 값 중 하나로 허용하려면 지정한 값 중 하나로 공백 값을 포함시켜야 합니다.If you specify valid values for a parameter, and you want a blank value to be one of the valid values, you must include it as one of the values that you specify. 이 옵션을 선택해도 사용 가능한 값에 공백이 자동으로 포함되지는 않습니다.Selecting this option does not automatically include a blank for available values.
Null 값 허용Allow null value 매개 변수 값이 Null이 될 수 있도록 허용하려면 이 옵션을 선택합니다.Select this option if the value of the parameter can be a null.

매개 변수에 대한 유효한 값을 지정할 경우 null을 유효한 값 중 하나로 허용하려면 지정한 값 중 하나로 null을 포함시켜야 합니다.If you specify valid values for a parameter, and you want null to be one of the valid values, you must include null as one of the values that you specify. 이 옵션을 선택해도 사용 가능한 값에 null이 자동으로 포함되지는 않습니다.Selecting this option does not automatically include a null for available values.
다중 값 허용Allow multiple values 사용자가 선택할 수 있는 드롭다운 목록을 만드는 데 사용 가능한 값을 제공합니다.Provide available values to create a drop-down list that your users can choose from. 이렇게 하면 데이터 집합 쿼리에서 유효한 값만 제출되도록 할 수 있습니다.This is a good way to ensure that only valid values are submitted in the dataset query.

매개 변수의 값이 드롭다운 목록에 표시되는 다중 값이 될 수 있도록 허용하려면 이 옵션을 선택합니다.Select this option if the value for the parameter can be multiple values that are displayed in a drop-down list. Null 값은 허용되지 않습니다.Null values are not allowed. 이 옵션을 선택하면 매개 변수 드롭다운 목록의 사용 가능한 값 목록에 확인란이 추가되고When this option is selected, check boxes are added to the list of available values in a parameter drop-down list. 목록의 맨 위에 모두 선택에 대한 확인란이 포함됩니다.The top of the list includes a check box for Select All. 사용자는 원하는 값을 선택할 수 있습니다.Users can check the values that they want.

값을 제공하는 데이터가 빠르게 변동될 경우 사용자에게 표시되는 목록이 최신 상태가 아닐 수도 있습니다.If the data that provides values changes rapidly, the list the user sees might not be the most current.
VisibleVisible 보고서를 실행할 때 보고서 위쪽에 보고서 매개 변수를 표시하려면 이 옵션을 선택합니다.Select this option to display the report parameter at the top of the report when it is run. 이 옵션을 설정하면 사용자가 런타임에 매개 변수 값을 선택할 수 있습니다.This option allows users to select parameter values at run time.
숨김Hidden 게시된 보고서에서 보고서 매개 변수를 숨기려면 이 옵션을 선택합니다.Select this option to hide the report parameter in the published report. 보고서 매개 변수 값은 여전히 보고서 URL, 구독 정의 또는 보고서 서버에 설정할 수 있습니다.The report parameter values can still be set on a report URL, in a subscription definition, or on the report server.
내부Internal 보고서 매개 변수를 숨기려면 이 옵션을 선택합니다.Select this option to hide the report parameter. 게시된 보고서에서 보고서 매개 변수는 보고서 정의에서만 볼 수 있습니다.In the published report, the report parameter can only be viewed in the report definition.
사용 가능한 값Available values 매개 변수에 대해 사용 가능한 값을 지정한 경우에는 유효한 값이 항상 드롭다운 목록으로 표시됩니다.If you have specified available values for a parameter, the valid values always appear as a drop-down list. 예를 들어 DateTime 매개 변수에 사용할 수 있는 값을 제공하면 날짜에 대한 드롭다운 목록이 달력 컨트롤 대신 매개 변수 창에 표시됩니다.For example, if you provide available values for a DateTime parameter, a drop-down list for dates appears in the parameter pane instead of a calendar control.

값 목록이 보고서와 하위 보고서 간에 일관되도록 하려면 데이터 원본과 연관된 데이터 집합의 모든 쿼리에 단일 트랜잭션을 사용하도록 데이터 원본에서 옵션을 설정할 수 있습니다.To ensure that a list of values is consistent among a report and subreports, you can set an option on the data source to use a single transaction for all queries in the datasets that are associated with a data source.

보안 정보 텍스트 데이터 형식의 매개 변수가 포함된 보고서에서는 유효한 값 목록이라고도 하는 사용 가능한 값 목록을 사용해야 하며 보고서를 실행하는 모든 사용자가 보고서의 데이터를 보는 데 필요한 권한만 갖도록 해야 합니다.Security Note In any report that includes a parameter of data type Text, be sure to use an available values list (also known as a valid values list) and ensure that any user running the report has only the permissions necessary to view the data in the report. 자세한 내용은 보안(보고서 작성기)에서 만드는 모바일 보고서에서 보고서 매개 변수를 사용할 수 있습니다.For more information, see Security (Report Builder).
기본값Default values 쿼리 또는 정적 목록에서 기본값을 설정합니다.Set default values from a query or from a static list.

매개 변수마다 기본값이 있을 경우에는 보고서를 처음으로 볼 때 보고서가 자동으로 실행됩니다.When each parameter has a default value, the report runs automatically on first view.
고급Advanced 이 매개 변수가 보고서의 데이터에 직접 또는 간접으로 영향을 주는지를 나타내는 값인 보고서 정의 특성 UsedInQuery를 설정합니다.Set the report definition attribute UsedInQuery, a value that indicates whether this parameter directly or indirectly affects the data in a report.

새로 고칠 시기 자동으로 결정Automatically determine when to refresh
보고서 프로세서가 이 값에 대한 설정을 결정하도록 하려면 이 옵션을 선택합니다.Choose this option when you want the report processor to determine a setting for this value. 보고서 프로세서가 이 매개 변수에 대한 직접 또는 간접 참조가 있는 데이터 집합 쿼리를 검색하거나 보고서에 하위 보고서가 있으면 True 입니다.The value is True if the report processor detects a dataset query with a direct or indirect reference to this parameter, or if the report has subreports.

항상 새로 고침Always refresh
보고서 매개 변수가 데이터 집합 쿼리 또는 매개 변수 식에 직접 또는 간접으로 사용되는 경우 이 옵션을 선택합니다.Choose this option when the report parameter is used directly or indirectly in a dataset query or parameter expression. 이 옵션은 UsedInQuery 를 True로 설정합니다.This option sets UsedInQuery to True.

새로 고침 안 함Never refresh
보고서 매개 변수가 데이터 집합 쿼리 또는 매개 변수 식에 직접 또는 간접으로 사용되지 않는 경우 이 옵션을 선택합니다.Choose this option when the report parameter is not used directly or indirectly in a dataset query or parameter expression. 이 옵션은 UsedInQuery 를 False로 설정합니다.This option sets UsedInQuery to False.

주의 새로 고침 안 함은 주의해서 사용하세요.Caution Use Never Refresh with caution. 보고서 서버에서 UsedInQuery 는 보고서 데이터와 렌더링된 보고서의 캐시 옵션 및 스냅숏 보고서의 매개 변수 옵션을 제어하는 데 사용됩니다.On the report server, UsedInQuery is used to help control cache options for report data and for rendered reports, and parameter options for snapshot reports. 새로 고침 안 함 을 잘못 설정하면 잘못된 보고서 데이터 또는 보고서가 캐시되거나 스냅숏 보고서에 일치하지 않는 데이터가 포함될 수 있습니다.If you set Never Refresh incorrectly, you could cause incorrect report data or reports to be cached, or cause a snapshot report to have inconsistent data. 자세한 내용은 RDL(Report Definition Language)(SSRS)을 참조하세요.For more information, see Report Definition Language (SSRS).

데이터 집합 쿼리Dataset Query

데이터 집합 쿼리에서 데이터를 필터링하려면 결과 집합에서 포함하거나 제외할 값을 지정하여 검색된 데이터를 제한하는 제한 절을 포함합니다.To filter data in the dataset query, you can include a restriction clause that limits the retrieved data by specifying values to include or exclude from the result set.

데이터 원본에 쿼리 디자이너를 사용하여 매개 변수가 있는 쿼리를 작성할 수 있습니다.Use the query designer for the data source to help build a parameterized query.

  • Transact-SQLTransact-SQL 쿼리의 경우 서로 다른 데이터 원본이 매개 변수에 대한 서로 다른 구문을 지원합니다.For Transact-SQLTransact-SQL queries, different data sources support different syntax for parameters. 위치 또는 이름으로 쿼리에서 식별되는 매개 변수의 범위를 지원합니다.Support ranges from parameters that are identified in the query by position or by name. 자세한 내용은 보고서 데이터 집합(SSRS)에서 특정 외부 데이터 원본 형식에 대한 항목을 참조하세요.For more information, see topics for specific external data source types in Report Datasets (SSRS). 관계형 쿼리 디자이너에서 매개 변수가 있는 쿼리를 만들려면 필터에 대해 매개 변수 옵션을 선택해야 합니다.In the relational query designer, you must select the parameter option for a filter to create a parameterized query. 자세한 내용은 관계형 쿼리 디자이너 사용자 인터페이스(보고서 작성기)를 참조하세요.For more information, see Relational Query Designer User Interface (Report Builder).

  • Microsoft SQL Server Analysis Services, SAP NetWeaver BI 또는 Hyperion Essbase처럼 다차원 데이터 원본을 기반으로 하는 쿼리에서는 쿼리 디자이너에서 지정한 필터를 기반으로 하는 매개 변수를 만들 것인지 여부를 지정할 수 있습니다.For queries that are based on a multidimensional data source such as Microsoft SQL Server Analysis Services, SAP NetWeaver BI, or Hyperion Essbase, you can specify whether to create a parameter based on a filter that you specify in the query designer. 자세한 내용은 쿼리 디자이너(보고서 작성기)에서 데이터 확장 프로그램에 해당하는 쿼리 디자이너 항목을 참조하세요.For more information, see the query designer topic in Query Designers (Report Builder) that corresponds to the data extension.

게시된 보고서에 대한 매개 변수 관리Parameter Management for a Published Report

보고서를 디자인할 때는 보고서 매개 변수가 보고서 정의에 저장되고,When you design a report, report parameters are saved in the report definition. 보고서를 게시할 때는 보고서 매개 변수가 보고서 정의와 별개로 저장되고 관리됩니다.When you publish a report, report parameters are saved and managed separately from the report definition.

게시된 보고서의 경우 다음을 사용할 수 있습니다.For a published report, you can use the following:

  • 보고서 매개 변수 속성.Report parameter properties. 보고서 정의로부터 독립적으로 보고서 서버에서 보고서 매개 변수 값을 직접 변경합니다.Change report parameter values directly on the report server independently from the report definition.

  • 캐시된 보고서.Cached reports. 보고서에 대한 캐시 계획을 만들려면 각 매개 변수에 기본값이 있어야 합니다.To create a cache plan for a report, each parameter must have a default value. 자세한 내용은 보고서 캐시(SSRS)버전에서 캐시를 미리 로드할 수 있는 유일한 방법이었습니다.For more information, see Caching Reports (SSRS).

  • 캐시된 공유 데이터 집합.Cached shared datasets. 공유 데이터 집합에 대한 캐시 계획을 만들려면 각 매개 변수에 기본값이 있어야 합니다.To create a cache plan for a shared dataset, each parameter must have a default value. 자세한 내용은 보고서 캐시(SSRS)버전에서 캐시를 미리 로드할 수 있는 유일한 방법이었습니다.For more information, see Caching Reports (SSRS).

  • 링크된 보고서.Linked reports. 다양한 대상에 대한 데이터를 필터링하기 위해 미리 설정된 매개 변수 값을 사용하여 링크된 보고서를 만들 수 있습니다.You can create linked reports with preset parameter values to filter data for different audiences. 자세한 내용은 연결된 보고서 만들기를 참조하세요.For more information, see Create a Linked Report.

  • 보고서 구독.Report subscriptions. 구독을 통해 데이터를 필터링하고 보고서를 전달하는 매개 변수 값을 지정할 수 있습니다.You can specify parameter values to filter data and deliver reports through subscriptions. 자세한 내용은 구독 및 배달(Reporting Services)을 참조하세요.For more information, see Subscriptions and Delivery (Reporting Services).

  • URL 액세스.URL access. 보고서 URL에 매개 변수 값을 지정할 수 있습니다.You can specify parameter values in a URL to a report. URL 액세스를 사용하여 보고서를 실행하고 매개 변수 값을 지정할 수도 있습니다.You can also run reports and specify parameter values using URL access. 자세한 내용은 URL 액세스(SSRS)를 참조하세요.For more information, see URL Access (SSRS).

    게시된 보고서에 대한 매개 변수 속성은 일반적으로 보고서 정의를 다시 게시할 경우 유지됩니다.Parameter properties for a published report are generally preserved if you republish the report definition. 보고서 정의가 동일한 보고서로 다시 게시되고 매개 변수 이름 및 데이터 형식이 그대로 유지되면 속성 설정도 그대로 유지됩니다.If the report definition is republished as the same report, and parameter names and data types remain the same, your property settings are retained. 보고서 정의에서 매개 변수를 추가 또는 삭제하거나 데이터 형식 또는 기존 매개 변수의 이름을 변경할 경우 게시된 보고서의 매개 변수 속성을 변경해야 할 수 있습니다.If you add or delete parameters in the report definition, or change the data type or name of an existing parameter, you may need to change the parameter properties in the published report.

    매개 변수를 수정할 수 없는 경우도 있습니다.Not all parameters can be modified in all cases. 보고서 매개 변수가 데이터 집합 쿼리에서 기본값을 가져오는 경우 이 값을 게시된 보고서에 맞게 수정하거나 보고서 서버에서 수정할 수 없습니다.If a report parameter gets a default value from a dataset query, that value cannot be modified for a published report and cannot be modified on the report server. 런타임 시 사용되는 값은 쿼리를 실행할 때 결정되거나 식 기반 매개 변수의 경우 식을 계산할 때 결정됩니다.The value that is used at run time is determined when the query runs, or in the case of expression-based parameters, when the expression is evaluated.

    보고서 실행 옵션이 매개 변수 처리 방법에 영향을 줄 수 있습니다.Report execution options can affect how parameters are processed. 스냅숏으로 실행되는 보고서는 쿼리에 매개 변수의 기본값이 포함되지 않는 한 쿼리에서 파생된 매개 변수를 사용할 수 없습니다.A report that runs as a snapshot cannot use parameters that are derived from a query unless the query includes default values for the parameters.

구독 매개 변수Parameters for a Subscription

요청 시 또는 스냅숏에 대한 구독을 정의하고 구독을 처리하는 중에 사용할 매개 변수 값을 지정할 수 있습니다.You can define a subscription for an on demand or for a snapshot and specify parameter values to use during subscription processing.

  • 요청 시 실행 보고서.On demand report. 요청 시 실행 보고서의 경우 보고서에 대해 나열된 각 매개 변수의 게시된 값과는 다른 매개 변수 값을 지정할 수 있습니다.For an on demand report, you can specify a different parameter value than the published value for each parameter listed for the report. 예를 들어 Time Period 매개 변수를 사용하여 현재 날짜, 주 또는 월에 해당하는 고객 서비스 요청을 반환하는 서비스 호출 보고서가 있다고 가정합니다.For example, suppose you have a Call Service report that uses a Time Period parameter to return customer service requests for the current day, week, or month. 보고서의 기본 매개 변수 값이 today로 설정된 경우 구독에서는 다른 매개 변수 값(예: week 또는 month)을 사용하여 주 또는 월을 나타내는 숫자가 포함된 보고서를 생성할 수 있습니다.If the default parameter value for the report is set to today, your subscription can use a different parameter value (such as week or month) to produce a report that contains weekly or monthly figures.

  • 스냅숏.Snapshot. 스냅숏의 경우 구독에서는 스냅숏에 대해 정의된 매개 변수 값을 사용해야 합니다.For a snapshot, your subscription must use the parameter values defined for the snapshot. 스냅숏에 대해 정의된 매개 변수를 구독에서 재정의할 수 없습니다.Your subscription cannot override a parameter value that is defined for a snapshot. 예를 들어 보고서 스냅숏으로 실행되는 서부 지역 판매 보고서를 구독하고 스냅숏에서 지역 매개 변수 값으로 Western 을 지정한다고 가정합니다.For example, suppose you are subscribing to a Western regional sales report that runs as a report snapshot, and the snapshot specifies Western as a regional parameter value. 이 보고서에 대한 구독을 만들 경우 구독의 매개 변수 값으로 Western 을 사용해야 합니다.In this case, if you create a subscription to this report, you must use the parameter value Western in your subscription. 매개 변수 무시를 시각적으로 나타내기 위해 구독 페이지의 매개 변수 필드는 읽기 전용 필드로 설정됩니다.To provide a visual indication that the parameter is ignored, the parameter fields on the subscription page are set to read-only fields.

    보고서 실행 옵션이 매개 변수 처리 방법에 영향을 줄 수 있습니다.Report execution options can affect how parameters are processed. 보고서 스냅숏으로 실행되는 매개 변수가 있는 보고서는 보고서 스냅숏에 대해 정의된 매개 변수 값을 사용합니다.Parameterized reports that run as report snapshots use the parameter values defined for the report snapshot. 매개 변수 값은 보고서의 매개 변수 속성 페이지에 정의됩니다.Parameter values are defined in the parameter properties page of the report. 스냅숏으로 실행되는 보고서는 쿼리에 매개 변수의 기본값이 포함되지 않는 한 쿼리에서 파생된 매개 변수를 사용할 수 없습니다.A report that runs as a snapshot cannot use parameters that are derived from a query unless the query includes default values for the parameters.

    구독을 정의한 후 보고서 스냅숏의 매개 변수 값을 변경하면 보고서 서버에서 구독이 비활성화됩니다.If a parameter value changes in the report snapshot after the subscription is defined, the report server deactivates the subscription. 구독을 비활성화하면 보고서가 수정된 것으로 표시됩니다.Deactivating the subscription indicates that the report has been modified. 구독을 활성화하려면 구독을 열어서 저장합니다.To activate the subscription, open and then save the subscription.

참고

데이터 기반 구독은 구독자 데이터 원본에서 가져오는 매개 변수 값을 사용할 수 있습니다.Data-driven subscriptions can use parameter values that are obtained from a subscriber data source. 자세한 내용은 구독자 데이터에 외부 데이터 원본 사용(데이터 기반 구독)을 참조하세요.For more information, see Use an External Data Source for Subscriber Data (Data-Driven Subscription).

자세한 내용은 구독 및 배달(Reporting Services)을 참조하세요.For more information, see Subscriptions and Delivery (Reporting Services).

매개 변수 및 데이터 보안Parameters and Securing Data

자격 증명이나 중요한 정보가 포함된 매개 변수가 있는 보고서를 배포할 때는 주의해야 합니다.Use caution when distributing parameterized reports that contain confidential or sensitive information. 사용자가 보고서 매개 변수를 다른 값으로 쉽게 바꿀 수 있으므로 원치 않는 정보가 공개될 수 있기 때문입니다.A user can easily replace a report parameter with a different value, resulting in information disclosure that you did not intend.

직원 또는 개인 데이터에 대해 매개 변수를 사용하는 대신 안전하게 사용자 컬렉션의 UserID 필드가 포함된 식을 기반으로 데이터를 선택할 수 있습니다.A secure alternative to using parameters for employee or personal data is to select data based on expressions that include the UserID field from the Users collection. 사용자 컬렉션은 보고서를 실행하는 사용자의 ID를 가져온 다음 이 ID를 사용하여 사용자별 데이터를 검색하는 방법을 제공합니다.The Users collection provides a way to get the identity of the user running the report, and use that identity to retrieve user-specific data.

중요

String형식의 매개 변수가 포함된 보고서에서는 유효한 값 목록이라고도 하는 사용 가능한 값 목록을 사용해야 하며 보고서를 실행하는 모든 사용자가 보고서의 데이터를 보는 데 필요한 권한만 갖도록 해야 합니다.In any report that includes a parameter of type String, be sure to use an available values list (also known as a valid values list) and ensure that any user running the report has only the permissions necessary to view the data in the report. String유형의 매개 변수를 정의할 경우 모든 값을 사용할 수 있는 입력란이 사용자에게 제공됩니다.When you define a parameter of type String, the user is presented with a text box that can take any value. 사용 가능한 값 목록은 입력할 수 있는 값을 제한합니다.An available values list limits the values that can be entered. 보고서 매개 변수가 데이터 집합 매개 변수에 연결되어 있고 사용 가능한 값 목록을 사용하지 않는 경우에는 보고서 사용자가 입력란에 SQL 구문을 입력할 수 있으므로 보고서와 서버가 SQL 인젝션 공격을 받을 가능성이 있습니다.If the report parameter is tied to a dataset parameter and you do not use an available values list, it is possible for a report user to type SQL syntax into the text box, potentially opening the report and your server to a SQL injection attack. 사용자에게 새 SQL 문 실행을 위한 충분한 권한이 있으면 서버에 원하지 않은 결과가 발생할 수 있습니다.If the user has sufficient permissions to execute the new SQL statement, it may produce unwanted results on the server.

보고서 매개 변수가 데이터 집합 매개 변수에 연결되어 있지 않고 매개 변수 값이 보고서에 포함된 경우에는 보고서 사용자가 식 구문 또는 URL을 매개 변수 값에 입력하고 보고서를 Excel 또는 HTML로 렌더링할 수 있습니다.If a report parameter is not tied to a dataset parameter and the parameter values are included in the report, it is possible for a report user to type expression syntax or a URL into the parameter value, and render the report to Excel or HTML. 이후 다른 사용자가 보고서를 보면서 렌더링된 매개 변수 내용을 클릭할 경우 악의적인 스크립트나 링크가 실수로 실행될 수 있습니다.If another user then views the report and clicks the rendered parameter contents, the user may inadvertently execute the malicious script or link.

악의적인 스크립트를 실수로 실행하는 위험을 줄이기 위해 신뢰할 수 있는 원본의 렌더링된 보고서만 여세요.To mitigate the risk of inadvertently running malicious scripts, open rendered reports only from trusted sources. 보고서를 안전하게 보호하는 방법에 대한 자세한 내용은 보고서 및 리소스 보안을 참조하세요.For more information about securing reports, see Secure Reports and Resources.

방법 도움말 항목How-To Topics

이 섹션에는 매개 변수와 필터를 사용하여 작업하는 방법을 단계별로 보여 주는 절차가 나열되어 있습니다.This section lists procedures that show you, step by step, how to work with parameters and filters.

SSRS 보고서 매개 변수(퀴즈) 구성(영문)Configuring SSRS Report Parameters (quiz)

자습서: 보고서에 매개 변수 추가(보고서 작성기)Tutorial: Add a Parameter to Your Report (Report Builder)

보고서 매개 변수 개념Report Parameters Concepts

보고서 예제(보고서 작성기 및 SSRS)Report Samples (Report Builder and SSRS)

보고서에 사용되는 식(보고서 작성기 및 SSRS)Expression Uses in Reports (Report Builder and SSRS)

식(보고서 작성기 및 SSRS)Expressions (Report Builder and SSRS)

데이터 필터링, 그룹화 및 정렬(보고서 작성기 및 SSRS)Filter, Group, and Sort Data (Report Builder and SSRS)

보안(보고서 작성기)Security (Report Builder)

대화형 정렬, 문서 구조 및 링크(보고서 작성기 및 SSRS)Interactive Sort, Document Maps, and Links (Report Builder and SSRS)

드릴스루, 드릴다운, 하위 보고서 및 중첩 데이터 영역(보고서 작성기 및 SSRS)Drillthrough, Drilldown, Subreports, and Nested Data Regions (Report Builder and SSRS)