Report Builder에서 데이터 연결 문자열 만들기
적용 대상: SQL Server Reporting Services 2016(13.x) 이상 Power BI Report Server SharePoint
Report Builder 및 Reporting Services 페이지를 매긴 보고서에 데이터를 포함하려면 먼저 데이터 원본에 대한 연결 문자열을 만들어야 합니다. 이 문서에서는 데이터 연결 문자열을 만드는 방법을 설명하고 데이터 원본 자격 증명과 관련된 중요한 정보를 제공합니다. 데이터 원본에는 데이터 원본 형식, 연결 정보 및 필요한 자격 증명 유형이 포함됩니다. 자세한 내용은 SSRS(SQL Server Reporting Services)에서 데이터 보고 소개를 참조하세요.
기본 제공 데이터 확장
Reporting Services의 기본 데이터 확장 프로그램에는 Microsoft SQL Server, Microsoft Azure SQL Database 및 Microsoft SQL Server Analysis Services가 포함됩니다. Reporting Services에서 지원하는 데이터 원본 및 버전의 전체 목록은 Reporting Services에서 지원하는 데이터 원본(SSRS)을 참조하세요.
자주 사용하는 연결 문자열 예
연결 문자열은 데이터 공급자에 대한 연결 속성의 텍스트 표현입니다. 다음 표에서는 다양한 데이터 연결 형식에 대한 연결 문자열의 예를 보여 줍니다.
참고
Connectionstrings.com 은 연결 문자열에 대한 예시를 가져올 수 있는 다른 리소스입니다.
데이터 원본 | 예시 | 설명 |
---|---|---|
로컬 서버의 SQL Server 데이터베이스 | Data Source="(local)"; Initial Catalog=AdventureWorks |
데이터 원본 유형을 Microsoft SQL Server로 설정합니다. 자세한 내용은 SQL Server 연결 형식(SSRS)을 참조하세요. |
SQL Server 명명된 인스턴스 | Data Source=<host>\MSSQL13.<InstanceName>; Initial Catalog=AdventureWorks |
데이터 원본 유형을 Microsoft SQL Server로 설정합니다. 자세한 내용은 SQL Server 연결 형식(SSRS)을 참조하세요. |
Azure SQL Database | Data Source=<host>.database.windows.net; Initial Catalog=AdventureWorks; Encrypt=True |
데이터 원본 유형을 Microsoft Azure SQL Database로 설정합니다. 자세한 내용은 Azure SQL 연결 형식(SSRS)을 참조하세요. |
SQL Server 병렬 데이터 웨어하우스 | HOST=<IP address>; database=AdventureWorks; port=<port> |
데이터 원본 유형을 Microsoft SQL Server Parallel Data Warehouse로 설정합니다. 자세한 내용은 SQL Server 병렬 데이터 웨어하우스 연결 형식(SSRS)을 참조하세요. |
로컬 서버의 Analysis Services 데이터베이스 | Data Source=localhost; Initial Catalog=Adventure Works DW |
데이터 원본 유형을 Microsoft SQL Server Analysis Services로 설정합니다. 자세한 내용은 MDX용 Analysis Services 연결 형식(SSRS) 또는 DMX용 Analysis Services 연결 형식(SSRS)을 참조하세요. |
Sales 큐브 뷰가 있는 Analysis Services 테이블 형식 model 데이터베이스 | Data Source=<servername>; Initial Catalog=Adventure Works DW; cube='Sales' |
데이터 원본 유형을 Microsoft SQL Server Analysis Services로 설정합니다. cube= 설정에 큐브 뷰 이름을 지정합니다. 자세한 내용은 테이블 형식 모델의 큐브 뷰를 참조하세요. |
Azure Analysis Services | Data Source=asazure://aspaaseastus2.asazure.windows.net/<server name>; Initial Catalog=AdventureWorks |
데이터 원본 유형을 Microsoft SQL Server Analysis Services로 설정합니다. 자세한 내용은 Microsoft SQL Server Analysis Services 데이터 처리 확장 프로그램을 참조하세요. |
Oracle 서버 | Data Source=<host> |
데이터 원본 유형을 Oracle로 설정합니다. Oracle 클라이언트 도구는 보고서 디자이너 컴퓨터와 보고서 서버에 설치해야 합니다. 자세한 내용은 Oracle 연결 형식(SSRS & Power BI Report Builder)을 참조하세요. |
SAP NetWeaver BI 데이터 원본 | Data Source=https://mySAPNetWeaverBIServer:8000/sap/bw/xml/soap/xmla |
데이터 원본 유형을 SAP NetWeaver BI로 설정합니다. 자세한 내용은 SAP NetWeaver BI 연결 형식(SSRS)을 참조하세요. |
Hyperion Essbase 데이터 원본 | Data Source=https://localhost:13080/aps/XMLA; Initial Catalog=Sample |
데이터 원본 유형을 Hyperion Essbase로 설정합니다. 자세한 내용은 Hyperion Essbase 연결 형식(SSRS)을 참조하세요. |
Teradata 데이터 원본 | Data Source=<NNN>.<NNN>.<NNN>.<NNN>; |
데이터 원본 유형을 Teradata로 설정합니다. 연결 문자열은 1자리부터 3자리 숫자까지 허용되는 필드 네 개로 구성된 형식의 IP 주소입니다. 자세한 내용은 Teradata 연결 형식(SSRS)을 참조하세요. |
Teradata 데이터 원본 | Database=<database name>; Data Source=<NNN>.<NNN>.<NNN>.<NNN>; Use X Views=False; Restrict to Default Database=True |
앞의 예와 마찬가지로 데이터 원본 유형을 Teradata로 설정합니다. Database 태그에 지정된 기본 데이터베이스만 사용하고 데이터 관계를 자동으로 검색하지 마세요. |
XML 데이터 원본, 웹 서비스 | data source=https://adventure-works.com/results.aspx |
데이터 원본 유형을 XML로 설정합니다. 연결 문자열은 WSDL(Web Services Definition Language)을 지원하는 웹 서비스의 URL입니다. 자세한 내용은 XML 연결 형식(SSRS)을 참조하세요. |
XML 데이터 원본, XML 문서 | https://localhost/XML/Customers.xml |
데이터 원본 유형을 XML로 설정합니다. 연결 문자열은 XML 문서의 URL입니다. |
XML 데이터 원본, 포함된 XML 문서 | 비어 있음 | 데이터 원본 유형을 XML로 설정합니다. XML 데이터는 보고서 정의에 포함됩니다. |
SharePoint 목록 | Data Source=https://MySharePointWeb/MySharePointSite/ |
데이터 원본 유형을 SharePoint List로 설정합니다. |
Power BI Premium 데이터 세트(Reporting Services 2019 및 Power BI Report Server 2020년 1월부터) | Data Source=powerbi://api.powerbi.com/v1.0/myorg/<workspacename>; Initial Catalog=<datasetname> |
데이터 원본 유형을 Microsoft SQL Server Analysis Services로 설정합니다. |
localhost를 사용하여 보고서 서버에 연결할 수 없는 경우에는 TCP/IP 프로토콜의 네트워크 프로토콜이 사용 설정되어 있는지 확인합니다. 자세한 내용은 클라이언트 프로토콜 구성을 참조하세요.
각각의 데이터 원본 유형에 연결하는 데 필요한 구성에 대한 자세한 내용은 외부 데이터 원본의 데이터 추가(SSRS) 또는 Reporting Services에서 지원하는 데이터 원본(SSRS)의 특정 데이터 연결 문서를 참조하세요.
암호의 특수 문자
비밀번호를 사용하여 ODBC 또는 SQL 데이터 원본을 구성하는 경우 특수 문자로 인한 오류가 발생할 수 있습니다. 사용자가 구두점과 같은 특수 문자를 사용하여 비밀번호를 입력하는 경우 일부 기본 데이터 원본 드라이버는 이러한 특수 문자의 유효성을 검사할 수 없습니다. 보고서 처리 시 "올바른 암호가 아닙니다" 메시지가 나타나면 이 문제 때문일 수 있습니다. 암호를 변경하는 것이 불가능한 경우 데이터베이스 관리자와 협력하여 서버에서 해당 자격 증명을 시스템 ODBC DSN(데이터 원본 이름)의 일부로 저장합니다. 자세한 내용은 .NET Framework 설명서의 OdbcConnection.ConnectionString을 참조하세요.
식 기반 연결 문자열
식 기반 연결 문자열은 런타임에 평가됩니다. 예를 들어 데이터 원본을 매개 변수로 지정하고 연결 문자열에 매개 변수 참조를 포함하여 사용자가 보고서의 데이터 원본을 선택할 수 있도록 할 수 있습니다. 예를 들어 여러 국가/지역에 데이터 서버를 보유하고 있는 다국적 기업의 경우 식 기반 연결 문자열을 사용하면 판매 보고서를 실행하는 사용자가 보고서를 실행하기 전에 특정 국가/지역에 대한 데이터 원본을 선택할 수 있습니다.
다음 예시에서는 SQL Server 연결 문자열에 데이터 원본 식을 사용하는 작업을 보여 줍니다. 이 예에서는 ServerName
이라는 보고서 매개 변수를 만들었다고 가정합니다.
="Data Source=" & Parameters!ServerName.Value & "; Initial Catalog=AdventureWorks"
데이터 원본 식은 런타임에 또는 보고서를 미리 볼 때 처리됩니다. 식은 Visual Basic으로 작성해야 합니다. 다음 지침에 따라 데이터 원본 식을 정의합니다.
정적 연결 문자열을 사용하여 보고서를 디자인합니다. 정적 연결 문자열은 식을 통해 설정되지 않은 연결 문자열입니다. 예를 들어 보고서별 데이터 원본 또는 공유 데이터 원본을 만드는 단계를 수행하는 경우 정적 연결 문자열을 정의하게 됩니다. 정적 연결 문자열을 사용하면 보고서를 만드는 데 필요한 쿼리 결과를 가져올 수 있도록 보고서 디자이너의 데이터 원본에 연결할 수 있습니다.
데이터 원본 연결을 정의할 때는 공유 데이터 원본을 사용하지 마세요. 공유 데이터 원본에서는 데이터 원본 식을 사용할 수 없습니다. 보고서에 대한 포함된 데이터 원본을 정의해야 합니다.
연결 문자열과 별도로 자격 증명을 지정합니다. 저장된 자격 증명, 입력 정보를 요청하는 자격 증명 또는 통합 보안을 사용할 수 있습니다.
보고서 매개 변수를 추가하여 데이터 원본을 지정합니다. 매개 변수 값으로는 사용 가능한 값의 정적 목록을 제공하거나 런타임에 데이터 원본 목록을 검색하는 쿼리를 정의할 수 있습니다. 이 경우 사용 가능한 값의 정적 목록은 보고서에 사용할 수 있는 데이터 원본이어야 합니다.
데이터 원본 목록에서 동일한 데이터베이스 스키마를 공유하는지 확인합니다. 모든 보고서 디자인은 스키마 정보로 시작됩니다. 보고서 정의에 사용되는 스키마와 런타임 시 보고서에 사용되는 실제 스키마가 일치하지 않으면 보고서가 실행되지 않을 수 있습니다.
보고서를 게시하기 전에 정적 연결 문자열을 식으로 바꿉니다. 이때 정적 연결 문자열은 보고서 디자인을 완료한 다음에 식으로 바꿔야 합니다. 식을 사용한 다음에는 보고서 디자이너에서 쿼리를 실행할 수 없습니다. 또한 보고서 데이터 창의 필드 목록과 매개 변수 목록은 자동으로 업데이트되지 않습니다.