Typ połączenia Oracle (Power BI Report Builder)
DOTYCZY: Power BI Report Builder Power BI Desktop
Aby korzystać z danych z bazy danych Oracle w raporcie, musisz mieć zestaw danych oparty na źródle danych raportu typu Oracle. Ten wbudowany typ źródła danych korzysta bezpośrednio z Dostawca danych Oracle i wymaga składnika oprogramowania klienckiego Oracle. W tym artykule wyjaśniono, jak pobrać i zainstalować sterowniki dla programu Power BI Report Builder.
Ważne
Poniższe polecenia korzystające z narzędzia OraProvCfg.exe firmy Oracle do rejestrowania sterowników zarządzanych i niezarządzanych ODP.NET firmy Oracle są udostępniane jako przykłady użycia z powyższymi produktami firmy Microsoft. W przypadku konfiguracji sterowników ODP.NET specyficznych dla danego środowiska może być konieczne skontaktowanie się z pomocą techniczną firmy Oracle lub odwołanie do dokumentacji firmy Oracle dotyczącej konfigurowania Dostawca danych Oracle dla platformy .NET.
Sterowniki 32-bitowe dla programu Power BI Report Builder
Program Power BI Report Builder używa ODP.NET zarządzanych do tworzenia raportów podzielonych na strony (RDL). W przypadku używania sterowników Oracle ODAC 12.2 lub nowszych potrzebne są tylko następujące kroki. W przeciwnym razie instalują domyślnie konfigurację nienależącą do komputera na potrzeby nowej instalacji głównej oracle. W tych krokach przyjęto założenie, że zainstalowano pliki ODAC 18.x w folderze c:\oracle32, w którym zainstalowano program Power BI Report Builder. Wykonaj następujące kroki, aby zarejestrować ODP.NET zarządzane:
W witrynie pobierania Oracle zainstaluj program Oracle "ODAC with Oracle Developer Tools for Visual Studio — OUI" (32-bitowy).
Zarejestruj ODP.NET zarządzanego klienta w usłudze 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.dll
Dodaj wpisy ODP.NET zarządzanego klienta do pliku machine.config:
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
Sterowniki 64-bitowe dla programu Power BI Report Builder
Uwaga
Poniższe instrukcje dotyczą programu Power BI Report Builder w wersji 15.7.01678.0001 lub nowszej. W przypadku wersji starszych niż 15.7.01678.0001 postępuj zgodnie z powyższymi instrukcjami 32-bitowymi dla programu Power BI Report Builder .
Program Power BI Report Builder używa ODP.NET zarządzanych do tworzenia raportów podzielonych na strony (RDL). W przypadku używania sterowników Oracle ODAC 12.2 lub nowszych potrzebne są tylko następujące kroki. W przeciwnym razie instalują domyślnie konfigurację nienależącą do komputera na potrzeby nowej instalacji głównej oracle. W tych krokach przyjęto założenie, że zainstalowano pliki ODAC 18.x w folderze c:\oracle64, w którym zainstalowano program Power BI Report Builder. Wykonaj następujące kroki, aby zarejestrować ODP.NET zarządzane:
W witrynie pobierania Oracle zainstaluj 64-bitowy instalator odAC Oracle Universal Installer (OUI).
Zarejestruj ODP.NET zarządzanego klienta w usłudze 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.dll
Dodaj wpisy ODP.NET zarządzanego klienta do pliku machine.config:
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
Skontaktuj się z administratorem bazy danych, aby uzyskać informacje o połączeniu i poświadczenia, które mają być używane do nawiązywania połączenia ze źródłem danych. Poniższy przykład parametry połączenia określa bazę danych Oracle na serwerze o nazwie "Oracle18" przy użyciu formatu Unicode. Nazwa serwera musi być zgodna z definicją w pliku konfiguracji Tnsnames.ora jako nazwę wystąpienia serwera Oracle.
Data Source="Oracle18"; Unicode="True"
Aby uzyskać więcej parametry połączenia przykładów, zobacz Tworzenie parametry połączenia danych — Power BI Report Builder.
Poświadczenia
Poświadczenia są wymagane do uruchamiania zapytań, wyświetlania podglądu raportu lokalnie i wyświetlania podglądu raportu w portalu internetowym usługi Power BI.
Po opublikowaniu raportu może być konieczne powiązanie go z połączeniem usługi Power BI Gateway. Aby uzyskać więcej informacji, zobacz Zarządzanie źródłem danych — Oracle
Zapytania
Aby utworzyć zestaw danych, możesz wybrać procedurę składowaną z listy rozwijanej lub utworzyć zapytanie SQL. Aby utworzyć zapytanie, należy użyć projektanta zapytań opartego na tekście. Aby uzyskać więcej informacji, zobacz Zapytanie oparte na tekście Projektant interfejs użytkownika (Power BI Report Builder).
Można określić procedury składowane, które zwracają tylko jeden zestaw wyników. Używanie zapytań opartych na kursorach nie jest obsługiwane.
Parametry
Jeśli zapytanie zawiera zmienne zapytania, odpowiednie parametry raportu są generowane automatycznie. Nazwane parametry są obsługiwane przez to rozszerzenie. W przypadku programu Oracle w wersji 9 lub nowszej obsługiwane są parametry wielowarte.
Parametry raportu są tworzone przy użyciu domyślnych wartości właściwości, które mogą być konieczne do zmodyfikowania. Na przykład każdy parametr raportu jest typem danych Tekst. Po utworzeniu parametrów raportu może być konieczne zmiana wartości domyślnych.
Rozważania i ograniczenia
Przed nawiązaniem połączenia ze źródłem danych Oracle administrator systemu musi zainstalować wersję programu .NET Dostawca danych dla programu Oracle, która obsługuje pobieranie danych z bazy danych Oracle. Ten dostawca danych musi być zainstalowany na tym samym komputerze co program Power BI Report Builder, a także na maszynie obsługującej usługę Power BI Gateway. Aby uzyskać więcej informacji, zobacz Zarządzanie źródłem danych — Oracle.
Obejście dotyczące wywoływania procedur składowanych
Jeśli używasz źródła danych Oracle, jeśli raport podzielony na strony ma typ zapytania ustawiony jako Procedura składowana, nie można wykonać go w usługa Power BI z powodu ograniczenia usługi Power BI Gateway. Aby obejść ten problem, jeśli używasz programu Oracle 12 lub nowszego, ustaw typ zapytania na tekst i wywołaj procedurę składowaną w tekście, jak w poniższym przykładzie.
DECLARE OUT_RPT_DATA SYS_REFCURSOR;
BEGIN
SYSTEM.<Procedure_Name>(OUT_RPT_DATA);
DBMS_SQL.RETURN_RESULT(OUT_RPT_DATA);
END;
Informacje o platformie i wersji
Aby uzyskać więcej informacji na temat obsługi platformy i wersji, zobacz Obsługiwane źródła danych dla raportów podzielonych na strony usługi Power BI.