Подключение к базе данных Oracle из PowerAppsConnect to an Oracle database from PowerApps

Создание списка таблиц, а также создание, чтение, обновление и удаление строк таблицы в базе данных Oracle после подключения и создания приложения в PowerApps.List tables, and create, read, update and delete table rows in an Oracle database after you create a connection and build an app in PowerApps. Подключение к базе данных Oracle поддерживает полное делегирование фильтрации, сортировки и других функций, но не триггеров или хранимых процедур.The Oracle Database connection supports full delegation of filtering, sorting, and other functions but not triggers or stored procedures.

Технические условияPrerequisites

  • Oracle 9 и более поздней версииOracle 9 and later
  • Клиентское программное обеспечение Oracle 8.1.7 и более поздней версииOracle client software 8.1.7 and later
  • Установка локального шлюза данныхInstallation of an on-premises data gateway
  • Установка клиентского пакета SDK для OracleInstallation of the Oracle client SDK

Установка локального шлюза данныхInstall an on-premises data gateway

Чтобы установить шлюз, выполните действия, описанные в этом руководстве.To install a gateway, follow the steps in this tutorial.

Локальный шлюз данных выполняет функцию моста, обеспечивая быструю и безопасную передачу данных (которые не находятся в облаке) между локальной средой и службами Power BI, Microsoft Flow, Logic Apps и PowerApps.An on-premises data gateway acts as a bridge, providing quick and secure data transfer between on-premises data (data that isn't in the cloud) and the Power BI, Microsoft Flow, Logic Apps, and PowerApps services. Вы можете использовать один шлюз с несколькими службами и несколькими источниками данных.You can use the same gateway with multiple services and multiple data sources. Дополнительные сведения см. в статье Общие сведения о локальных шлюзах данных в Microsoft PowerApps.For more information, see Understand gateways.

Установка клиента OracleInstall Oracle client

На компьютере с локальным шлюзом данных установите 64-разрядную версию ODAC 12c, выпуск 4 (12.1.0.2.4) для Windows x64.On the same computer as the on-premises data gateway, install the 64-bit ODAC 12c Release 4 (12.1.0.2.4) for Windows x64. В противном случае при попытке создания или использования подключения появится сообщение об ошибке, как описано в списке известных проблем.Otherwise, an error will appear if you try to create or use the connection, as the list of known issues describes.

Создание приложения из таблицы в базе данных OracleCreate an app from a table in an Oracle database

  1. В PowerApps Studio в меню Файл (у левого края экрана) выберите Создать.In PowerApps Studio, click or tap New on the File menu (near the left edge).

    пункт меню "Создать"

  2. В разделе Начать с данных щелкните стрелку.Under Start with your data, click or tap the arrow.

    Появится список имеющихся подключений.A list of connections that you already have appears.

  3. Щелкните New connection (Создать подключение).Click or tap New connection.

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

  4. В списке подключений выберите База данных Oracle.In the list of connections, click or tap Oracle Database.

    Новая база данных

  5. Укажите имя сервера Oracle, имя пользователя и пароль.Specify the name of an Oracle server, a username, and a password.

    Если необходим идентификатор безопасности, укажите сервер в следующем формате:Specify a server in this format if an SID is required:
    имя_сервера/ИД_безопасностиServerName/SID

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

  6. Выберите шлюз, который вы хотите использовать, или установите новый.Click or tap the gateway that you want to use, or install one.

    Если шлюз не появляется после установки, нажмите кнопку Обновить список шлюзов.If your gateway doesn't appear after you install it, click Refresh gateway list.

    Новый шлюз

  7. Нажмите кнопку Создать, чтобы создать подключение.Click or tap Create to create the connection.

    Создание

  8. Выберите набор данных по умолчанию.Click or tap the default dataset.

    Создание

  9. В списке таблиц щелкните таблицу, которую вы хотите использовать.In the list of tables, click or tap the table that you want to use.

    Создание

  10. Щелкните Подключить для создания приложения.Click Connect to create the app.

    Создание

PowerApps создает приложение с тремя экранами и отображает данные из выбранной таблицы.PowerApps creates an app that has three screens and shows data from the table that you selected:

  • На экране BrowseScreen1 перечислены все записи в таблице.BrowseScreen1, which lists all entries in the table.
  • На экране DetailScreen1 отображаются все сведения об отдельном элементе.DetailScreen1, which provides more info about a single entry.
  • На экране EditScreen1 можно создать или обновить элемент.EditScreen1, in which users can update an entry or create an entry.

Создание

Дальнейшие действияNext steps

  • Чтобы сохранить только что созданное приложение, нажмите клавиши CTRL+S.To save the app that you've just generated, press Ctrl-S.
  • Чтобы настроить экран BrowseScreen1 (отображаемый по умолчанию), см. статью о настройке макета.To customize BrowseScreen1 (which appears by default), see Customize a layout.
  • Чтобы настроить экраны DetailsScreen1 или EditScreen1, см. статью о настройке формы.To customize DetailsScreen1 or EditScreen1, see Customize a form.

Руководства, известные проблемы и советы по устранению неполадокKnown issues, tips, and troubleshooting

  1. Невозможно связаться со шлюзом.Cannot reach the Gateway.

    Эта ошибка возникает, если локальному шлюзу не удается подключиться к облаку.This error appears if the on-premises data gateway can't connect to the cloud. Чтобы проверить состояние шлюза, войдите в powerapps.microsoft.com, щелкните Шлюзы и выберите шлюз, который вы хотите использовать.To check the status of your gateway, sign in to powerapps.microsoft.com, click or tap Gateways, and then click or tap the gateway that you want to use.

    Убедитесь, что шлюз запущен и может подключаться к Интернету.Make sure that your gateway is running and can connect to the Internet. Не следует устанавливать шлюз на выключенном компьютере или на компьютере в спящем режиме.Avoid installing the gateway on a computer that may be turned off or asleep. Кроме того, попробуйте перезапустить службу локального шлюза данных (PBIEgwService).Also try restarting the on-premises data gateway service (PBIEgwService).

  2. Пространству имен System.Data.OracleClient требуется клиентское программное обеспечение Oracle 8.1.7 и более поздней версии.System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.

    Эта ошибка возникает, если клиентский пакет SDK для Oracle установлен не на одном компьютере с локальным шлюзом данных.This error appears if the Oracle client SDK isn't installed on the same computer as the on-premises data gateway. Чтобы устранить эту проблему, установите клиент официального поставщика.To resolve this issue, install the official provider.

  3. В таблице [имя_таблицы] не определяются ключевые столбцы.Table '[Tablename]' does not define any key columns.

    Эта ошибка возникает при подключении к таблице без первичного ключа, который требуется для подключения к базе данных Oracle.This error appears if you're connecting to a table that doesn't have a primary key, which the Oracle Database connection requires.

  4. На данный момент хранимые процедуры, таблицы с составными ключами и типы вложенных объектов в таблицах не поддерживаются.As of this writing, stored procedures, tables with composite keys, and nested object types in tables aren't supported.