Oracle Database

Итоги

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

Примечание.

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

Необходимые компоненты

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

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

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

Чтобы подключиться к базе данных Oracle с локальным шлюзом данных, на компьютере под управлением шлюза необходимо установить 64-разрядный OCMT. Дополнительные сведения см. в описании "Управление источником данных " Oracle".

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

• Import
• DirectQuery (семантические модели Power BI)
• Дополнительные параметры
  • Время ожидания команды в минутах
  • SQL statement
  • Включить столбцы отношений
  • Выполнять навигацию по всей иерархии

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

Клиент Oracle для Microsoft Tools устанавливает и настраивает поставщик данных Oracle для .NET (ODP.NET) для поддержки 32-разрядных и 64-разрядных подключений к средствам Майкрософт с локальными и облачными базами данных Oracle, включая автономную базу данных Oracle (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 или простую Подключение (плюс) строка подключения для подключения к серверу. Простейший Подключение — это самый простой способ использовать, задав значение сервера Базы данных Oracle в имя узла сервера базы данных Oracle или Имя службы, где ServiceName — это глобальное имя базы данных. На следующем сниме экрана используется имя службы net.

   

3. Если вы подключаетесь из Power BI Desktop, выберите режим подключения к данным Import или 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 Подключение Plus строка подключения или подключите дескриптор для подключения к серверу.

   

4. Укажите имя Подключение ion, например 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)
• Power BI Desktop (получение Power BI Desktop) или учетная запись служба Power BI (лицензирование служба Power BI для пользователей в организации)
• Локальный шлюз данных при использовании служба Power BI (скачивание и установка стандартного шлюза)

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

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

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

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

   

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

   

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

   

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

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

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 Database>.

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. Выберите Добавить.

   

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

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

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

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

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

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

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

Сеансы 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 неправильно настроен, имя службы net, предоставленное неправильно, или прослушиватель базы данных Oracle не запущен или недоступен, например брандмауэр, блокирующий прослушиватель или порт базы данных. Убедитесь, что вы выполняете минимальные предварительные требования для установки. Дополнительные сведения: Предварительные условия

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

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

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

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

Если вы используете Сервер отчетов Power BI, ознакомьтесь с руководством в статье Oracle Подключение ion Type.

Следующие шаги

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