Oracle Database SQL Node Documentation (#1) #3627

sudarshan12s · 2025-09-05T09:59:31Z

This pull request adds documentation for the Oracle Database in n8n Node.
It includes documentation for

credentials
Operation modes; execute, insert, select, update, upsert and deleteTable/Rows

Documentation additions:

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md
Added comprehensive documentation for the Oracle Database node operations.

Credentials update:

docs/integrations/builtin/credentials/oracledb.md
Added details on the credential parameters .

Related node PR

netlify · 2025-09-05T09:59:36Z

✅ Deploy Preview for n8n-docs ready!

Name	Link
🔨 Latest commit	`4a3cc77`
🔍 Latest deploy log	https://app.netlify.com/projects/n8n-docs/deploys/68fb190b55c262000804dfb2
😎 Deploy Preview	https://deploy-preview-3627--n8n-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

CLAassistant · 2025-09-05T09:59:38Z

All committers have signed the CLA.

* - Initial document changes . --------- Co-authored-by: sudarshan soma <[email protected]> Co-authored-by: sudarshan soma <[email protected]>

github-actions · 2025-09-11T08:59:10Z

Thanks @sudarshan12s! We'll hold off on reviewing this until the PR is ready to go in the main repo.

cursor · 2025-10-17T06:38:03Z

You have run out of free Bugbot PR reviews for this billing cycle. This will reset on November 5.

To receive reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

sudarshan12s · 2025-10-17T09:12:18Z

The code PR is merged now, Can you please take a look and share your feedback.

Thanks.

sudarshan12s · 2025-10-22T10:21:32Z

@imchairmanm , Now the code PR is merged, Can you review and let me know your feedback.

Thanks.

sharadraju · 2025-10-22T15:00:41Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+
+# Oracle Database node
+
+Use the Oracle Database node to automate work in Oracle Database, and integrate Oracle Database with other applications. n8n has built-in support for a wide range of Oracle Database features, including executing an SQL query, as well as inserting, and updating rows in a database.


Perhaps add the Oracle Database and Oracle Client versions supported here.

sharadraju · 2025-10-22T15:05:50Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+
+# Oracle Database node
+
+Use the Oracle Database node to automate work in Oracle Database, and integrate Oracle Database with other applications. n8n has built-in support for a wide range of Oracle Database features, including executing an SQL query, as well as inserting, and updating rows in a database.


...which includes executing an SQL query, fetching, inserting, updating or deleting data from Oracle Database.

sharadraju · 2025-10-22T15:07:15Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+
+#### Delete options
+
+- **Auto Commit**: Whether this property is true, then the transaction in the current connection is automatically committed at the end of statement execution.


When this property is set to true, the transaction in the current connection is automatically committed at the end of statement execution.

sharadraju · 2025-10-22T15:07:40Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+
+#### Execute Statement options
+
+- **Auto Commit**: Whether this property is true, then the transaction in the current connection is automatically committed at the end of statement execution.


When this property is set to true, the transaction in the current connection is automatically committed at the end of statement execution.

sharadraju · 2025-10-22T15:08:52Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+
+- **Auto Commit**: Whether this property is true, then the transaction in the current connection is automatically committed at the end of statement execution.
+- **Bind Variable Placeholder Values**: Enter the values for the bind parameters used in the statement [Use bind parameters](#use-bind-parameters).
+- **Output Numbers As String**: Whether the numbers should be retrieved as string.


Indicates if the numbers should be retrieved as a String.

sharadraju · 2025-10-22T15:18:23Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+
+#### Insert options
+
+- **Auto Commit**: Whether this property is true, then the transaction in the current connection is automatically committed at the end of statement execution.


When this property is set to true, the transaction in the current connection is automatically committed at the end of statement execution.

Please make the change in all the places where the Auto Commit option is described.

sharadraju · 2025-10-22T15:19:18Z

nav.yml

          - Common issues: integrations/builtin/app-nodes/n8n-nodes-langchain.openai/common-issues.md
        - OpenThesaurus: integrations/builtin/app-nodes/n8n-nodes-base.openthesaurus.md
        - OpenWeatherMap: integrations/builtin/app-nodes/n8n-nodes-base.openweathermap.md
+        - OracleDB:


Pehaps say Oracle Database instead of OracleDB

sharadraju · 2025-10-22T15:20:03Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+
+## Use bind parameters
+
+When creating a query to run on a Oracle database, you can use the **Bind Variable Placeholder Values** field in the **Options** section to load data into the query. n8n sanitizes data in query parameters, which prevents SQL injection.


...When creating a query to run on an Oracle Database instance or service, ...

sharadraju · 2025-10-22T15:20:43Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+
+When creating a query to run on a Oracle database, you can use the **Bind Variable Placeholder Values** field in the **Options** section to load data into the query. n8n sanitizes data in query parameters, which prevents SQL injection.
+
+For example, you want to find a specific fruits by their color. Given the following input data:


...For example, you would want to find specific fruits by their color....

sharadraju · 2025-10-22T15:22:42Z

docs/integrations/builtin/credentials/oracledb.md

+
+- A **User** name.
+- A **Password** for that user.
+- **Connection String**: The Oracle database instance to connect to. The string can be an Easy Connect string, or a Net Service Name from a tnsnames.ora file, or the name of a local Oracle database instance.


...The Oracle Database instance...

Change "Net Service Name" to "TNS Alias".

See https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#tns-aliases-for-connection-strings

cjbj · 2025-10-22T23:51:33Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+
+- **Auto Commit**: Whether this property is true, then the transaction in the current connection is automatically committed at the end of statement execution.
+- **Statement Batching**: The way to send queries to the database:
+	- **Single Statement**: A single Statement for all incoming items.


I'd vote to change the sentence use of "Statement" to all lowercase in these three bullets. The initcap is fine in the bold text - and I guess it is the UI element name, anyway.

cjbj · 2025-10-22T23:58:47Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+#### Delete options
+
+- **Auto Commit**: Whether this property is true, then the transaction in the current connection is automatically committed at the end of statement execution.
+- **Statement Batching**: The way to send queries to the database:


In Oracle-land, 'query' is specific to statements that fetch rows so I think this needs to change 'queries' to 'statements'.

Other places in the doc may also need a similar change.

cjbj · 2025-10-23T00:02:36Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+- **Credential to connect with**: Create or select an existing [Oracle Database credential](/integrations/builtin/credentials/oracledb.md).
+- **Operation**: Select **Insert or Update**.
+- **Schema**: Choose the schema that contains the table you want to work on. Select **From list** to choose the schema from the dropdown list or **By Name** to enter the schema name.
+- **Table**: Choose the table that you want to work on. Select **From list** to choose the table from the dropdown list or **By Name** to enter the table name.


Minor smoothing on "from the dropdown list or By Name" would improve the flow. I'd say "from the dropdown list, or select By Name"

cjbj · 2025-10-23T01:52:44Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+- **Return All**: Whether to return all results or only up to a given limit.
+- **Limit**: The maximum number of items to return when **Return All** is disabled.
+- **Select Rows**: Set the conditions to select rows. Define a **Column**, **Operator**, and **Value**(as `json`) to match rows on. If you don't select anything, Oracle Database selects all rows.
+- **Combine Conditions**: How to combine the conditions in **Select Rows**. **AND** requires all conditions to be true, while **OR** requires at least one condition to be true.


This would flow better if some non bold text separated the two bold clauses. Maybe "The AND choice..."? Or something better than "choice"

modified as below:
How to combine the conditions in **Select Rows**. The **AND** requires all conditions to be true, while **OR** requires at least one condition to be true.

cjbj · 2025-10-23T01:57:35Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

+
+## Related resources
+
+Refer to [SQL Language Reference](https://docs.oracle.com/en/database/oracle/oracle-database/23/sqlrf/index.html) for more information about the service.


Use the redirecting link https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=SQLRF

cjbj · 2025-10-23T02:02:00Z

docs/integrations/builtin/credentials/oracledb.md

+
+## Prerequisites
+
+Create a user account on a [OracleDB](https://docs.oracle.com/en/database/oracle/oracle-database/23/sqlrf/CREATE-USER.html) server database.


Use the redirecting link https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=GUID-F0246961-558F-480B-AC0F-14B50134621C

cjbj · 2025-10-23T02:04:22Z

docs/integrations/builtin/credentials/oracledb.md

+
+- A **User** name.
+- A **Password** for that user.
+- **Connection String**: The Oracle database instance to connect to. The string can be an Easy Connect string, or a Net Service Name from a tnsnames.ora file, or the name of a local Oracle database instance.


Change "Net Service Name" to "TNS Alias".

See https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#tns-aliases-for-connection-strings

cjbj · 2025-10-23T02:05:41Z

docs/integrations/builtin/credentials/oracledb.md

+- A **User** name.
+- A **Password** for that user.
+- **Connection String**: The Oracle database instance to connect to. The string can be an Easy Connect string, or a Net Service Name from a tnsnames.ora file, or the name of a local Oracle database instance.
+- **Use Optional Oracle Client Libraries**: If you want to use node-oracledb Thick mode, turn this on. This option will not be available in official n8n docker images. Additional settings to enable thick mode are required. Refer to [Enabling Thick mode documentation](https://node-oracledb.readthedocs.io/en/latest/user_guide/initialization.html#enabling-node-oracledb-thick-mode) for more information.


Change "will not be" to "is not".

And change the lowercase "thick" to "Thick".

cjbj · 2025-10-23T02:08:46Z

docs/integrations/builtin/credentials/oracledb.md

+
+To set up your database connection credential:
+
+1. Enter your database's username as the **User** in your n8n credential. Run this query to confirm the username:


Are the SQL statements in these steps useful? What are the cases where users can run them but didn't already need the values to connect?

I have removed the sql's and just mentioned to enter DB username.

cjbj · 2025-10-23T02:09:11Z

docs/integrations/builtin/credentials/oracledb.md

+
+       can be used to dump file contents in the **Wallet Content** field.
+
+Refer to [Node OracleDB ](https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#mutual-tls-connections-to-oracle-cloud-autonomous-database) for more information on working with TLS connections.


Change "Node OracleDB" to "node-oracledb"

sudarshan12s · 2025-10-23T13:56:35Z

Thanks for the review comments. I have addressed them, Please see.

cjbj · 2025-10-24T04:29:07Z

docs/integrations/builtin/app-nodes/n8n-nodes-base.oracledb/index.md

 Refer to [SQL Language Reference](https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=SQLRF) for more information about the service.

-Refer to [Node OracleDB ](https://node-oracledb.readthedocs.io/en/latest/) for more information about the oracledb client driver.
+Refer to [node-oracledb](https://node-oracledb.readthedocs.io/en/latest/) for more information about the oracledb client driver.


"the node-oracledb driver"

And Refer to [node-oracledb documentation]

imchairmanm · 2025-10-24T13:58:57Z

@imchairmanm , Now the code PR is merged, Can you review and let me know your feedback.

Thanks.

@sudarshan12s Thanks for the ping. I'm no longer at n8n, so I'd suggest asking @HumanistSerif for a review!

sharadraju

Approved

sharadraju · 2025-10-25T00:13:32Z

@HumanistSerif Since the corresponding PR is merged, request you to review and let us know your feedback.

cjbj · 2025-10-25T01:54:35Z

Approved

Ditto.

sudarshan12s mentioned this pull request Sep 5, 2025

feat(oracleDb Node): Add Oracle Database SQL Node (#2) n8n-io/n8n#19231

Closed

3 tasks

sudarshan12s and others added 4 commits September 8, 2025 19:20

Oracle Database SQL Node Documentation (#1)

0111672

* - Initial document changes . --------- Co-authored-by: sudarshan soma <[email protected]> Co-authored-by: sudarshan soma <[email protected]>

- Add more examples

bfc24d8

- Fix Errors

ca28304

- Add bash prefix for extracting the pem content

25c3915

sudarshan12s force-pushed the main branch from 1d555a1 to 25c3915 Compare September 8, 2025 13:52

sudarshan12s marked this pull request as ready for review September 8, 2025 13:56

Merge branch 'main' of github.com:n8n-io/n8n-docs

fb5af19

imchairmanm added the pending-dev Blocked pending merge of related dev PR label Sep 11, 2025

StarfallProjects added the community-contribution Potential community contribution label Sep 13, 2025

sudarshan12s mentioned this pull request Oct 16, 2025

feat(oracleDb Node): Add Oracle Database SQL Node n8n-io/n8n#20867

Merged

3 tasks

Merge branch 'main' of github.com:n8n-io/n8n-docs

0c76bac

- Update docs on recent code changes done based on feedback

8c74f54

sudarshan12s added 5 commits October 17, 2025 15:48

- update on using n8n expressions for output Columns

f240be7

Merge branch 'main' of github.com:n8n-io/n8n-docs

48f143b

- Remove link for templates until templates are added

6c1aca2

Merge branch 'main' of github.com:n8n-io/n8n-docs

a723de1

Merge branch 'main' of github.com:n8n-io/n8n-docs

09aea54

sharadraju reviewed Oct 22, 2025

View reviewed changes

cjbj reviewed Oct 23, 2025

View reviewed changes

sudarshan12s added 3 commits October 23, 2025 17:53

- Incorporate review comments

a12acb6

Merge branch 'main' of github.com:n8n-io/n8n-docs

c0dd886

- correct the DRCP link

66c345e

sudarshan12s requested review from cjbj and sharadraju October 23, 2025 13:56

cjbj reviewed Oct 24, 2025

View reviewed changes

sudarshan12s added 2 commits October 24, 2025 11:29

- incorporate review comments

27430e7

- minor wording

4a3cc77

sharadraju reviewed Oct 24, 2025

View reviewed changes

HumanistSerif approved these changes Oct 25, 2025

View reviewed changes


		# Oracle Database node

		Use the Oracle Database node to automate work in Oracle Database, and integrate Oracle Database with other applications. n8n has built-in support for a wide range of Oracle Database features, including executing an SQL query, as well as inserting, and updating rows in a database.


		#### Delete options

		- Auto Commit: Whether this property is true, then the transaction in the current connection is automatically committed at the end of statement execution.


		#### Execute Statement options

		- Auto Commit: Whether this property is true, then the transaction in the current connection is automatically committed at the end of statement execution.


		#### Insert options

		- Auto Commit: Whether this property is true, then the transaction in the current connection is automatically committed at the end of statement execution.


		## Use bind parameters

		When creating a query to run on a Oracle database, you can use the Bind Variable Placeholder Values field in the Options section to load data into the query. n8n sanitizes data in query parameters, which prevents SQL injection.


		When creating a query to run on a Oracle database, you can use the Bind Variable Placeholder Values field in the Options section to load data into the query. n8n sanitizes data in query parameters, which prevents SQL injection.

		For example, you want to find a specific fruits by their color. Given the following input data:


		## Related resources

		Refer to [SQL Language Reference](https://docs.oracle.com/en/database/oracle/oracle-database/23/sqlrf/index.html) for more information about the service.


		## Prerequisites

		Create a user account on a [OracleDB](https://docs.oracle.com/en/database/oracle/oracle-database/23/sqlrf/CREATE-USER.html) server database.


		To set up your database connection credential:

		1. Enter your database's username as the User in your n8n credential. Run this query to confirm the username:


		can be used to dump file contents in the Wallet Content field.

		Refer to [Node OracleDB ](https://node-oracledb.readthedocs.io/en/latest/user_guide/connection_handling.html#mutual-tls-connections-to-oracle-cloud-autonomous-database) for more information on working with TLS connections.

Oracle Database SQL Node Documentation (#1) #3627

Are you sure you want to change the base?

Oracle Database SQL Node Documentation (#1) #3627

Conversation

sudarshan12s commented Sep 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Documentation additions:

Credentials update:

Uh oh!

netlify bot commented Sep 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for n8n-docs ready!

Uh oh!

CLAassistant commented Sep 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Sep 11, 2025

Uh oh!

cursor bot commented Oct 17, 2025

Uh oh!

sudarshan12s commented Oct 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sudarshan12s commented Oct 22, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sudarshan12s commented Oct 23, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

sudarshan12s commented Sep 5, 2025 •

edited

Loading

netlify bot commented Sep 5, 2025 •

edited

Loading

CLAassistant commented Sep 5, 2025 •

edited

Loading

sudarshan12s commented Oct 17, 2025 •

edited

Loading