Ligar a uma base de dados Oracle a partir do PowerAppsConnect to an Oracle database from PowerApps

Liste tabelas e crie, leia, atualize e elimine linhas de tabela numa base de dados Oracle, depois de criar uma ligação e criar uma aplicação no 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. A ligação da base de dados Oracle suporta a delegação completa de funções de filtragem, ordenação e outras, mas não acionadores ou procedimentos armazenados.The Oracle Database connection supports full delegation of filtering, sorting, and other functions but not triggers or stored procedures.

Pré-requisitosPrerequisites

  • Oracle 9 e posteriorOracle 9 and later
  • Software de cliente Oracle 8.1.7 e posteriorOracle client software 8.1.7 and later
  • Instalação de um gateway de dados no localInstallation of an on-premises data gateway
  • Instalação do SDK do cliente OracleInstallation of the Oracle client SDK

Instalar um gateway de dados no localInstall an on-premises data gateway

Para instalar um gateway, siga os passos neste tutorial.To install a gateway, follow the steps in this tutorial.

Um gateway de dados no local atua como uma ponte, ao fornecer a transferência rápida e segura de dados entre dados no local (dados que não estão na cloud) e serviços do Power BI, Microsoft Flow, Logic Apps e 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. Pode utilizar o mesmo gateway com vários serviços e várias origens de dados.You can use the same gateway with multiple services and multiple data sources. Para obter mais informações, veja Compreender os gateways.For more information, see Understand gateways.

Instalar o cliente OracleInstall Oracle client

No mesmo computador do gateway de dados no local, instale o ODAC de 64 bits 12c Versão 4 (12.1.0.2.4) para 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. Caso contrário, aparecerá um erro se tentar criar ou utilizar a ligação, conforme descreve a lista dos problemas conhecidos.Otherwise, an error will appear if you try to create or use the connection, as the list of known issues describes.

Criar uma aplicação a partir de uma tabela numa base de dados OracleCreate an app from a table in an Oracle database

  1. No PowerApps Studio, clique ou toque em Novo, no menu Ficheiro (perto do lado esquerdo).In PowerApps Studio, click or tap New on the File menu (near the left edge).

    Nova opção

  2. Em Comece com os seus dados, clique ou toque na seta.Under Start with your data, click or tap the arrow.

    É apresentada uma lista das ligações que já tem.A list of connections that you already have appears.

  3. Clique ou toque em Nova ligação.Click or tap New connection.

    Nova ligação

  4. Na lista de ligações, clique ou toque em Base de Dados Oracle.In the list of connections, click or tap Oracle Database.

    Nova base de dados

  5. Especifique o nome de um servidor Oracle, um nome de utilizador e uma palavra-passe.Specify the name of an Oracle server, a username, and a password.

    Especifique um servidor neste formato, se for necessário um SID:Specify a server in this format if an SID is required:
    ServerName/SIDServerName/SID

    Parâmetros da ligação

  6. Clique ou toque no gateway que pretende utilizar ou instale um.Click or tap the gateway that you want to use, or install one.

    Se o gateway não aparecer depois de o instalar, clique em Atualizar lista de gateways.If your gateway doesn't appear after you install it, click Refresh gateway list.

    Novo gateway

  7. Clique ou toque em Criar para criar a ligação.Click or tap Create to create the connection.

    Novo

  8. Clique ou toque no conjunto de dados predefinido.Click or tap the default dataset.

    Novo

  9. Na lista de tabelas, clique ou toque na tabela que pretende utilizar.In the list of tables, click or tap the table that you want to use.

    Novo

  10. Clique em Ligar para criar a aplicação.Click Connect to create the app.

    Novo

O PowerApps cria uma aplicação com três ecrãs e mostra os dados da tabela que selecionou:PowerApps creates an app that has three screens and shows data from the table that you selected:

  • BrowseScreen1, que apresenta uma lista de todas as entradas na tabela.BrowseScreen1, which lists all entries in the table.
  • DetailScreen1, que fornece mais informações sobre uma entrada individual.DetailScreen1, which provides more info about a single entry.
  • EditScreen1, onde os utilizadores podem atualizar uma entrada ou criar uma entrada.EditScreen1, in which users can update an entry or create an entry.

Novo

Passos seguintesNext steps

  • Para guardar a aplicação que acabou de gerar, prima Ctrl-S.To save the app that you've just generated, press Ctrl-S.
  • Para personalizar o BrowseScreen1 (que aparece por predefinição), veja Personalizar um esquema.To customize BrowseScreen1 (which appears by default), see Customize a layout.
  • Para personalizar o DetailsScreen1 ou EditScreen1, veja Personalizar um formulário.To customize DetailsScreen1 or EditScreen1, see Customize a form.

Problemas conhecidos, sugestões e resolução de problemasKnown issues, tips, and troubleshooting

  1. Não é possível aceder ao Gateway.Cannot reach the Gateway.

    Este erro ocorre se o gateway de dados no local não conseguir ligar à cloud.This error appears if the on-premises data gateway can't connect to the cloud. Para verificar o estado do gateway, inicie sessão em powerapps.microsoft.com, clique ou toque em Gatewayse, em seguida, clique ou toque no gateway que pretende utilizar.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.

    Certifique-se de que o gateway está em execução e pode ligar à Internet.Make sure that your gateway is running and can connect to the Internet. Evite instalar o gateway num computador que possa estar desligado ou em modo de suspensão.Avoid installing the gateway on a computer that may be turned off or asleep. Tente também reiniciar o serviço de gateway de dados no local (PBIEgwService).Also try restarting the on-premises data gateway service (PBIEgwService).

  2. O System.Data.OracleClient requer a versão de software do cliente Oracle 8.1.7 ou superior.System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.

    Este erro ocorre se o SDK do cliente Oracle não estiver instalado no mesmo computador do gateway de dados no local.This error appears if the Oracle client SDK isn't installed on the same computer as the on-premises data gateway. Para resolver este problema, instale o fornecedor oficial.To resolve this issue, install the official provider.

  3. A tabela “[Tablename]” não define quaisquer colunas chave.Table '[Tablename]' does not define any key columns.

    Este erro ocorre se estiver a ligar a uma tabela que não tem uma chave primária, que a ligação à base de dados Oracle requer.This error appears if you're connecting to a table that doesn't have a primary key, which the Oracle Database connection requires.

  4. Até ao presente momento, os procedimentos armazenados, as tabelas com chaves compostas e os tipos de objetos aninhados em tabelas não são suportados.As of this writing, stored procedures, tables with composite keys, and nested object types in tables aren't supported.