보고서 매개 변수 개념(보고서 작성기 및 SSRS)Report Parameters Concepts (Report Builder and SSRS)

보고서에 매개 변수를 추가하여 관련 보고서를 연결하거나 보고서 모양을 제어하거나 보고서 데이터를 필터링하거나 보고서 범위를 특정 사용자나 위치로 좁힐 수 있습니다.You can add parameters to a report to link related reports, to control the report appearance, to filter report data, or to narrow the scope of a report to specific users or locations.

참고

SQL Server Data Tools의 보고서 작성기 및 보고서 디자이너에서 페이지를 매긴 보고서 정의(.rdl) 파일을 만들고 수정할 수 있습니다.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다.Each authoring environment provides different ways to create, open, and save reports and related items.

보고서 매개 변수는 다음과 같은 방법으로 생성됩니다.Report parameters are created in the following ways:

  • 쿼리 변수가 포함된 데이터 집합 쿼리를 정의할 때 자동으로 생성됩니다.Automatically, when you define dataset query that contains query variables. 각 쿼리 변수의 경우 해당 데이터 집합 쿼리 매개 변수 및 보고서 매개 변수가 같은 이름으로 생성됩니다.For each query variable, a corresponding dataset query parameter and report parameter with the same names are created. 쿼리 매개 변수는 저장 프로시저의 입력 매개 변수 또는 쿼리 변수에 대한 참조일 수 있습니다.A query parameter can be a reference to a query variable or to an input parameter for a stored procedure.

  • 쿼리 집합 매개 변수가 포함된 공유 데이터 집합에 참조를 추가할 때 자동으로 생성됩니다.Automatically, when you add a reference to a shared dataset that contains query parameters.

  • 보고서 데이터 창에서 보고서 매개 변수를 만들 때 수동으로 생성됩니다.Manually, when you create report parameters in the Report Data pane. 매개 변수는 보고서의 식에 포함할 수 있는 기본 제공 컬렉션 중 하나입니다.Parameters are one of the built-in collections that you can include in an expression in a report. 보고서 정의 전반에서 값을 정의하는 데 식이 사용되기 때문에 매개 변수를 사용하여 보고서 모양을 제어하거나 관련 하위 보고서나 매개 변수를 사용하는 다른 보고서에 값을 전달할 수 있습니다.Because expressions are used to define values throughout a report definition, you can use parameters to control report appearance or to pass values to related subreports or reports that also use parameters.

    자세한 내용은 보고서 매개 변수(보고서 작성기 및 보고서 디자이너)에 대해 자세히 알아봅니다.For more information, see Report Parameters (Report Builder and Report Designer).

    데이터가 보고서에 반환되기 전과 후에 매개 변수가 보고서 데이터를 필터링하는 데 자주 사용됩니다.Parameters are frequently used to filter report data both before and after the data is returned to the report. 자세한 내용은 데이터 필터링, 그룹화 및 정렬(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Filter, Group, and Sort Data (Report Builder and SSRS).

    보고서를 디자인할 때는 보고서 매개 변수가 보고서 정의에 저장되고,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. 보고서를 보고서 서버에 저장한 후 다음을 수행할 수 있습니다.After you save the report to the report server, you can do the following:

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

  • 각 링크된 보고서가 보고서 서버에서 독립적으로 관리될 수 있는 별도의 매개 변수 값 집합이 포함된 보고서 정의에 대한 링크인 여러 링크된 보고서를 만듭니다.Create multiple linked reports in which each linked report is a link to the report definition with a separate set of parameter values that can be managed independently on the report server.

    보고서 스냅숏, 기록 또는 게시된 보고서에 대한 구독을 만들려는 경우 보고서 매개 변수가 보고서의 디자인 요구 사항에 미치는 영향을 이해해야 합니다.If you plan to create report snapshots, histories, or subscriptions to a published report, you must understand how report parameters affect the design requirements for the report.

관련 항목:See Also

보고서 제작 개념(보고서 작성기 및 SSRS) Report Authoring Concepts (Report Builder and SSRS)
보고서 포함된 데이터 집합 및 공유 데이터 집합(보고서 작성기 및 SSRS) Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)
자습서: 보고서에 매개 변수 추가(보고서 작성기)Tutorial: Add a Parameter to Your Report (Report Builder)