SQL Azure 연결 형식(SSRS)SQL Azure Connection Type (SSRS)

MicrosoftMicrosoft Azure SQL 데이터베이스Azure SQL DatabaseSQL ServerSQL Server 기술을 기반으로 작성된 클라우드 기반의 호스트되는 관계형 데이터베이스입니다. Azure SQL 데이터베이스Azure SQL Database is a cloud-based, hosted relational database built on SQL ServerSQL Server technologies. 보고서에 SQL 데이터베이스SQL Database 의 데이터를 포함하려면 SQL 데이터베이스SQL Database유형의 보고서 데이터 원본을 기반으로 하는 데이터 집합이 있어야 합니다.To include data from SQL 데이터베이스SQL Database in your report, you must have a dataset that is based on a report data source of type SQL 데이터베이스SQL Database. 이 기본 제공 데이터 원본 유형은 SQL 데이터베이스SQL Database 데이터 확장 프로그램을 기반으로 합니다.This built-in data source type is based on the SQL 데이터베이스SQL Database data extension. 이 데이터 원본 유형을 사용하여 SQL 데이터베이스SQL Database에 연결하고 데이터를 검색할 수 있습니다.Use this data source type to connect to and retrieve data from SQL 데이터베이스SQL Database.

이 데이터 확장 프로그램은 다중값 매개 변수, 서버 집계 및 연결 문자열과 별개로 관리되는 자격 증명을 지원합니다.This data extension supports multivalued parameters, server aggregates, and credentials managed separately from the connection string.

SQL 데이터베이스SQL Database 가 사용자 컴퓨터의 SQL ServerSQL Server 인스턴스와 비슷하기 때문에 SQL 데이터베이스SQL Database 에서 데이터를 가져오는 방법은 몇 가지 예외를 제외하고 SQL ServerSQL Server에서 데이터를 가져오는 방법과 동일합니다. is similar to an instance of SQL ServerSQL Server on your premises and getting data from SQL 데이터베이스SQL Database is, with a few exceptions, identical to getting data from SQL ServerSQL Server.

참고

SQL 데이터베이스SQL Database에 대한 연결을 열 때 연결 시간 제한을 30초로 설정하세요.When opening a connection to a SQL 데이터베이스SQL Database, set the connection timeout to 30 seconds.

자세한 내용은 docs.microsoft.com의 Microsoft Azure SQL Database를 참조하세요.For more information, see Microsoft Azure SQL Database on docs.microsoft.com.

이 항목의 정보를 사용하여 데이터 원본을 작성할 수 있습니다.Use the information in this topic to build a data source. 단계별 지침은 데이터 연결 추가 및 확인(보고서 작성기 및 SSRS)을 참조하세요.For step-by-step instructions, see Add and Verify a Data Connection (Report Builder and SSRS).

연결 문자열Connection String

SQL 데이터베이스SQL Database에 연결하면 클라우드의 데이터베이스 개체에 연결하게 됩니다.When you connect to SQL 데이터베이스SQL Database, you are connecting to a database object in the cloud. 온사이트 데이터베이스와 마찬가지로 호스팅되는 데이터베이스에는 여러 테이블, 뷰 및 저장 프로시저가 있는 스키마가 여러 개 있을 수 있으므로Just like onsite databases, the hosted database might have multiple schemas that have multiple tables, views, and stored procedures. 쿼리 디자이너에서 사용할 데이터베이스 개체를 지정합니다.You specify the database object to use in the query designer. 연결 문자열에 데이터베이스를 지정하지 않을 경우 관리자가 할당한 기본 데이터베이스에 연결됩니다.If you do not specify a database in the connection string, you connect to the default database that the administrator assigned to you.

데이터 원본 연결에 사용할 자격 증명 및 연결 정보는 데이터베이스 관리자에게 문의하십시오.Contact your database administrator for connection information and for the credentials to use to connect to the data source. 다음 연결 문자열 예에서는 AdventureWorks라는 호스팅되는 예제 데이터베이스를 지정합니다.The following connection string example specifies a hosted sample database named AdventureWorks.

Data Source=<host>;Initial Catalog=AdventureWorks; Encrypt=True;  

또한 데이터 원본 속성 대화 상자를 사용하여 사용자 이름과 암호 같은 자격 증명을 제공할 수 있습니다.In addition, you use the Data Sources Properties dialog box to provide credentials such as user name and password. 그러면 User IdPassword 옵션이 자동으로 연결 문자열에 추가되기 때문에 이러한 옵션을 연결 문자열의 일부로 입력할 필요가 없습니다.The User Id and Password options are automatically appended to the connection string; you do not need to type them as part of the connection string.

자세한 내용 및 연결 문자열 예제는 보고서 작성기의 데이터 연결, 데이터 원본 및 연결 문자열을 참조하세요.For more information and connection string examples, see Data Connections, Data Sources, and Connection Strings in Report Builder.

자격 증명Credentials

Windows 인증(통합 보안)이 지원되지 않기 때문에Windows Authentication (integrated security) is not supported. Windows 인증을 사용하여 SQL 데이터베이스SQL Database 에 연결하려고 하면 오류가 발생합니다.If you attempt to connect to SQL 데이터베이스SQL Database using Windows Authentication an error occurs. SQL 데이터베이스SQL Database 에서는 SQL Server 인증(사용자 이름 및 암호)만 지원하므로 SQL 데이터베이스SQL Database에 연결할 때마다 자격 증명(로그인 및 암호)을 제공해야 합니다. supports only SQL Server Authentication (user name and password) and users must provide credentials (login and password) every time they connect to SQL 데이터베이스SQL Database.

자격 증명에는 데이터베이스에 액세스할 수 있는 권한이 있어야 합니다.Credentials must be sufficient to access the database. 쿼리에 따라 저장 프로시저를 실행하고 테이블 및 뷰에 액세스할 수 있는 권한과 같은 다른 사용 권한이 필요할 수 있습니다.Depending on your query, you might need other permissions, such as sufficient permissions to run stored procedures and access tables and views. 외부 데이터 원본의 소유자는 사용자에게 필요한 데이터베이스 개체에 대한 읽기 전용 권한을 제공할 수 있는 자격 증명을 구성해야 합니다.The owner of the external data source must configure credentials that are sufficient to provide read-only access to the database objects that you need.

보고서 작성 클라이언트에서는 다음 옵션을 사용하여 자격 증명을 지정할 수 있습니다.From a report authoring client, the following options are available to specify credentials:

쿼리Queries

쿼리는 보고서 데이터 집합에 대해 검색할 데이터를 지정합니다.A query specifies which data to retrieve for a report dataset. 쿼리 결과 집합의 열은 데이터 집합의 필드 컬렉션을 채웁니다.The columns in the result set for a query populate the field collection for a dataset. 쿼리가 여러 결과 집합을 반환할 경우 보고서는 쿼리가 검색한 첫 번째 결과 집합만 처리합니다.If the query returns multiple result sets, the report processes only the first result set that the query retrieves. SQL ServerSQL Server 과(와) SQL 데이터베이스SQL Database은(는) 지원되는 데이터베이스 크기 등이 다를 수 있지만 SQL 데이터베이스SQL Database에 대한 쿼리를 작성하는 방법과 SQL ServerSQL Server 데이터베이스에 대한 쿼리를 작성하는 방법은 비슷합니다.Although there are some differences between SQL ServerSQL Server and SQL 데이터베이스SQL Databases such as the sizes of databases supported, writing queries against SQL 데이터베이스SQL Databases is similar to writing queries against SQL ServerSQL Server databases. BACKUP과 같은 일부 Transact-SQLTransact-SQL 문은 SQL 데이터베이스SQL Database에서 지원되지 않지만 이러한 문은 보고서 쿼리에 사용하는 문이 아닙니다.Some Transact-SQLTransact-SQL statements such as BACKUP are not supported in SQL 데이터베이스SQL Database, but they are not ones that you use in report queries. 자세한 내용은 SQL Server 연결 형식(SSRS)을 참조하세요.For more information, see SQL Server Connection Type (SSRS).

기본적으로 그래픽 쿼리 디자이너에 나타낼 수 있는 새 쿼리를 만들거나 기존 쿼리를 열 경우 관계형 쿼리 디자이너를 사용할 수 있습니다.By default, if you create a new query or open an existing query that can be represented in the graphical query designer, the relational query designer is available. 다음과 같은 방법으로 쿼리를 지정할 수 있습니다.You can specify a query in the following ways:

  • 대화식으로 쿼리를 작성합니다.Build a query interactively. 관계형 쿼리 디자이너를 사용합니다. 관계형 쿼리 디자이너는 테이블, 뷰, 저장 프로시저 및 기타 데이터베이스 항목을 데이터베이스 스키마별로 구성하여 계층 구조로 표시합니다.Use the relational query designer that displays a hierarchical view of tables, views, stored procedures, and other database items, organized by database schema. 테이블 또는 뷰에서 열을 선택하거나 저장 프로시저 또는 테이블 반환 함수를 지정합니다.Select columns from tables or views, or specify stored procedures or table-valued functions. 필터 조건을 지정하여 검색할 데이터 행 수를 제한합니다.Limit the number of rows of data to retrieve by specifying filter criteria. 매개 변수 옵션을 설정하여 보고서를 실행할 때 필터를 사용자 지정합니다.Customize the filter when the report runs by setting the parameter option.

  • 쿼리를 입력하거나 붙여넣습니다.Type or paste a query. 텍스트 기반 쿼리 디자이너를 사용하여 Transact-SQLTransact-SQL 텍스트를 직접 입력하거나, 다른 원본에서 쿼리 텍스트를 붙여넣거나, 관계형 쿼리 디자이너를 사용하여 작성할 수 없는 복잡한 쿼리를 입력하거나, 쿼리 기반 식을 입력할 수 있습니다.Use the text-based query designer to enter Transact-SQLTransact-SQL text directly, to paste query text from another source, to enter complex queries that cannot be built by using the relational query designer, or to enter query-based expressions.

  • 파일 또는 보고서에서 기존 쿼리를 가져옵니다.Import an existing query from a file or report. 쿼리 디자이너에서 쿼리 가져오기 단추를 사용하여 .sql 파일 또는 .rdl 파일을 찾아서 쿼리를 가져옵니다.Use the Import query button from either query designer to browse to a .sql file or .rdl file and import a query.

    텍스트 기반 쿼리 디자이너에서는 다음과 같은 두 가지 모드를 지원합니다.The text-based query designer supports the following two modes:

  • 텍스트 데이터 원본에서 데이터를 선택하는 Transact-SQLTransact-SQL 명령을 입력합니다.Text Type Transact-SQLTransact-SQL commands that select data from the data source.

  • Stored Procedure 저장 프로시저 목록에서 선택합니다.Stored Procedure Choose from a list of stored procedures.

    자세한 내용은 관계형 쿼리 디자이너 사용자 인터페이스(보고서 작성기)텍스트 기반 쿼리 디자이너 사용자 인터페이스(보고서 작성기)를 참조하세요.For more information, see Relational Query Designer User Interface (Report Builder) and Text-based Query Designer User Interface (Report Builder).

    SQL 데이터베이스SQL Database 에서 사용하는 그래픽 쿼리 디자이너는 요약 데이터만 검색하는 쿼리를 작성하는 데 도움이 되는 그룹화 및 집계를 기본적으로 지원합니다.The graphical query designer that SQL 데이터베이스SQL Database uses provides built-in support for grouping and aggregates to help you write queries that retrieve only summary data. Transact-SQLTransact-SQL 언어 기능은 GROUP BY 절, DISTINCT 키워드 및 SUM, COUNT 등과 같은 집계입니다.The Transact-SQLTransact-SQL language features are: the GROUP BY clause, DISTINCT keyword, and aggregates such as SUM and COUNT. 텍스트 기반 쿼리 디자이너는 그룹화 및 집계를 비롯한 Transact-SQLTransact-SQL 언어를 완벽하게 지원합니다.The text-based query designer provides full support for the Transact-SQLTransact-SQL language, including grouping and aggregates. Transact-SQLTransact-SQL에 대한 자세한 내용은 msdn.microsoft.com의 SQL ServerSQL Server 온라인 설명서에서 Transact-SQL 참조(데이터베이스 엔진)를 참조하세요.For more information about Transact-SQLTransact-SQL, see Transact-SQL Reference (Database Engine)in SQL ServerSQL Server Books Online on msdn.microsoft.com.

Text 쿼리 유형 사용Using Query Type Text

텍스트 기반 쿼리 디자이너에서는 Transact-SQLTransact-SQL 명령을 입력하여 데이터 집합의 데이터를 정의합니다.In the text-based query designer, you type Transact-SQLTransact-SQL commands to define the data in a dataset. 예를 들어 다음 Transact-SQLTransact-SQL 쿼리는 마케팅 지원을 담당하는 모든 직원의 이름을 선택합니다.For example, the following Transact-SQLTransact-SQL query selects the names of all employees who are marketing assistants:

SELECT  
  HumanResources.Employee.BusinessEntityID  
  ,HumanResources.Employee.JobTitle  
  ,Person.Person.FirstName  
  ,Person.Person.LastName  
FROM  
  Person.Person  
  INNER JOIN HumanResources.Employee  
    ON Person.Person.BusinessEntityID = HumanResources.Employee.BusinessEntityID  
WHERE HumanResources.Employee.JobTitle = 'Marketing Assistant'   

쿼리를 실행하고 결과 집합을 표시하려면 도구 모음에서 실행 단추(!)를 클릭합니다.Click the Run button (!) on the toolbar to run the query and display a result set.

이 쿼리에서 매개 변수를 사용하려면 쿼리 매개 변수를 추가합니다.To parameterize this query, add a query parameter. 예를 들어 WHERE 절을 다음과 같이 변경합니다.For example, change the WHERE clause to the following:

WHERE HumanResources.Employee.JobTitle = (@JobTitle)  

쿼리를 실행하면 쿼리 매개 변수에 해당하는 보고서 매개 변수가 자동으로 만들어집니다.When you run the query, report parameters that correspond to query parameters are automatically created. 자세한 내용은 이 항목의 뒷부분에 나오는 쿼리 매개 변수 를 참조하십시오.For more information, see Query Parameters later in this topic.

StoredProcedure 쿼리 유형 사용Using Query Type StoredProcedure

다음 중 한 가지 방법으로 데이터 집합 쿼리에 대해 저장 프로시저를 지정할 수 있습니다.You can specify a stored procedure for a dataset query in one of the following ways:

  • 데이터 집합 속성 대화 상자에서 저장 프로시저 옵션을 설정합니다.In the Dataset Properties dialog box, set the Stored Procedure option. 저장 프로시저 및 테이블 반환 함수 드롭다운 목록에서 원하는 항목을 선택합니다.Choose from the drop-down list of stored procedures and table-valued functions.

  • 관계형 쿼리 디자이너에서는 데이터베이스 뷰 창에서 저장 프로시저 또는 테이블 반환 함수를 선택합니다.In the relational query designer, in the Database view pane, select a stored procedure or table-valued function.

  • 텍스트 기반 쿼리 디자이너에서는 도구 모음에서 StoredProcedure 를 선택합니다.In the text-based query designer, select StoredProcedure from the toolbar.

    저장 프로시저나 테이블 반환 함수를 선택한 후 쿼리를 실행할 수 있습니다.After you select a stored procedure or table-valued function, you can run the query. 입력 매개 변수 값을 입력하라는 메시지가 표시됩니다.You will be prompted for input parameter values. 쿼리를 실행하면 입력 매개 변수에 해당하는 보고서 매개 변수가 자동으로 만들어집니다.When you run the query, report parameters that correspond to input parameters are automatically created. 자세한 내용은 이 항목의 뒷부분에 나오는 쿼리 매개 변수 를 참조하십시오.For more information, see Query Parameters later in this topic.

    저장 프로시저의 경우 첫 번째로 검색된 결과 집합만 지원됩니다.Only the first result set that is retrieved for a stored procedure is supported. 저장 프로시저에서 여러 개의 결과 집합을 반환할 경우 첫 번째 결과 집합만 사용됩니다.If a stored procedure returns multiple result sets, only the first one is used.

    저장 프로시저에 기본값을 사용하는 매개 변수가 있는 경우 매개 변수의 값으로 DEFAULT 키워드를 사용하여 해당 값에 액세스할 수 있습니다.If a stored procedure has a parameter that has a default value, you can access that value by using the DEFAULT keyword as a value for the parameter. 쿼리 매개 변수가 보고서 매개 변수에 연결되어 있으면 사용자가 보고서 매개 변수의 입력란에 DEFAULT라는 단어를 입력하거나 선택할 수 있습니다.If the query parameter is linked to a report parameter, the user can type or select the word DEFAULT in the input box for the report parameter.

    저장 프로시저에 대한 자세한 내용은 msdn.microsoft.com의 SQL Server 온라인 설명서 에서 "저장 프로시저(데이터베이스 엔진)"를 참조하세요.For more information about stored procedures, see "Stored Procedures (Database Engine)" in SQL Server Books Online on msdn.microsoft.com.

매개 변수Parameters

쿼리 텍스트에 입력 매개 변수가 있는 쿼리 변수 또는 저장 프로시저가 포함된 경우 데이터 집합에 대한 해당 쿼리 매개 변수와 보고서에 대한 해당 보고서 매개 변수가 자동으로 생성됩니다.When query text contains query variables or stored procedures that have input parameters, the corresponding query parameters for the dataset and report parameters for the report are automatically generated. 쿼리 텍스트는 각 쿼리 변수에 대한 DECLARE 문을 포함하지 않아야 합니다.The query text must not include the DECLARE statement for each query variable.

예를 들어 다음 SQL 쿼리는 EmpID라는 보고서 매개 변수를 만듭니다.For example, the following SQL query creates a report parameter named EmpID:

SELECT FirstName, LastName FROM HumanResources.Employee E INNER JOIN  
       Person.Contact C ON  E.ContactID=C.ContactID   
WHERE EmployeeID = (@EmpID)  

기본적으로 각 보고서 매개 변수는 데이터 형식이 Text이며 사용 가능한 값의 드롭다운 목록을 제공하기 위해 자동으로 작성된 데이터 집합을 가집니다.By default, each report parameter has data type Text and an automatically created dataset to provide a drop-down list of available values. 보고서 매개 변수가 만들어진 후에는 기본값을 변경해야 할 수 있습니다.After the report parameters are created, you might have to change default values. 자세한 내용은 보고서 매개 변수(보고서 작성기 및 보고서 디자이너)유형의 보고서 데이터 원본을 기반으로 하는 데이터 집합이 있어야 합니다.For more information, see Report Parameters (Report Builder and Report Designer).

주의Remarks

대체 데이터 확장 프로그램Alternate Data Extensions

OLE DB 데이터 원본 유형을 사용하여 SQL ServerSQL Server 데이터베이스에서 데이터를 검색할 수도 있습니다.You can also retrieve data from a SQL ServerSQL Server database by using an ODBC data source type. OLE DB를 사용하여 SQL 데이터베이스SQL Database 에 연결할 수는 없습니다.Connecting to SQL 데이터베이스SQL Database by using OLE DB is not supported.

자세한 내용은 ODBC 연결 형식(SSRS)을 참조하세요.For more information, see ODBC Connection Type (SSRS).

플랫폼 및 버전 정보Platform and Version Information

플랫폼 및 버전 지원에 대한 자세한 내용은 SQL ServerSQL Server 온라인 설명서Reporting ServicesReporting Services 설명서에서 Reporting Services(SSRS)에서 지원하는 데이터 원본.For more information about platform and version support, see Data Sources Supported by Reporting Services (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online.

방법 도움말 항목How-To Topics

이 섹션에서는 데이터 연결, 데이터 원본 및 데이터 집합을 사용하는 방법을 단계별로 설명합니다.This section contains step-by-step instructions for working with data connections, data sources, and datasets.

데이터 연결 추가 및 확인(보고서 작성기 및 SSRS)Add and Verify a Data Connection (Report Builder and SSRS)

공유 데이터 집합 또는 포함된 데이터 집합 만들기(보고서 작성기 및 SSRS)Create a Shared Dataset or Embedded Dataset (Report Builder and SSRS)

데이터 집합에 필터 추가(보고서 작성기 및 SSRS)Add a Filter to a Dataset (Report Builder and SSRS)

설명서의 다음 섹션에서는 보고서 데이터에 대한 깊이 있는 개념 정보를 제공하며, 데이터와 관련된 보고서 부분을 정의, 사용자 지정 및 사용하는 방법을 절차적인 측면에서 소개합니다.These sections of the documentation provide in-depth conceptual information about report data, and procedural information about how to define, customize, and use parts of a report that are related to data.

보고서 데이터 집합(SSRS)Report Datasets (SSRS)
보고서의 데이터 액세스에 대한 개요를 제공합니다.Provides an overview of accessing data for your report.

보고서 작성기의 데이터 연결, 데이터 원본 및 연결 문자열Data Connections, Data Sources, and Connection Strings in Report Builder
데이터 연결 및 데이터 원본에 대한 정보를 제공합니다.Provides information about data connections and data sources.

보고서 포함된 데이터 집합 및 공유 데이터 집합(보고서 작성기 및 SSRS)Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)
포함된 데이터 집합 및 공유 데이터 집합에 대한 정보를 제공합니다.Provides information about embedded and shared datasets.

데이터 집합 필드 컬렉션(보고서 작성기 및 SSRS)Dataset Fields Collection (Report Builder and SSRS)
쿼리에 의해 생성되는 데이터 집합 필드 컬렉션에 대한 정보를 제공합니다.Provides information about the dataset field collection generated by the query.

SQL ServerSQL Server 온라인 설명서에 있는 Reporting ServicesReporting Services 설명서의 Reporting Services(SSRS)에서 지원하는 데이터 원본.Data Sources Supported by Reporting Services (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online.
각 데이터 확장 프로그램의 플랫폼 및 버전 지원에 대한 자세한 정보를 제공합니다.Provides in-depth information about platform and version support for each data extension.

관련 항목:See Also

docs.microsoft.com의 Microsoft Azure SQL DatabaseMicrosoft Azure SQL Database on docs.microsoft.com
보고서 매개 변수(보고서 작성기 및 보고서 디자이너) Report Parameters (Report Builder and Report Designer)
데이터 필터링, 그룹화 및 정렬(보고서 작성기 및 SSRS) Filter, Group, and Sort Data (Report Builder and SSRS)
식(보고서 작성기 및 SSRS)Expressions (Report Builder and SSRS)
추가 질문이 있으신가요?More questions? Reporting Services 포럼을 이용해 보세요.Try the Reporting Services forum