Merge pull request #278064 from ecfan/retire

Oracle Datbase connector - Refactored and reduced content with minimal updates

Author: Jill Grant

articles/connectors/connectors-create-api-oracledatabase.md

@@ -1,127 +1,107 @@
 ---
 title: Connect to Oracle Database
-description: Insert and manage records in Oracle Database using Azure Logic Apps.
+description: Insert and manage records in Oracle Database using a workflow in Azure Logic Apps.
 services: logic-apps
 ms.suite: integration
 ms.reviewer: estfan, azla
 ms.topic: how-to
-ms.date: 01/04/2024
+ms.date: 06/12/2024
 ---
 
 # Connect to Oracle Database from Azure Logic Apps
 
-[!INCLUDE [logic-apps-sku-consumption](~/reusable-content/ce-skilling/azure/includes/logic-apps-sku-consumption.md)]
+[!INCLUDE [logic-apps-sku-consumption-standard](~/reusable-content/ce-skilling/azure/includes/logic-apps-sku-consumption-standard.md)]
 
-Using the Oracle Database connector, you create organizational workflows that use data in your existing database. This connector can connect to an on-premises Oracle Database, or an Azure virtual machine with Oracle Database installed. With this connector, you can:
+In Azure Logic Apps, you can insert or manage data in your Oracle Database from within your workflow. You can use the Oracle Database connector to access an on-premises Oracle Database or an Azure virtual machine with Oracle Database installed.
 
-* Build your workflow by adding a new customer to a customers database, or updating an order in an orders database.
-* Use actions to get a row of data, insert a new row, and even delete. For example, when a record is created in Dynamics CRM Online (a trigger), then insert a row in an Oracle Database (an action).
+For example, you can perform the following tasks with the connector:
 
-This connector doesn't support the following items:
+* Add a new customer to a customer database.
+* Update an order in an order database.
+* Get a row of data, insert a new row, or delete an existing row.
 
-* Any table with composite keys
-* Nested object types in tables
-* Database functions with non-scalar values
+## Supported versions
 
-This article shows you how to use the Oracle Database connector in a logic app.
+* Oracle 9 and later
+* Oracle Data Access Client (ODAC) 11.2 and later
 
 ## Prerequisites
 
-* Supported Oracle versions:
-    * Oracle 9 and later
-    * Oracle Data Access Client (ODAC) 11.2 and later
-
-* Install the on-premises data gateway. [Connect to on-premises data from logic apps](../logic-apps/logic-apps-gateway-connection.md) lists the steps. The gateway is required to connect to an on-premises Oracle Database, or an Azure VM with Oracle DB installed.
+* [Download and install the on-premises data gateway](/data-integration/gateway/service-gateway-install).
 
-    > [!NOTE]
-    > The on-premises data gateway acts as a bridge, and provides a secure data transfer between on-premises data (data that is not in the cloud) and your logic apps. The same gateway can be used with multiple services, and multiple data sources. So, you may only need to install the gateway once.
+  This gateway acts as a bridge and provides a secure data transfer between on-premises data and your app or client. You can use the same gateway installation with multiple services and data sources, which means you might only need to install the gateway once.
 
-* Install the Oracle Client on the machine where you installed the on-premises data gateway. Make sure that you install the 64-bit Oracle Data Provider for .NET from Oracle, and select the Windows installer version because the `xcopy` version doesn't work with the on-premises data gateway:
+* Install your Oracle client on the computer where you installed the on-premises data gateway. Otherwise, an error occurs when you try to create or use the connection.
 
-  [64-bit ODAC 12c Release 4 (12.1.0.2.4) for Windows x64](https://www.oracle.com/technetwork/database/windows/downloads/index-090165.html)
+* [Create an Azure gateway resource for your gateway installation](../logic-apps/logic-apps-gateway-connection.md).
 
-    > [!TIP]
-    > If the Oracle client is not installed, an error occurs when you try to create or use the connection. See the common errors in this article.
+* The logic app workflow where you want to connect to your Oracle database. This connector provides only actions, not triggers. You can use any trigger that you want to start your workflow. To create the logic app and add a trigger, see the following documentation:
 
-## Add the connector
+  * [Create an example Consumption workflow in multitenant Azure Logic Apps](../logic-apps/quickstart-create-example-consumption-workflow.md).
+  * [Create an example Standard workflow in single tenant Azure Logic apps](../logic-apps/create-single-tenant-workflows-azure-portal.md)
+  * [Add a trigger to your workflow](../logic-apps/create-workflow-with-trigger-or-action.md#add-trigger)
 
-> [!IMPORTANT]
-> This connector does not have any triggers. It has only actions. So when you create your logic app, add another trigger to start your logic app, such as **Schedule - Recurrence**, or **Request / Response - Response**.
+* For the **Get row** action used in this example, you need to know the identifier for the table to access.
 
-1. In the [Azure portal](https://portal.azure.com), create a blank logic app.
+  If you don't know this information, contact your Oracle Database administrator, or get the output from the following statement: **`select * from <table-name>`**.
 
-2. At the start of your logic app, select the **Request / Response - Request** trigger:
+## Known issues and limitations
 
-    ![A dialog box has a box to search all triggers. There is also a single trigger shown, "Request / Response-Request", with a selection button.](./media/connectors-create-api-oracledatabase/request-trigger.png)
-
-3. Select **Save**. When you save, a request URL is automatically generated.
-
-4. Select **New step**, and select **Add an action**. Type in `oracle` to see the available actions:
-
-    ![A search box contains "oracle". The search produces one hit labeled "Oracle Database". There is a tabbed page, one tab showing "TRIGGERS (0)", another showing "ACTIONS (6)". Six actions are listed. The first of these is "Get row Preview".](./media/connectors-create-api-oracledatabase/oracledb-actions.png)
+This connector doesn't support the following items:
 
-    > [!TIP]
-    > This is also the quickest way to see the triggers and actions available for any connector. Type in part of the connector name, such as `oracle`. The designer lists any triggers and any actions.
+* Any table with composite keys
+* Nested object types in tables
+* Database functions with nonscalar values
 
-5. Select one of the actions, such as **Oracle Database - Get row**. Select **Connect via on-premises data gateway**. Enter the Oracle server name, authentication method, username, password, and select the gateway:
+For more information, see the [connector's reference documentation](/connectors/oracle/).
 
-    ![The dialog box is titled "Oracle Database - Get row". There is a box, checked, labeled "Connect via on-premises data gateway". Below that are the five other text boxes.](./media/connectors-create-api-oracledatabase/create-oracle-connection.png)
+## Connector technical reference
 
-6. Once connected, select a table from the list, and enter the row ID to your table. You need to know the identifier to the table. If you don't know, contact your Oracle DB administrator, and get the output from `select * from yourTableName`. This gives you the identifiable information you need to proceed.
+For available connector operations, see the [connector's reference documentation](/connectors/oracle/).
 
-    In the following example, job data is being returned from a Human Resources database:
+## Add an action
 
-    ![The dialog box titled "Get row (Preview)" has two text boxes: "Table name", which contains "H R JOBS" and has a drop-down list, and "Row i d", which contains "S A _ REP".](./media/connectors-create-api-oracledatabase/table-rowid.png)
+1. [Follow these generic steps to add the **Oracle Database** action that you want](../logic-apps/create-workflow-with-trigger-or-action.md).
 
-7. In this next step, you can use any of the other connectors to build your workflow. If you want to test getting data from Oracle, then send yourself an email with the Oracle data using one of the send email connectors, such as Office 365 Outlook. Use the dynamic tokens from the Oracle table to build the `Subject` and `Body` of your email:
+   This example continues with the [**Get row** action](/connectors/oracle/#get-row).
 
-    ![There are two dialog boxes. The "Send an email box" has boxes to specify the "Body", "Subject", and "To" address of the email. The "Add dynamic content" dialog box provides a search of dynamic content from the apps and services of the flow.](./media/connectors-create-api-oracledatabase/oracle-send-email.png)
+1. In the connection box, provide the required [connection information](/connectors/oracle/#default).
 
-8. **Save** your logic app, and then select **Run**. Close the designer, and look at the runs history for the status. If it fails, select the failed message row. The designer opens, and shows you which step failed, and also shows the error information. If it succeeds, then you should receive an email with the information you added.
+1. For the **Gateway** property, select the Azure subscription and Azure gateway resource to use.
 
+1. After the connection is complete, from the **Table name** list, select a table.
 
-### Workflow ideas
+1. For the **Row Id** property, enter the row ID that you want in your table.
 
-* You want to monitor the #oracle hashtag, and put the tweets in a database so they can be queried, and used within other applications. In a logic app, add the `Twitter - When a new tweet is posted` trigger, and enter the **#oracle** hashtag. Then, add the `Oracle Database - Insert row` action, and select your table:
+   In the following example, job data is returned from a Human Resources database:
 
-    ![The "When a new tweet is posted" dialog box shows "hashtag oracle" as search text and lets you specify checking frequency. This dialog box leads to the "Oracle Database" dialog box that lets you select the action.](./media/connectors-create-api-oracledatabase/twitter-oracledb.png)
+   :::image type="content" source="media/connectors-create-api-oracledatabase/table-rowid.png" alt-text="Screenshot shows Get row action with table name and row ID." lightbox="media/connectors-create-api-oracledatabase/table-rowid.png":::
 
-* Messages are sent to a Service Bus queue. You want to get these messages, and put them in a database. In a logic app, add the `Service Bus - when a message is received in a queue` trigger, and select the queue. Then, add the `Oracle Database - Insert row` action, and select your table:
+1. Add any other actions to continue building your workflow.
 
-    ![The "When a message is received..." dialog box shows "orders" as the "Queue name" and lets you specify checking frequency. This box leads to the "Insert row (Preview)" dialog box that lets you select "Table name".](./media/connectors-create-api-oracledatabase/sbqueue-oracledb.png)
+1. When you're done, save your workflow.
 
 ## Common errors
 
 #### **Error**: Cannot reach the Gateway
 
-**Cause**: The on-premises data gateway is not able to connect to the cloud. 
+**Cause**: The on-premises data gateway can't connect to the cloud.
 
-**Mitigation**: Make sure your gateway is running on the on-premises machine where you installed it, and that it can connect to the internet.  We recommend not installing the gateway on a computer that may be turned off or sleep. You can also restart the on-premises data gateway service (PBIEgwService).
+**Mitigation**: Make sure your gateway is running on the on-premises computer where you installed the gateway and has internet connectivity. Avoid installing the gateway on a computer that might be turned off or go to sleep. You can also try restarting the on-premises data gateway service (PBIEgwService).
 
-#### **Error**: The provider being used is deprecated: 'System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.'. See [https://go.microsoft.com/fwlink/p/?LinkID=272376](/power-bi/connect-data/desktop-connect-oracle-database) to install the official provider.
+#### **Error**: The provider being used is deprecated: 'System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.' To install the official provider, see [https://go.microsoft.com/fwlink/p/?LinkID=272376](/power-bi/connect-data/desktop-connect-oracle-database).
 
-**Cause**: The Oracle client SDK is not installed on the machine where the on-premises data gateway is running. 
+**Cause**: The Oracle client SDK isn't installed on the computer where the on-premises data gateway is running.
 
 **Resolution**: Download and install the Oracle client SDK on the same computer as the on-premises data gateway.
 
 #### **Error**: Table '[Tablename]' does not define any key columns
 
-**Cause**: The table does not have any primary key. 
-
-**Resolution**: The Oracle Database connector requires that a table with a primary key column be used.
-
-## Connector-specific details
-
-View any triggers and actions defined in the swagger, and also see any limits in the [connector details](/connectors/oracle/).
-
-## Get some help
-
-The [Microsoft Q&A question page for Azure Logic Apps](/answers/topics/azure-logic-apps.html) is a great place to ask questions, answer questions, and see what other Logic Apps users are doing.
+**Cause**: The table doesn't have a primary key.
 
-You can help improve Logic Apps and connectors by voting and submitting your ideas at [https://aka.ms/logicapps-wish](https://aka.ms/logicapps-wish).
+**Resolution**: The Oracle Database connector requires that you use a table with a primary key column.
 
-## Next steps
+## Related content
 
 * [Managed connectors for Azure Logic Apps](managed.md)
 * [Built-in connectors for Azure Logic Apps](built-in.md)
-* [What are connectors in Azure Logic Apps](introduction.md)