Oracle Database

Сводка

Предпосылки

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

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

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

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

• Импорт
• 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

Чтобы подключить 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 ID для входа в автономную базу данных Oracle через параметр учетная запись Microsoft.

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

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

Одна из ошибок, которая может произойти в этом первоначальном тесте, происходит в навигаторе, где база данных, как представляется, подключена, но не содержит данных. Вместо данных появляется ошибка 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.

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

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

Для режима импорта в Power BI Desktop

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

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

Для режима DirectQuery в Power BI Desktop (предварительная версия)

Для режима DirectQuery использование встроенного управляемого драйвера Oracle ODP.NET всё ещё находится на стадии предварительной версии. Чтобы принять участие, используйте следующие инструкции.

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

Для режима импорта в локальном шлюзе

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

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

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

Для режима DirectQuery в локальном шлюзе (предварительная версия)

Локальный шлюз данных может использовать встроенный управляемый драйвер ODP.NET для Oracle для DirectQuery. Эта функция находится в режиме предварительного просмотра.

Чтобы устранить псевдоним TNS для DirectQuery, используйте переменную среды. Учетная запись службы шлюза не может получить доступ к переменным, заданным пользователем, поэтому установите TNS_ADMIN в области системы (компьютера), а затем перезапустите локальную службу шлюза данных.

Поддерживаемые способы указания TNS_ADMIN с помощью встроенного драйвера Oracle

Существует три варианта указания TNS_ADMIN:

• Настройка TNS_ADMIN в OADC.config
• Использование переменной среды
• Использование параметров из ранее установленного OADC

Настройка TNS_ADMIN в ODAC.config

Если вы используете встроенный драйвер Oracle и имеете доступ к изменению программных файлов, вы можете указать TNS_ADMIN в файле конфигурации ODAC.config, используемом встроенным драйвером Oracle. Файл находится в Power BI Desktop или в месте установки локального шлюза данных, в подпапке "Поставщики ADO.NET". Ниже приведен пример указания пути TNS_ADMIN, который имеет значение "C:\network\admin".

Это значение конфигурации имеет приоритет над другими параметрами.

Пример конфигурации

<configuration>
 ...
 <oracle.manageddataaccess.client>
  <version number="*">
   <settings>
    <setting name="TNS_ADMIN" value="C:\network\admin" />
   </settings>
  </version>
 </oracle.manageddataaccess.client>
 ...
</configuration>

Обратите внимание, что TNS_ADMIN, настроенные в ODAC.config, имеют приоритет над параметром TNS_ADMIN в среде.

Использование переменной среды

Если у пользователя нет доступа к изменению ODAC.config, он может указать TNS_ADMIN, добавив переменную среды TNS_ADMIN. Переменная среды может быть системной переменной среды или переменной среды пользователя для пользователя, работающего с Power BI Desktop или локальным шлюзом данных. Задайте для параметра TNS_ADMIN значение "C:\network\admin", например.

Установка TNS_ADMIN в среде (особенно на уровне системы) может привести к тому, что другие приложения, работающие на этом компьютере, могут собирать файлы конфигурации сети (например, tnsnames.ora) из расположения, на которое указывает TNS_ADMIN.

Использование параметров из ранее установленного ODAC

Если ODAC установлен ранее и TNS_ADMIN настроен, Power BI автоматически обнаруживает TNS_ADMIN.

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

Список разрешенных свойств

Пользователи могут указывать имена серверов Oracle с помощью дескрипторов подключения, таких как (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=host_name)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service_name))). Система применяет свойства, которые можно использовать в настольных компьютерах и шлюзах. Допустимые свойства ODAC.config по умолчанию перечислены в следующем разделе.

<configuration>
 ...
  <AllowLists>
    <!--
      Oracle connection strings can contain connection properties, for example  CONNECT_TIMEOUT.   Only connection properties explicitly set to true in the list below will
      be allowed with Power BI Desktop and the On Premises Data Gateway. Using our example, you can add "CONNECT_TIMEOUT":true to the list to enable it. To disable it you
      can remove it from the list, or set the value to false. This list will be enforced on all connection string types including connect descriptors and aliases
      referencing a tnsnames.ora entry. The use of any disallowed property in a connection string will result in an ORA-50122 error. Restart Power BI Desktop or the On-premises
      Data Gateway service after applying ODAC.config changes.
      For more information see https://docs.oracle.com/en/database/oracle/oracle-database/26/odpnt/InstallConnectionConfigurationRestriction.html
    -->
    <OnPremAllowList>{"DataSource":{"HOST":true,"PORT":true,"PROTOCOL":true,"HTTPS_PROXY":true,"HTTPS_PROXY_PORT":true,"ENABLE":true,"EXPIRE_TIME":true,"FAILOVER":true,"LOAD_BALANCE":true,"RECV_BUF_SIZE":true,"SDU":true,"SEND_BUF_SIZE":true,"SOURCE_ROUTE":true,"TYPE_OF_SERVICE":true,"COLOCATION_TAG":true,"CONNECTION_ID_PREFIX":true,"FAILOVER_MODE":true,"GLOBAL_NAME":true,"HS":true,"INSTANCE_NAME":true,"POOL_BOUNDARY":true,"POOL_CONNECTION_CLASS":true,"POOL_NAME":true,"POOL_PURITY":true,"RDB_DATABASE":true,"SHARDING_KEY":true,"SHARDING_KEY_ID":true,"SUPER_SHARDING_KEY":true,"SERVER":true,"SERVICE_NAME":true,"SID":true,"TUNNEL_SERVICE_NAME":true,"SSL_CLIENT_AUTHENTICATION":true,"SSL_CERTIFICATE_ALIAS":true,"SSL_CERTIFICATE_THUMBPRINT":true,"SSL_VERSION":true,"SSL_SERVER_DN_MATCH":true,"SSL_SERVER_CERT_DN":true,"WALLET_LOCATION":true,"CONNECT_TIMEOUT":true,"RETRY_COUNT":true,"RETRY_DELAY":true,"TRANSPORT_CONNECT_TIMEOUT":true,"RECV_TIMEOUT":true,"COMPRESSION":true,"COMPRESSION_LEVELS":true,"USE_SNI":true,"AUTHENTICATION_SERVICE":true,"IGNORE_ANO_ENCRYPTION_FOR_TCPS":true,"OCI_CONFIG_FILE":true,"OCI_DATABASE":true,"OCI_IAM_URL":true,"OCI_PROFILE":true,"OCI_TENANCY":true,"PASSWORD_AUTH":true,"REDIRECT_URI":true,"TENANT_ID":true,"TLS_VERSION":true,"TOKEN_AUTH":true,"TOKEN_LOCATION":true}}
    </OnPremAllowList>
  </AllowLists>
 ...
</configuration>

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

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

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

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

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

• ORA-12154: TNS: could not resolve the connect identifier specified.
• ORA-12514: TNS: listener does not currently know of service requested in connect descriptor.
• ORA-12541: TNS: no listener.
• ORA-12170: TNS: connect timeout occurred.
• ORA-12504: TNS: listener was not given the SERVICE_NAME in CONNECT_DATA.

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

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

При использовании DirectQuery через локальный шлюз данных со встроенным драйвером Oracle ошибки, такие как следующие, могут указывать на то, что псевдоним TNS не может быть разрешен:

• ORA-12154: TNS name resolution failure
• ORA-50201: Failed to connect to server

Если вы столкнулись с этими ошибками, убедитесь, что TNS_ADMIN задано в области системы (компьютера) и что учетная запись службы шлюза может получить доступ к папке, к которой она указывает, а затем перезапустите локальную службу шлюза данных. Дополнительные сведения см. в статье "Поддерживаемые способы указания TNS_ADMIN с помощью встроенного драйвера Oracle и руководства по устранению неполадок Oracle Net Services ".

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

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

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

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

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