Тип подключения Oracle (Power BI построитель отчетов)

ОБЛАСТЬ ПРИМЕНЕНИЯ: Power BI построитель отчетов Power BI Desktop

Чтобы использовать в отчете данные из базы данных Oracle, необходим набор данных, основанный на источнике данных Oracle. Этот встроенный тип источника данных напрямую использует поставщик .NET Framework для Oracle и требует наличия клиентского программного обеспечения Oracle. В этой статье объясняется, как скачать и установить драйверы для Построитель отчетов Power BI.

Важно!

Следующие команды, использующие средство OraProvCfg.exe Oracle для регистрации управляемых и неуправляемых драйверов ODP.NET Oracle, предоставляются в качестве примеров для использования с вышеуказанными продуктами корпорации Майкрософт. Для настройки драйверов ODP.NET, относящихся к конкретной среде, может потребоваться обратиться в службу поддержки Oracle или к документации Oracle за сведениями о Настройке поставщика данных Oracle для .NET.

32-разрядные драйверы для Построитель отчетов Power BI

Построитель отчетов Power BI использует Managed ODP.NET для создания отчетов с разбивкой на страницы (RDL). При использовании драйверов Oracle ODAC 12.2 и более поздних версий потребуются только следующие шаги. В противном случае они устанавливаются по умолчанию в конфигурации, которая не охватывает весь компьютер, для новой установки Oracle Home. В этих шагах предполагается, что вы установили файлы ODAC 18.x в папку c:\oracle32, где установлена построитель отчетов Power BI. Чтобы зарегистрировать управляемый драйвер ODP.NET, следуйте приведенным ниже инструкциям.

1. На сайте загрузки Oracle установите Oracle "ODAC с Oracle Developer Tools для Visual Studio — OUI" (32-разрядная версия).

2. Зарегистрируйте управляемый клиент ODP.NET в глобальном кэше сборок:

   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
   

3. Добавьте записи управляемого клиента ODP.NET в файл 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
   

64-разрядные драйверы для Построителя отчетов Power BI

Примечание.

Приведенные ниже инструкции относятся к Построителю отчетов Power BI версии 15.7.01678.0001 и более поздних версий. Для версий до версии 15.7.01678.0001 следуйте 32-разрядным драйверам power BI построитель отчетов приведенным выше инструкциям.

Построитель отчетов Power BI использует Managed ODP.NET для создания отчетов с разбивкой на страницы (RDL). При использовании драйверов Oracle ODAC 12.2 и более поздних версий потребуются только следующие шаги. В противном случае они устанавливаются по умолчанию в конфигурации, которая не охватывает весь компьютер, для новой установки Oracle Home. В этих шагах предполагается, что вы установили файлы ODAC 18.x в папку c:\oracle64, в которую установлен Построитель отчетов Power BI. Чтобы зарегистрировать управляемый драйвер ODP.NET, следуйте приведенным ниже инструкциям.

1. На сайте загрузки Oracle установите 64-разрядную версию Oracle ODAC OUI.

2. Зарегистрируйте управляемый клиент ODP.NET в глобальном кэше сборок:

   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
   

3. Добавьте записи управляемого клиента ODP.NET в файл 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

Данные для строки соединения и учетные данные для подключения к источнику данных можно получить у администратора базы данных. В следующем примере строки соединения указывается база данных Oracle на сервере Oracle18 с использованием Юникода. Имя сервера должно соответствовать значению, определенному в файле конфигурации tnsnames.ora в качестве имени экземпляра сервера Oracle.

Data Source="Oracle18"; Unicode="True"  

Дополнительные строка подключения примеры см. в статье "Создание строка подключения данных — построитель отчетов Power BI".

Учетные данные

Учетные данные необходимы для выполнения запросов, предварительного просмотра отчета локально и предварительного просмотра отчета на веб-портале Power BI.

После публикации отчета может потребоваться привязать его к подключению Шлюза Power BI. Дополнительные сведения см. в статье "Управление источником данных " Oracle"

Запросы

Для создания набора данных можно выбрать хранимую процедуру из раскрывающегося списка или создать SQL-запрос. Чтобы построить запрос, воспользуйтесь текстовым конструктором запросов. Дополнительные сведения см. в пользовательском интерфейсе конструктора запросов на основе текста (Power BI построитель отчетов).

Можно указать хранимые процедуры, возвращающие только один результирующий набор. Использование курсорных запросов не поддерживается.

Параметры

Если запрос включает переменные запроса, то автоматически создаются соответствующие параметры отчета. Этот модуль поддерживает именованные параметры. Для Oracle версии 9 или более поздней поддерживаются параметры с несколькими значениями.

Параметры отчета создаются со значениями свойств по умолчанию, которые, возможно, потребуется изменить. Например, все параметры отчета имеют тип данных Text. После создания параметров отчета можно изменить значения по умолчанию.

Рекомендации и ограничения

Прежде чем подключиться к источнику данных Oracle, системный администратор должен установить версию поставщика данных .NET для Oracle, поддерживающую получение данных из базы данных Oracle. Этот поставщик данных должен быть установлен на том же компьютере, что и построитель отчетов Power BI, а также на компьютере, где размещен Шлюз Power BI. Дополнительные сведения см. в статье "Управление источником данных " Oracle".

Обходное решение для вызова хранимых процедур

При использовании источника данных Oracle, если отчет с разбивкой на страницы имеет тип запроса, заданный как хранимая процедура, он не может выполняться в служба Power BI из-за ограничения Шлюза 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.

Связанный контент

• Управление источником данных — Oracle
• Фильтрация, группа и сортировка данных (построитель отчетов Power BI)
• Выражения (Power BI построитель отчетов)