Поделиться через

База данных Oracle

Oracle Database — это реляционная система управления базами данных, разработанная Oracle. Подключитесь к локальной базе данных Oracle, чтобы выполнить различные действия, такие как создание, обновление, получение и удаление строк в таблице.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps
Power Automate Премия Все регионы Power Automate
Контакт
Имя Microsoft
URL Поддержка Microsoft LogicApps
Поддержка Microsoft Power Automate
Поддержка Microsoft Power Apps
Метаданные соединителя
Publisher Microsoft
Веб-сайт https://www.oracle.com/database/
Политика конфиденциальности https://www.oracle.com/legal/privacy/

В этой статье описываются операции соединителя Базы данных Oracle, доступные для Azure Logic Apps, Microsoft Power Apps и Microsoft Power Automate. Этот соединитель можно использовать для подключения к локальной базе данных Oracle или виртуальной машине Azure с установленной базой данных Oracle.

Что нового

В следующей таблице описываются новые обновления и возможности для Oracle Databaseconnector:

Update Description
Октябрь 2018 г. Поддерживает хранимую процедуру Oracle.
Январь 2018 г. Поддерживает представление Oracle как таблицу только для чтения.

Предпосылки

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

    • Oracle 9 и более поздних версий
    • Клиент Oracle Data Access (ODAC) 11.2 и более поздних версий

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

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

  • Установите клиент Oracle на компьютере, на котором установлен локальный шлюз данных. Установите 64-разрядный поставщик данных Oracle для .NET из Oracle и выберите версию установщика Windows, так как xcopy версия не работает с локальным шлюзом данных: 64-разрядная версия ODAC 12c версии 4 (12.1.0.2.4) для Windows x64. Чтобы проверить установку, выполните следующую команду PowerShell: [System.Data.Common.DbProviderFactories]::GetFactoryClasses() Если клиент Oracle установлен, в результатах должно появиться сообщение "Поставщик данных OracleClient".

    Замечание

    Если клиент Oracle не установлен, при попытке создать или использовать подключение возникает ошибка. Дополнительные сведения см. в разделе "Распространенные ошибки подключения".

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

    Этот параметр включает замену строковых литералов NCHAR, что предотвращает потерю данных при вставке строковых литералов, содержащих символы за пределами набора символов базы данных, в столбец типа NCHAR/NVARCHAR/NCLOB . При выполнении инструкции строковые литералы преобразуются в внутренний формат и затем правильно декодируются в Юникод.

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

В следующем списке описаны некоторые известные ограничения соединителя Oracle Datbase:

  • Не поддерживается:

    • Любая таблица с составными ключами
    • Вложенные типы объектов в таблицах
    • Функции базы данных с не скалярными значениями
    • Функции Oracle, поэтому они не перечислены в пользовательском интерфейсе.

  • При вызове хранимой процедуры на сервере Oracle применяются следующие ограничения:

    • Параметры OUT не поддерживаются.
    • Возвращаемое значение недоступно, так как хранимая процедура не возвращает результаты.

  • Ограничение размера ответа составляет 8 МБ.

  • Ограничение размера запроса составляет 2 МБ.

  • Собственный запрос Oracle поддерживается со следующими ограничениями:

    • Требуется шлюз версии 3000.63.4 (октябрьский выпуск) или более поздней версии.
    • RefCursor не поддерживается.
    • Параметры OUT не поддерживаются.
    • Можно вернуть только один результирующий набор.

  • Следующие типы данных нельзя использовать в качестве предикатов параметра запроса:

    • DATE
    • TIMESTAMP
    • TIMESTAMP с часовыми поясами
    • TIMESTAMP с локальным часовой поясом

  • Если любой запрос Oracle или время выполнения хранимой процедуры превышает 110 секунд, время ожидания действия истекает.

  • Вставка и обновление таблицы не возвращают полный элемент. Они возвращают только входные свойства для операции.

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

  • Для операции вставки строки требуется явное значение для столбца первичного ключа, даже если задано значение по умолчанию или автоинкременту.

  • Из-за ограничений компонентов пользовательского интерфейса список таблиц, отображаемых во время разработки, не может отображать более 2048 элементов, размер страницы по умолчанию для операции Get таблиц , например:

    • Список таблиц для параметра действия "Получить строки " с именем "Имя таблицы".
    • Список таблиц для потока "Создание подключения или выбор таблицы" в конструкторе Power Apps.

  • Если при работе с базой данных Oracle наблюдается задержка, установите последние 64-разрядные компоненты Доступа к данным Oracle (ODAC) на компьютере шлюза или каждом компьютере шлюза, если шлюз является кластером.

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

Распространенные ошибки при подключении

Ошибка. Не удается достичь шлюза

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

Устранение рисков. Убедитесь, что шлюз запущен на локальном компьютере, где установлен шлюз и имеет подключение к Интернету. Избегайте установки шлюза на компьютере, который может быть отключен или включен в спящий режим. Вы также можете попробовать перезапустить локальную службу шлюза данных (PBIEgwService).

Ошибка: используемый поставщик не рекомендуется: "System.Data.OracleClient требует клиентского программного обеспечения Oracle версии 8.1.7 или более поздней.". Ознакомьтесь https://go.microsoft.com/fwlink/p/?LinkID=272376 с установкой официального поставщика.

Причина. Клиентский пакет SDK Oracle не установлен на компьютере, на котором запущен локальный шлюз данных.

Решение. Скачайте и установите клиентский пакет SDK Oracle на том же компьютере, что и локальный шлюз данных.

Ошибка: таблица "[Имя таблицы]" не определяет ключевые столбцы

Причина. В таблице нет первичного ключа.

Разрешение. Соединитель Базы данных Oracle требует использования таблицы с первичным ключевым столбцом.

Общие ограничения

Имя Ценность
Максимальное количество запросов, обрабатываемых соединителем одновременно на соединение 200
Максимальное количество мегабайт, передаваемых через соединитель одновременно на подключение 30

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

Соединитель поддерживает следующие типы проверки подлинности:
По умолчанию Параметры для создания подключения. Все регионы Доступный для общего пользования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя Тип Description Обязательно
Сервер струна Укажите oracle Server. Если требуется порт или идентификатор безопасности, укажите в виде serverName:Port/SID. True
Тип проверки подлинности [Выбор базового] струна Тип проверки подлинности для подключения к базе данных
Имя пользователя securestring Учетные данные пользователя True
Пароль securestring Учетные данные пароля True
Gateway gatewaySetting Локальный шлюз (дополнительные сведения см. в разделе https://docs.microsoft.com/data-integration/gateway "Дополнительные сведения" True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 1500 60 секунд

Действия

Вставка строки

Эта операция вставляет новую строку в таблицу.
Выполнение запроса Oracle

Выполнение запроса Oracle
Выполнение хранимой процедуры

Эта операция выполняет хранимую процедуру.
Обновление строки

Эта операция обновляет существующую строку в таблице.
Получение строк

Эта операция получает строки из таблицы.
Получение строки

Эта операция получает строку из таблицы.
Получение таблиц

Эта операция получает таблицы из базы данных.
Удаление строки

Эта операция удаляет строку из таблицы.

Вставка строки

Идентификатор операции:
PostItem

Эта операция вставляет новую строку в таблицу.

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Имя таблицы
Строка
 item True dynamic

Строка для вставки в указанную таблицу

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Выполнение запроса Oracle

Идентификатор операции:
ExecutePassThroughNativeQuery

Выполнение запроса Oracle

Параметры

Имя Ключ Обязательно Тип Описание
Query
 query True dynamic

Текст запроса

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Выполнение хранимой процедуры

Идентификатор операции:
ExecuteProcedure

Эта операция выполняет хранимую процедуру.

Параметры

Имя Ключ Обязательно Тип Описание
Имя процедуры
 procedure True string

Имя хранимой процедуры
Список параметров
 parameters True dynamic

Входные параметры хранимой процедуры

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Обновление строки

Идентификатор операции:
PatchItem

Эта операция обновляет существующую строку в таблице.

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Имя таблицы
Идентификатор строки
 id True string

Уникальный идентификатор строки для обновления
Строка
 item True dynamic

Строка с обновленными значениями

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение строк

Идентификатор операции:
GetItems

Эта операция получает строки из таблицы.

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Имя таблицы Oracle
Запрос фильтра
 $filter string

Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123).
Заказ по
 $orderby string

Запрос oDATA orderBy для указания порядка записей.
Первое число
 $top integer

Общее количество записей для получения (по умолчанию = все).
Пропустить число
 $skip integer

Количество пропускаемых записей (по умолчанию = 0).
Выбор запроса
 $select string

Определенные поля для извлечения из записей (по умолчанию = все).

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение строки

Идентификатор операции:
GetItem

Эта операция получает строку из таблицы.

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Имя таблицы Oracle
Идентификатор строки
 id True string

Уникальный идентификатор строки для извлечения

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение таблиц

Идентификатор операции:
GetTables

Эта операция получает таблицы из базы данных.

Возвращаемое значение

Представляет список таблиц.

Тело
TablesList

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

Идентификатор операции:
DeleteItem

Эта операция удаляет строку из таблицы.

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Имя таблицы
Идентификатор строки
 id True string

Уникальный идентификатор строки для удаления

Определения

Таблица

Представляет таблицу.

Имя Путь Тип Описание
Имя
 Name string

Название таблицы. Имя используется во время выполнения.
Отображаемое имя
 DisplayName string

Отображаемое имя таблицы.
DynamicProperties
 DynamicProperties object

Дополнительные свойства таблицы, предоставляемые соединителем клиентам.

TablesList

Представляет список таблиц.

Имя Путь Тип Описание
value
 value array of Table

Список таблиц