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 — все версии

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

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

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

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

Подключение из 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. В навигаторевыберите необходимые данные, а затем выберите Загрузить данные для загрузки данных или Преобразовать данные для преобразования данных.

Подключение из Power Query Online

Локальная база данных

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

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

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

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

   

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

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

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

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

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

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

Дополнительные сведения

Использование варианта Oracle Client for Microsoft Tools (OCMT)

Клиент 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

Замечание

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

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

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

Дополнительные параметры

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

Для версии 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>    

Замечание

После изменения MashupFlight_DisableOracleBundledOdacProviderV2 параметра в файле Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config конфигурация сохраняется при обновлении локального шлюза данных.

Замечание

Если ваши семантические модели по-прежнему используют личный шлюз для подключения к локальным источникам данных Oracle, перейдите на корпоративный локальный шлюз данных или шлюз виртуальной сети (VNET) либо переведите облачные рабочие нагрузки Oracle на прямые облачные подключения. Обновленный соединитель Oracle не поддерживает личные локальные шлюзы данных, это относится как к режиму импорта, так и к режиму DirectQuery. Существующие семантические модели могут продолжать использовать личный шлюз, пока не обновите привязку подключения к данным. После обновления привязки вы не сможете вернуться к личному шлюзу. Запланируйте обновление подключений Oracle соответствующим образом.

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

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

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

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

Поддерживаемые способы указания 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>

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

Замечание

Важные ограничения

• Использование встроенного управляемого драйвера Oracle ODP.NET для DirectQuery доступно в режиме предварительной версии. Дополнительные сведения см. в предыдущих разделах DirectQuery.
• Для ODAC.config файла могут потребоваться права администратора для редактирования, а приложение Power BI Store не разрешает изменять этот файл.
• Изменения, внесенные в ODAC.config, перезаписываются во время обновления и необходимо сохранить файл в другом расположении перед обновлением.
• Для правильной работы локального шлюза данных убедитесь, что пользователь, под которым запущена служба шлюза, имеет доступ к папке, на которую указывает TNS_ADMIN.
• Перезапустите Power BI Desktop или локальную службу шлюза данных после применения изменений конфигурации.

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

Сеансы 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 ".

Известные проблемы со встроенным драйвером Oracle

Следующие известные проблемы относятся к встроенному управляемому ODP Oracle.NET драйверу. Некоторые из обходных решений используют неуправляемый драйвер ODP.NET, отключая встроенный драйвер. Инструкции по отключению для каждого варианта — Power BI Desktop (Import и DirectQuery) и шлюза (Import и DirectQuery) — см. в разделе Использование встроенного драйвера Oracle.

Псевдонимы TNS на сетевом ресурсе не распознаются

Применяется к локальному шлюзу данных в импорте и DirectQuery.

Если файлы конфигурации сети Oracle (tnsnames.ora или каталог TNS_ADMIN) хранятся на сетевом ресурсе (UNC-путь), встроенному драйверу стабильно не удается разрешить сетевое имя службы (псевдоним TNS). Возможно, вы увидите ORA-12154: TNS:could not resolve the connect identifier specified или ORA-50201: Failed to connect to server. Тот же псевдоним корректно разрешается с неуправляемым драйвером ODP.NET или когда файлы находятся по локальному пути. Встроенный управляемый драйвер не надежно считывает файлы конфигурации сети Oracle из расположения UNC.

Используйте одно из следующих обходных решений:

• Скопируйте tnsnames.ora (и sqlnet.ora, если используете его) в папку на локальном диске, а затем укажите драйверу путь к этой папке. См. сведения о поддерживаемых способах указания TNS_ADMIN с помощью встроенного драйвера Oracle. Для шлюза DirectQuery установите TNS_ADMIN в системной области (на уровне компьютера), так как учетная запись службы шлюза не может считывать переменные уровня пользователя, а затем перезапустите службу шлюза.
• Убедитесь, что учетная запись службы, от имени которой работает шлюз, имеет доступ к сетевому общему ресурсу.
• Введите дескриптор Easy Connect непосредственно в сервере (например, host:port/service_nameвместо tnsnames.ora псевдонима), поэтому файл конфигурации сети не нужен.
• Отключите встроенный драйвер, чтобы переключиться на неуправляемый драйвер ODP.NET, который может считывать файлы с общего ресурса.

NLS_LANG игнорируется

Применяется к Power BI Desktop, локальному шлюзу данных и облачным подключениям Power BI Service как в режиме импорта, так и в режиме DirectQuery.

При использовании встроенного драйвера язык сеанса Oracle, территория, а также форматы чисел и дат определяются культурой .NET компьютера (региональными параметрами и форматами Windows), а не переменной среды NLS_LANG. Настройка или изменение NLS_LANG не влияет. В зависимости от региональных настроек компьютера это поведение может привести к тому, что числа или даты будут разбираться с неправильными разделителями или в неправильном порядке, запросы не будут возвращать ни одной строки или будут возвращать неправильные значения, а также могут возникать ошибки, такие как ORA-01722, ORA-01858, ORA-01861 или ORA-01843. Например, отчет, созданный на компьютере на английском языке (США), может возвращать нулевые строки или ошибки на компьютере, заданном на английском языке (Соединенное Королевство). Управляемый драйвер ODP.NET получает параметры National Language Support (NLS) из культуры потока .NET, а не из NLS_LANG, в отличие от неуправляемого драйвера ODP.NET, который использует NLS_LANG.

Используйте одно из следующих обходных решений:

• Приведите региональные параметры компьютера в соответствие с локалью, для которой были созданы ваши данные и запросы.
• Отключите встроенный драйвер, чтобы переключиться на неуправляемый драйвер ODP.NET, который учитывает NLS_LANG.

Общие сведения о поведении глобализации управляемого драйвера см. в документации по поддержке глобализации Oracle.

FetchSize в реестре не используется встроенным драйвером

Применяется к Power BI Desktop и локальному шлюзу данных для моделей импорта Oracle.

После перехода на встроенный драйвер Модели Импорта Oracle могут обновляться медленнее, чем при использовании ODP.NET неуправляемого драйвера. Встроенный управляемый поставщик ODP.NET не считывает свойство FetchSize в реестре. Для неуправляемого и управляемого поставщиков ODP.NET значение FetchSize по умолчанию составляет 128 КБ в версии 23.26.2 и более ранних версиях, включая поставщик версии 23.6, входящий в состав Power BI. Управляемый поставщик игнорирует любое переопределение FetchSize, заданное в реестре.

Отключите встроенный драйвер, чтобы вернуться к ODP.NET неуправляемому драйверу, который учитывает параметр реестраFetchSize. В локальном шлюзе данных установите значение MashupFlight_DisableOracleBundledOdacProviderV2True в конфигурации с пакетным поставщиком в параметрах шлюза.

Аутентификация прокси-пользователя Oracle не поддерживается

Применяется к локальному шлюзу данных (июнь 2026 г. и более поздней версии) для Oracle Import и DirectQuery, использующих учетную запись прокси-сервера Oracle.

После обновления до шлюза за июнь 2026 года, который по умолчанию использует встроенный управляемый поставщик, отчеты Power BI, подключающиеся к Oracle с помощью прокси-учетной записи Oracle, завершаются сбоем как в режиме импорта, так и в режиме DirectQuery. Тот же источник данных работает, если подключение использует непрокси-учетную запись Oracle. Аутентификация прокси-пользователя Oracle Database — подключение от имени одного пользователя базы данных к другой схеме (например, в форме User Id=proxy_user[target_schema]) — не поддерживается во встроенном управляемом поставщике ODP.NET версии 23.6, который в настоящее время поставляется с Power BI.

Используйте одно из следующих обходных решений:

• По возможности используйте учетную запись Oracle, не являющуюся прокси-учетной записью.
• Для импорта отключите встроенный драйвер для импорта в шлюзе, установив для этого параметр MashupFlight_DisableOracleBundledOdacProviderV2True, чтобы шлюз вернулся к ODP.NET неуправляемому драйверу, который поддерживает учетные записи прокси-сервера.
• Для DirectQuery параметр импорта не применяется. Обратитесь в службу поддержки Майкрософт, чтобы отключить встроенный драйвер для пути DirectQuery шлюза. Эта конфигурация сейчас недоступна для самостоятельной настройки.

Не удается обновить учетные данные для личных облачных подключений Oracle

Применяется к службе Power BI для личных облачных подключений к Oracle.

На странице "Управление подключениями и шлюзами" в служба Power BI обновление учетных данных личного облачного подключения Oracle не работает. Вместо этого обновите учетные данные из области параметров семантической модели:

1. Откройте область параметров семантической модели и перейдите к шлюзу и облачным подключениям.
2. Задайте источник данных для использования личного облачного подключения.
3. В разделе учетные данные источника данных измените учетные данные для источника данных.

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

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

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

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

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