Oracle 연결 형식(Power BI 보고서 작성기)
적용 대상:
Power BI 보고서 작성기 
Power BI Desktop
보고서에서 Oracle 데이터베이스의 데이터를 사용하려면 Oracle 유형의 보고서 데이터 원본을 기반으로 하는 데이터 세트가 있어야 합니다. 이 기본 제공 데이터 원본 유형은 Oracle Data Provider를 사용하며 Oracle 클라이언트 소프트웨어 구성 요소를 필요로 합니다. 이 문서에서는 Power BI 보고서 작성기용 드라이버를 다운로드하고 설치하는 방법을 설명합니다.
Important
Oracle의 OraProvCfg.exe 도구를 사용하여 Oracle의 관리형 및 관리되지 않는 ODP.NET 드라이버를 등록하는 다음 명령은 위의 Microsoft 제품에서 사용할 예시로 제공됩니다. 환경에 특정한 ODP.NET 드라이버를 구성하려면 Oracle 지원에 문의하거나 .NET용 Oracle Data Provider 구성에 관한 Oracle 설명서를 참조해야 할 수 있습니다.
Power BI 보고서 작성기용 32비트 드라이버
Power BI Report Builder는 페이지를 매긴(RDL) 보고서 작성에 관리형 ODP.NET을 사용합니다. Oracle ODAC 드라이버 12.2 이상을 사용하는 경우에만 다음 단계가 필요합니다. 그러지 않으면 해당 단계는 기본적으로 새 Oracle 홈 설치를 위한 머신 전체가 아닌 구성에 설치됩니다. 이 단계에서는 Power BI 보고서 작성기가 설치된 c:\oracle32 폴더에 ODAC 18.x 파일을 설치했다고 가정합니다. 다음 단계를 수행하여 관리형 ODP.NET을 등록합니다.
Oracle 다운로드 사이트에서 Oracle “ODAC with Oracle Developer Tools for Visual Studio - OUI”(32비트)를 설치합니다.
ODP.NET 관리 클라이언트를 GAC에 등록합니다.
C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dllmachine.config에 ODP.NET 관리되는 클라이언트 항목을 추가합니다.
C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
Power BI Report Builder용 64비트 드라이버
참고
다음 지침은 Power BI Report Builder 버전 15.7.01678.0001 이상에 적용됩니다. 15.7.01678.0001 이전 버전의 경우 위의 Power BI 보고서 작성기용 32비트 드라이버 지침을 따릅니다.
Power BI Report Builder는 페이지를 매긴(RDL) 보고서 작성에 관리형 ODP.NET을 사용합니다. Oracle ODAC 드라이버 12.2 이상을 사용하는 경우에만 다음 단계가 필요합니다. 그러지 않으면 해당 단계는 기본적으로 새 Oracle 홈 설치를 위한 머신 전체가 아닌 구성에 설치됩니다. 관련 단계에서는 Power BI Report Builder가 설치된 c:\oracle64 폴더에 ODAC 18.x 파일을 설치했다고 가정합니다. 다음 단계를 수행하여 관리형 ODP.NET을 등록합니다.
Oracle 다운로드 사이트에서 Oracle 64-bit ODAC Oracle Universal Installer(OUI)를 설치합니다.
ODP.NET 관리 클라이언트를 GAC에 등록합니다.
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dllmachine.config에 ODP.NET 관리되는 클라이언트 항목을 추가합니다.
C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
Connection string
데이터 원본 연결에 사용할 자격 증명 및 연결 정보는 데이터베이스 관리자에게 문의하십시오. 다음 연결 문자열 예에서는 유니코드를 사용하는 "Oracle18"이라는 서버의 Oracle 데이터베이스를 지정합니다. 서버 이름은 Tnsnames.ora 구성 파일에 Oracle 서버 인스턴스 이름으로 정의되어 있는 이름과 일치해야 합니다.
Data Source="Oracle18"; Unicode="True"
더 많은 연결 문자열 예제는 데이터 연결 문자열 만들기 - Power BI Report Builder를 참조하세요.
자격 증명
쿼리를 실행하고, 보고서를 로컬로 미리 보고, Power BI 웹 포털에서 보고서를 미리 보려면 자격 증명이 필요합니다.
보고서를 게시한 후 Power BI 게이트웨이 연결에 바인딩해야 할 수 있습니다. 자세한 내용은 데이터 원본 관리 - Oracle 참조
쿼리
데이터 세트를 만들려면 드롭다운 목록에서 저장 프로시저를 선택하거나 SQL 쿼리를 만듭니다. 쿼리를 만들려면 텍스트 기반 쿼리 디자이너를 사용해야 합니다. 자세한 내용은 텍스트 기반 쿼리 디자이너 사용자 인터페이스(Power BI 보고서 작성기)를 참조하세요.
결과 집합을 하나만 반환하는 저장 프로시저를 지정할 수 있습니다. 커서 기반 쿼리 사용은 지원되지 않습니다.
매개 변수
쿼리에 쿼리 변수가 포함된 경우 해당 보고서 매개 변수가 자동으로 생성됩니다. 이 확장 프로그램은 명명된 매개 변수를 지원합니다. Oracle 버전 9 이상에서는 다중 값 매개 변수가 지원됩니다.
보고서 매개 변수는 수정해야 할 수도 있는 기본 속성 값을 사용하여 만들어집니다. 예를 들어 각 보고서 매개 변수의 데이터 형식은 Text입니다. 보고서 매개 변수가 만들어진 후에는 기본값을 변경해야 할 수 있습니다.
고려 사항 및 제한 사항
Oracle 데이터 원본을 연결하려면 시스템 관리자가 Oracle 데이터베이스에서 데이터를 검색할 수 있도록 하는 .NET Data Provider for Oracle 버전을 설치해야 합니다. 이 데이터 공급자는 Power BI 보고서 작성기와 동일한 컴퓨터 및 Power BI 게이트웨이를 호스팅하는 컴퓨터에 설치해야 합니다. 자세한 내용은 데이터 원본 관리 - Oracle을 참조하세요.
저장 프로시저 호출에 대한 해결 방법
Oracle 데이터 원본을 사용하는 경우 페이지를 매긴 보고서에 저장 프로시저로 설정된 쿼리 유형이 있는 경우 Power BI Gateway 제한으로 인해 Power BI 서비스 실행되지 않습니다. Oracle 12 이상을 사용하는 경우 다음 예제와 같이 쿼리 형식을 텍스트로 설정하고 저장 프로시저를 인라인으로 호출하는 해결 방법을 활용할 수 있습니다.
DECLARE OUT_RPT_DATA SYS_REFCURSOR;
BEGIN
SYSTEM.<Procedure_Name>(OUT_RPT_DATA);
DBMS_SQL.RETURN_RESULT(OUT_RPT_DATA);
END;
플랫폼 및 버전 정보
플랫폼 및 버전 지원에 대한 자세한 내용은 Power BI 페이지를 매긴 보고서에 지원되는 데이터 원본을 참조하세요.