텍스트 기반 쿼리 디자이너 사용자 인터페이스(보고서 작성기)Text-based Query Designer User Interface (Report Builder)

텍스트 기반 쿼리 디자이너에서 데이터 원본에서 지원하는 쿼리 언어를 사용하여 쿼리를 지정하고, 쿼리를 실행하고, 디자인 타임에 결과를 볼 수 있습니다.Use the text-based query designer to specify a query using the query language supported by the data source, run the query, and view the results at design time. 여러 개의 Transact-SQLTransact-SQL 문, 사용자 지정 데이터 처리 확장 프로그램에 대한 쿼리 또는 명령 구문, 식으로 지정된 쿼리를 지정할 수 있습니다.You can specify multiple Transact-SQLTransact-SQL statements, query or command syntax for custom data processing extensions, and queries that are specified as expressions. 텍스트 기반 쿼리 디자이너는 쿼리를 전처리하지 않고 모든 종류의 쿼리 구문을 포함할 수 있으므로 많은 데이터 원본 유형에 대한 기본 쿼리 디자이너 도구입니다.Because the text-based query designer does not preprocess the query and can accommodate any kind of query syntax, this is the default query designer tool for many data source types.

중요

사용자는 쿼리를 작성하고 실행할 때 데이터 원본에 액세스합니다.Users access data sources when they create and run queries. 데이터 원본에 대해서는 읽기 전용 권한과 같이 최소한의 사용 권한을 부여해야 합니다.You should grant minimal permissions on the data sources, such as read-only permissions.

텍스트 기반 쿼리 디자이너에서는 도구 모음과 다음과 같은 두 개의 창이 표시됩니다.The text-based query designer displays a toolbar and the following two panes:

  • 쿼리 쿼리 유형에 따라 쿼리 텍스트, 테이블 이름 또는 저장 프로시저 이름을 표시합니다.Query Shows the query text, table name, or stored procedure name depending on the query type. 모든 데이터 원본 유형에서 모든 쿼리 유형을 사용할 수 있는 것은 아닙니다.Not all query types are available for all data source types. 예를 들어 테이블 이름은 OLE DB와 같은 데이터 원본 유형에만 지원됩니다.For example, table name is supported only for the data source type OLE DB.

  • 결과 디자인 타임에 쿼리 실행 결과를 표시합니다.Result Shows the results of running the query at design time.

텍스트 기반 쿼리 디자이너 도구 모음Text-based Query Designer Toolbar

텍스트 쿼리 디자이너는 모든 명령 유형을 위한 단일 도구 모음을 제공합니다.The text-based query designer provides a single toolbar for all the command types. 다음 표에서는 도구 모음에 있는 각 단추와 해당 기능을 나열합니다.The following table lists each button on the toolbar and its function.

단추Button DescriptionDescription
텍스트로 편집Edit As Text 텍스트 기반 쿼리 디자이너와 그래픽 쿼리 디자이너 사이를 전환합니다.Toggle between the text-based query designer and the graphical query designer. 모든 데이터 원본 유형에서 그래픽 쿼리 디자이너를 지원하는 것은 아닙니다.Not all data source types support graphical query designers.
가져오기Import 파일 또는 보고서에서 기존 쿼리를 가져옵니다.Import an existing query from a file or report. sql 및 rdl 파일 형식만 지원됩니다.Only file types sql and rdl are supported
쿼리 실행Run the query 쿼리를 실행하고 결과 창에 결과 집합을 표시합니다.Run the query and display the result set in the Result pane.
명령 유형Command Type Text, StoredProcedure또는 TableDirect를 선택합니다.Select Text, StoredProcedure, or TableDirect. 저장 프로시저에 매개 변수가 있을 경우 도구 모음에서 실행 을 클릭하면 쿼리 매개 변수 정의 대화 상자가 표시되며 필요에 따라 값을 입력할 수 있습니다.If a stored procedure has parameters, the Define Query Parameters dialog box appears when you click Run on the toolbar, and you can fill in values as needed. 명령 유형에 대한 지원은 데이터 원본 유형에 따라 달라집니다.Support for command type varies by data source type. 예를 들어 OLE DB 및 ODBC의 경우에만 TableDirect를 지원합니다.For example, only OLE DB and ODBC support TableDirect.

참고: 저장 프로시저에서 둘 이상의 결과 집합을 반환할 경우 첫 번째 결과 집합만 데이터 집합을 채우는 데 사용됩니다.Note: If a stored procedure returns more than one result set, only the first result set is used to populate the dataset.

Text 명령 유형Command Type Text

SQL ServerSQL Server 데이터 집합을 만들 때 기본적으로 관계형 쿼리 디자이너가 열립니다.When you create a SQL ServerSQL Server dataset, the relational query designer opens by default. 텍스트 기반 쿼리 디자이너로 전환하려면 도구 모음에서 텍스트로 편집 토글 단추를 클릭합니다.To switch to the text-based query designer, click the Edit As Text toggle button on the toolbar. 텍스트 기반 쿼리 디자이너에는 쿼리 창 및 결과 창이 제공됩니다.The text-based query designer presents two panes: the Query pane and the Result pane. 다음 그림에서는 레이블과 함께 각 창을 보여 줍니다.The following figure labels each pane.

관계형 데이터 쿼리를 위한 일반 쿼리 디자이너Generic query designer, for relational data query

다음 표에서는 각 창의 기능을 설명합니다.The following table describes the function of each pane.

Pane 함수Function
쿼리Query Transact-SQLTransact-SQL 쿼리 텍스트를 표시합니다.Displays the Transact-SQLTransact-SQL query text. 이 창을 사용하여 Transact-SQLTransact-SQL 쿼리를 작성하거나 편집할 수 있습니다.Use this pane to write or edit a Transact-SQLTransact-SQL query.
결과Result 쿼리 결과를 표시합니다.Displays the results of the query. 쿼리를 실행하려면 아무 창이나 마우스 오른쪽 단추로 클릭한 다음 실행을 클릭하거나 도구 모음에서 실행 단추를 클릭합니다.To run the query, right-click in any pane and click Run, or click the Run button on the toolbar.

예제Example

다음 쿼리는 AdventureWorks2014 데이터베이스 ContactType 테이블에서 Person 스키마에 대한 이름 목록을 반환합니다.The following query returns the list of names from the AdventureWorks2014 database ContactType table for the Person schema.

SELECT Name FROM Person.ContactType  

도구 모음에서 실행 을 클릭할 경우 쿼리 창의 명령이 실행되고 결과 창에 결과가 표시됩니다.When you click Run on the toolbar, the command in the Query pane runs and the results are displayed in the Result pane. 결과 집합에 소유자 또는 영업 담당자 등의 20가지 연락처 유형이 있는 목록이 표시됩니다.The resultset displays a list of 20 types of contacts, for example, Owner or Sales Agent.

StoredProcedure 명령 유형Command Type StoredProcedure

명령 typeStoredProcedure를 선택하면 텍스트 기반 쿼리 디자이너에 쿼리 창 및 결과 창이 제공됩니다.When you select Command typeStoredProcedure, the text-based query designer presents two panes: the Query pane and the Result pane. 쿼리 창에 저장 프로시저 이름을 입력하고 도구 모음에서 실행 을 클릭합니다.Enter the stored procedure name in the Query pane and click Run on the toolbar. 저장 프로시저에서 매개 변수를 사용하는 경우 쿼리 매개 변수 정의 대화 상자가 열립니다.If the stored procedures uses parameters, the Define Query Parameters dialog box opens. 저장 프로시저에 대한 매개 변수 값을 입력합니다.Enter the parameter values for the stored procedure. 모든 저장 프로시저 입력 매개 변수에 대해 보고서 매개 변수가 생성됩니다.A report parameter is created for every stored procedure input parameter.

다음 그림에서는 저장 프로시저를 실행할 때 쿼리 및 결과 창을 보여 줍니다.The following figure shows the Query and Results panes when you run a stored procedure. 이 경우 입력 매개 변수는 상수입니다.In this case, the input parameters are constants.

텍스트 기반 쿼리 디자이너의 저장 프로시저Stored procedure in text-based query designer

다음 표에서는 각 창의 기능을 설명합니다.The following table describes the function of each pane.

Pane 함수Function
쿼리Query 저장 프로시저의 이름 및 입력 매개 변수(있는 경우)를 표시합니다.Displays the name of the stored procedure and any input parameters.
결과Result 쿼리 결과를 표시합니다.Displays the results of the query. 쿼리를 실행하려면 아무 창이나 마우스 오른쪽 단추로 클릭한 다음 실행을 클릭하거나 도구 모음에서 실행 단추를 클릭합니다.To run the query, right-click in any pane and click Run, or click the Run button on the toolbar.

예제Example

다음 쿼리는 AdventureWorks2014 저장 프로시저 uspGetWhereUsedProductID을 호출합니다.The following query calls the AdventureWorks2014 stored procedure uspGetWhereUsedProductID. 쿼리를 실행할 때 제품 ID 번호 매개 변수에 대한 값을 입력해야 합니다.You must enter a value for the product identification number parameter when you run the query.

uspGetWhereUsedProductID  

실행 (!) 단추를 클릭합니다.Click the Run (!) button. 쿼리 매개 변수를 입력하라는 메시지가 표시되면 다음 표를 사용하여 값을 입력합니다.When prompted for the query parameters, use the following table to enter values.

@StartProductID 820820
@CheckDate 2001011520010115

지정된 날짜에 대해 지정된 구성 요소 번호가 사용된 13개 제품 ID가 있는 목록이 결과 집합에 표시됩니다.For the specified date, the result set displays a list of 13 product identifiers that used the specified component number.

TableDirect 명령 유형Command Type TableDirect

명령 typeTableDirect를 선택하면 텍스트 기반 쿼리 디자이너에 쿼리 창 및 결과 창이 제공됩니다.When you select Command typeTableDirect, the text-based query designer presents two panes: the Query pane and the Result pane. 테이블을 입력하고 실행 단추를 클릭할 경우 해당 테이블의 모든 열이 반환됩니다.When you enter a table and click the Run button, all the columns for that table are returned.

예제Example

OLE DB 데이터 원본 유형의 경우 다음 데이터 집합 쿼리는 AdventureWorks2014 데이터베이스에 있는 모든 연락처 유형에 대한 결과 집합을 반환합니다.For a data source type OLE DB, the following dataset query returns a result set for all contact types in the AdventureWorks2014 database.

Person.ContactType

테이블 이름 Person.ContactType을 입력하면 Transact-SQLTransact-SQLSELECT * FROM Person.ContactType을 만드는 것과 동일합니다.When you enter the table name Person.ContactType, it is the equivalent of creating the Transact-SQLTransact-SQL statement SELECT * FROM Person.ContactType.

관련 항목:See Also

관계형 쿼리 디자이너 사용자 인터페이스(보고서 작성기) Relational Query Designer User Interface (Report Builder)
쿼리 디자이너(보고서 작성기)Query Designers (Report Builder)