Oracle Database

Сводка

Товар	Описание
Статус релиза	Общая доступность
Продукция	Эксель Power BI (семантические модели) Power BI (потоки данных) Fabric (Dataflow 2-го поколения) Power Apps (потоки данных) Dynamics 365 Customer Insights Службы анализа
Поддерживаемые типы проверки подлинности	Windows (настольный/онлайн) База данных (рабочий стол) Базовый (онлайн) Учетная запись Майкрософт (рабочий стол)
Справочная документация по функциям	Oracle.Database

Замечание

Некоторые возможности могут присутствовать в одном продукте, но не другие из-за расписаний развертывания и возможностей для конкретного узла.

Предпосылки

Поддерживаемые версии Oracle:

• Oracle Database Server 12c (12.1.0.2) и более поздних версий
• Автономная база данных Oracle — все версии

Прежде чем подключиться к базе данных Oracle с помощью Power Query, необходимо установить клиент Oracle для Microsoft Tools (OCMT). Чтобы подключиться к базе данных Oracle с локальным шлюзом данных, на компьютере под управлением шлюза необходимо установить 64-разрядный OCMT. Дополнительные сведения см. в описании "Управление источником данных " Oracle".

Замечание

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

Поддерживаемые возможности

• Импорт
• DirectQuery (семантические модели Power BI)
• Дополнительные параметры
  • Тайм-аут команды в минутах
  • Инструкция SQL
  • Включите столбцы связей
  • Навигация с помощью полной иерархии

Скачивание и установка клиента Oracle для Microsoft Tools

Клиент Oracle для Microsoft Tools устанавливает и настраивает Oracle Data Provider для .NET (ODP.NET) для поддержки 32-разрядных и 64-разрядных подключений инструментов Microsoft с локальными и облачными базами данных Oracle, включая Oracle Autonomous Database (ADB). OCMT — это графический установщик, который автоматизирует процесс установки клиента Базы данных Oracle. Она поддерживает подключение с помощью Power BI Desktop, службы Power BI, Fabric (Dataflow 2-го поколения), Excel, SQL Server Analysis Services, SQL Server Data Tools, SQL Server Integration Services, SQL Server Reporting Services и BizTalk Server.

OCMT — это бесплатное программное обеспечение. Его можно скачать на странице Oracle Client for Microsoft Tools. Для 64-разрядной версии Power BI Desktop и службы Power BI используйте 64-разрядную версию OCMT. Для 32-разрядной версии Power BI Desktop используйте 32-разрядную версию OCMT.

Даже если у вас уже установлен клиент Oracle или ODP.NET на клиенте Power BI, настоятельно рекомендуется использовать установщик OCMT для правильного выполнения всех действий по настройке Power BI, необходимых для работы с базой данных Oracle.

• OCMT 64-разрядные и 32-разрядные загрузки
• Инструкции по установке и настройке OCMT

Подключение к локальной базе данных Oracle из Power Query Desktop

Чтобы сделать подключение, выполните следующие действия.

1. Выберите параметр базы данных Oracle в выборе соединителя.

2. Укажите имя службы Oracle net или псевдоним TNS или строку подключения Easy Connect (плюс) для подключения к серверу. Easy Connect является самым простым в использовании методом, задав значение сервера для вашей Oracle Database, Hostname/ServiceName, где ServiceName — это глобальное имя базы данных. На следующем снимке экрана используется имя сетевой службы.

   

3. Если вы подключаетесь из Power BI Desktop, выберите режим подключения к данным: импорт или DirectQuery. В остальных примерах действий используется режим подключения к данным импорта. Дополнительные сведения о DirectQuery см. в разделе Использование DirectQuery в Power BI Desktop.

4. Если вы впервые подключаетесь к этой базе данных Oracle, выберите тип проверки подлинности, который вы хотите использовать, и введите свои учетные данные. Доступны следующие типы проверки подлинности:

   • Windows (проверка подлинности Windows)
   • База данных (имя пользователя и пароль)
   • Учетная запись Майкрософт (идентификатор Microsoft Entra)

   Дополнительные сведения о проверке подлинности см. в аутентификации с помощью источника данных.

   

5. В навигаторевыберите необходимые данные, а затем выберите Загрузить данные для загрузки данных или Преобразовать данные для преобразования данных.

Подключение к локальной базе данных Oracle из Power Query Online

Чтобы сделать подключение, выполните следующие действия.

1. Установите и настройте локальный шлюз данных.

2. В Power Query Online выберите параметр базы данных Oracle в выборе источников данных.

3. В появившемся диалоговом окне базы данных Oracle укажите псевдоним службы Oracle net или TNS, строку подключения Easy Connect Plus или дескриптор подключения для подключения к серверу.

   

4. Укажите имя подключения, например testoracleserver.

5. Выберите имя локального шлюза данных.

   Замечание

   Для этого соединителя необходимо выбрать локальный шлюз данных, независимо от того, находится ли база данных Oracle в локальной сети или на веб-сайте.

6. Если вы впервые подключаетесь к этой базе данных Oracle, выберите тип учетных данных для подключения в типе проверки подлинности. Выберите "Базовый", если вы планируете войти с помощью имени пользователя и пароля Oracle. Выберите Windows при использовании проверки подлинности операционной системы Windows и с клиентом Oracle и сервером, работающим в Windows.

7. Введите свои учетные данные.

8. Выберите Далее для продолжения.

9. В Навигаторе выберите необходимые данные, а затем выберите Преобразовать данные", чтобы преобразовать данные в Редакторе Power Query.

Подключение к автономной базе данных Oracle

Замечание

В настоящее время вы можете подключиться к автономной базе данных Oracle из Excel, Power BI Desktop, службы Power BI, Fabric (Dataflow 2-го поколения), Power Apps, SQL Server Analysis Services и BizTalk Server с помощью процедур, описанных в этом разделе. Эти инструменты используют ODP.NET без управления для подключения. Другие средства Майкрософт, в том числе SQL Server Data Tools, SQL Server Integration Services и SQL Server Reporting Services, используют управляемые ODP.NET для подключения к автономной базе данных Oracle, используя в значительной степени аналогичные процедуры.

Чтобы подключить Power BI к автономной базе данных Oracle, вам потребуются следующие учетные записи и приложения:

• Учетная запись Oracle.com (регистрация Oracle.com учетной записи)
• Учетная запись Oracle Cloud (регистрация учетной записи Oracle Cloud)
• Автономная база данных Oracle (Получите Always Free Autonomous Database)
• Power BI Desktop (Получить Power BI Desktop) или учетная запись службы Power BI (Лицензирование службы Power BI для пользователей вашей организации)
• Локальный шлюз данных при использовании службы Power BI (скачивание и установка стандартного шлюза)

Скачивание учетных данных клиента

Первым шагом в настройке подключения к автономной базе данных Oracle является скачивание учетных данных клиента.

Чтобы скачать учетные данные клиента, выполните приведенные далее действия.

1. На странице сведений об автономной базе данных Oracle выберите "Подключение к базе данных".

   

2. На странице "Подключение к базе данных" выберите "Скачать кошелек".

   

3. Введите пароль, который вы хотите использовать с этим кошельком, подтвердите пароль, а затем нажмите кнопку "Скачать".

   

Настройка учетных данных Oracle ADB

1. На компьютере с Windows перейдите в папку, в которой вы скачали клиентские учетные данные Oracle ADB, используя Download your client credentials.

2. Распакуйте учетные данные в каталог, указанный в OCMT, в качестве каталога файла конфигурации Oracle. В этом примере учетные данные извлекаются в c:\data\wallet\wallet_contosomart.

   

   Замечание

   Файл tnsnames.ora определяет адрес автономной базы данных Oracle и сведения о подключении.

3. Откройте sqlnet.ora в редакторе, например Блокнот.

4. В WALLET_LOCATION измените путь к папке кошелька в параметре "Каталог". В этом примере:

   WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))

5. Сохраните и закройте файл sqlnet.ora.

Откройте файл tnsnames.ora в папке кошельков. Файл содержит список имен сетевых служб ADB, к которым можно подключиться. В этом примере имена — contosomart_high, contosomart_low и contosomart_medium. Имена сетевых служб ADB отличаются.

Подключение Power BI Desktop к Oracle ADB

1. Откройте Power BI Desktop.

2. Выберите Получить данные.

3. В поле "Получить данные" выберитебазу данных Oracle>.

4. Введите имя службы net сервера автономной базы данных Oracle, к которому вы хотите подключиться. В этом примере Сервер — contosomart_high. Затем выберите OK.

   

5. Если вы впервые вошли на этот сервер из Power BI Desktop, вам будет предложено ввести свои учетные данные. Выберите базу данных, а затем введите имя пользователя и пароль для базы данных Oracle. Указанные здесь учетные данные — это имя пользователя и пароль для конкретной автономной базы данных Oracle, к которой вы хотите подключиться. В этом примере используются имя пользователя и пароль начального администратора базы данных. В этом случае выберите Подключиться.

   

   Замечание

   Вы можете использовать проверку подлинности идентификатора Microsoft Entra для входа в автономную базу данных Oracle с помощью параметра учетной записи Майкрософт .

На этом этапе навигатор появится и отображает данные подключения.

Вы также можете столкнуться с одной из нескольких ошибок, так как конфигурация не настроена должным образом. Эти ошибки рассматриваются в разделе "Устранение неполадок".

Одна из ошибок, которая может произойти в этом первоначальном тесте, происходит в навигаторе, где база данных, как представляется, подключена, но не содержит данных. Вместо данных появляется ошибка Oracle: ORA-28759: ошибка при открытии файла.

Если эта ошибка возникает, убедитесь, что путь к папке кошелька, предоставленной в sqlnet.ora, является полным и правильным путем к папке кошелька.

Настройка шлюза

1. Установите и настройте локальный шлюз данных.

2. В службе Power BI выберите значок шестеренки в правом верхнем углу, а затем выберите пункт "Управление шлюзами".

   

3. В разделе "Добавление источника данных" выберите "Добавить источники данных" для использования шлюза.

   

4. В поле Имя источника данных введите имя, которое вы хотите использовать в качестве параметра источника данных.

5. В типе источника данных выберите Oracle.

6. В поле "Сервер" введите сетевое имя службы сервера автономной базы данных Oracle для подключения.

7. В методе проверки подлинности выберите "Базовый".

8. Введите имя пользователя и пароль для автономной базы данных Oracle. В этом примере используются имя пользователя администратора базы данных по умолчанию (ADMIN) и пароль.

9. Выберите Добавить.

   

Если все установлено и настроено правильно, появится сообщение об успешном подключении . Теперь вы можете подключиться к автономной базе данных Oracle, выполнив те же действия, которые описаны в разделе "Подключение к локальной базе данных Oracle из Power Query Online".

Подключитесь с использованием дополнительных параметров

Power Query Desktop и Power Query Online предоставляют набор дополнительных параметров, которые можно добавить в запрос при необходимости.

В следующей таблице перечислены все дополнительные параметры, которые можно задать в Power Query Desktop и Power Query Online.

Дополнительный параметр	Описание
Тайм-аут команды в минутах	Если подключение длится дольше 10 минут (время ожидания по умолчанию), можно ввести другое значение в минутах, чтобы сохранить подключение открытым дольше. Этот параметр доступен только в Power Query Desktop.
Инструкция SQL	Дополнительные сведения см. в статье Импорта данных из базы данных с помощью собственного запроса к базе данных.
Включите столбцы связей	Если установлен флажок, содержит столбцы, которые могут иметь связи с другими таблицами. Если это поле очищается, эти столбцы не отображаются.
Навигация с помощью полной иерархии	Если флажок отмечен, навигатор отображает полную иерархию таблиц в базе данных, к которой вы подключаетесь. При очистке навигатор отображает только таблицы, столбцы и строки которых содержат данные.

Выбрав необходимые дополнительные параметры, нажмите кнопку "ОК " в Power Query Desktop или "Далее " в Power Query Online, чтобы подключиться к базе данных Oracle.

Использование встроенного драйвера Oracle (предварительная версия)

Начиная с версии Power BI Desktop за апрель 2025 г. и версии шлюза данных локальной установки за май 2025 г., соединитель Oracle включает встроенный управляемый драйвер Oracle ODP.NET для подключения. Эта функция устраняет необходимость установки драйвера и управления ими. Эту функцию можно включить, следуя приведенным ниже инструкциям.

Чтобы использовать этот встроенный драйвер в Power BI Desktop, перейдите в раздел Параметры и настройки (на вкладке Файл) >Параметры>Предварительные функции, а затем установите флажок, чтобы включить опцию Включение использования поставщика Oracle Managed ODP.

Чтобы использовать этот встроенный драйвер в локальном шлюзе данных, измените конфигурации шлюза, чтобы обновить MashupFlight_EnableOracleBundledOdacProvider параметр, выполнив следующие действия.

1. На локальном компьютере, на котором установлен локальный шлюз данных, перейдите к C:\Program Files\Локальный шлюз данных.
2. Создайте резервную копию файла конфигурации с именем Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.
3. Откройте исходный файл конфигурации Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config и найдите запись MashupFlight_EnableOracleBundledOdacProvider.
4. Обновите значение MashupFlight_EnableOracleBundledOdacProvider как True.
5. Перезапустите шлюз.

<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
   ...
   <setting name="MashupFlight_EnableOracleBundledOdacProvider" serializeAs="String">
      <value>True</value>
   </setting>
   ...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>    

Остальные конфигурации для подключения к базе данных Oracle из Power Query Desktop аналогичны описанным в предыдущих разделах.

Известные проблемы и ограничения

Сеансы Power BI по-прежнему могут быть активными в базе данных Oracle примерно через 30 минут после обновления семантической модели до этой базы данных Oracle. Только через 30 минут эти сеансы становятся неактивными или удалены в базе данных Oracle. Это поведение является намеренным.

Устранение неполадок

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

• ORA-12154: TNS: не удалось устранить указанный идентификатор подключения.
• ORA-12514: TNS: прослушиватель в настоящее время не знает о службе, запрошенной в дескрипторе подключения.
• ORA-12541: TNS: нет прослушивателя.
• ORA-12170: TNS: истекло время ожидания соединения.
• ORA-12504: TNS: прослушиватель не получил SERVICE_NAME в CONNECT_DATA.

Эти ошибки могут возникать, если дескриптор подключения к базе данных Oracle tnsnames.ora неправильно настроен, имя сетевой службы указано неправильно, или прослушиватель базы данных Oracle не запущен или недоступен, например, из-за брандмауэра, блокирующего прослушиватель или порт базы данных. Убедитесь, что вы выполняете минимальные предварительные требования для установки. Дополнительные сведения: Предварительные условия

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

Если вы скачали Power BI Desktop из Microsoft Store, возможно, не удается подключиться к базам данных Oracle из-за проблемы с драйвером Oracle. При возникновении этой проблемы возвращается сообщение об ошибке: ссылка на объект не задана. Чтобы устранить проблему, сделайте следующее:

• Скачайте Power BI Desktop из Центра загрузки вместо Microsoft Store.

Если в Power BI появляется сообщение об ошибке ссылка на объект не установлена при подключении к базе данных Oracle через локальный шлюз данных, обратитесь к разделу Управление источником данных - Oracle.

Если вы используете сервер отчетов Power BI, ознакомьтесь с руководством в статье " Тип подключения Oracle ".

Дальнейшие шаги

Оптимизация Power Query при раскрытии столбцов таблицы