Тип соединения Oracle (SSRS и сервер отчетов Power BI)

  • Статья

Область применения: SQL Server 2016 (13.x) Reporting Services и более поздних версий Power BI построитель отчетов Сервер отчетов Power BI

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

Используйте сведения в этой статье для создания источника данных. Пошаговые инструкции см. в разделе Добавление и проверка подключения к данным (построитель отчетов и службы SSRS).

Важно!

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

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

На сайте загрузки Oracle установите 64-разрядную версию Oracle ODAC OUI. При использовании драйверов Oracle ODAC 12.2 и более поздних версий потребуются только следующие шаги. В противном случае они устанавливаются по умолчанию в конфигурации, которая не охватывает весь компьютер, для новой установки Oracle Home. В этих шагах предполагается, что вы установили файлы ODAC 18.x в папку c:\oracle64.

В отчетах с разбивкой на страницы (RDL) используется управляемый драйвер ODP.NET

Сервер отчетов Power BI и SQL Server Reporting Services 2016 и более поздней версии используют управляемый драйвер ODP.NET для отчетов с разбивкой на страницы (RDL). Чтобы зарегистрировать управляемый драйвер ODP.NET, следуйте приведенным ниже инструкциям.

  1. Зарегистрируйте управляемый клиент 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

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

Отчеты Power BI используют неуправляемый драйвер ODP.NET

Сервер отчетов Power BI использует неуправляемый драйвер ODP.NET для отчетов Power BI. Чтобы зарегистрировать неуправляемый драйвер ODP.NET, следуйте приведенным ниже инструкциям.

  1. Зарегистрируйте неуправляемый клиент 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\bin\4\Oracle.DataAccess.dll

  2. Добавьте записи неуправляемого клиента ODP.NET в файл machine.config:

    C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odp /frameworkversion:v4.0.30319 /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll

32-разрядные драйверы для Построителя отчетов (Майкрософт)

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

64-разрядные и 32-разрядные драйверы для Power BI Desktop

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

64-разрядная версия Power BI Desktop

  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\bin\4\Oracle.DataAccess.dll

  3. Добавьте записи неуправляемого клиента ODP.NET в файл machine.config:

    C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odp /frameworkversion:v4.0.30319 /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll

32-разрядная версия Power BI Desktop

  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\bin\4\Oracle.DataAccess.dll

  3. Добавьте записи неуправляемого клиента ODP.NET в файл machine.config:

    C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odp /frameworkversion:v4.0.30319 /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\Oracle.DataAccess.dll

Строка подключения

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

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

Дополнительные сведения о примерах строк подключения см. в статье Create data connection strings - Report Builder & SSRS (Создание строк подключения к данным (построитель отчетов и службы SSRS))

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

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

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

Дополнительные сведения см. в статье Задание учетных данных и сведениях о соединении для источников данных отчета.

Запросы

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

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

Параметры

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

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

Замечания

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

Дополнительные сведения см. в следующих статьях:

Альтернативные модули обработки данных

Также данные из базы данных Oracle можно получить с помощью источника данных OLE DB. Дополнительные сведения см. в разделе Тип соединения OLE DB (SSRS).

Модели отчетов

Также можно создавать модели на основе базы данных Oracle.

Сведения о платформе и версии

Дополнительные сведения о поддержке платформ и версий см. в статье Источники данных, поддерживаемые службами Reporting Services (SSRS).

См. также

Параметры отчета (построитель отчетов и конструктор отчетов)

Фильтрация, группировка и сортировка данных (построитель отчетов и службы SSRS)

Выражения (построитель отчетов и службы SSRS)