# Oracle Database

> Query and change data in Oracle Database, including Autonomous Database and Amazon RDS for Oracle: run SQL and PL/SQL with safe parameters; find, count, select, insert, upsert, update and delete rows without writing SQL; create and drop tables; call procedures and packages; look up schemas, tables, columns and indexes; and start a workflow when a row is added or changed.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/oracle-database

## Actions

### Call procedure

Call a stored procedure or function, on its own or in a package, and get back what it returns: a function's result and the procedure's OUT parameters as one row, and each REF CURSOR or returned result set as rows.

**Inputs**

- Procedure (`procedure`, text, required): The procedure's or function's name, e.g. ADD_CUSTOMER, or PACKAGE.NAME for one in a package. Use 'List procedures' to find one.
- Schema (`schema`, text): The procedure's schema (the user that owns it). Leave empty for your own.
- Arguments (`arguments`, list): The values for its IN parameters, in order, e.g. [42, "active"]; or by name, e.g. {"P_CUSTOMER_ID": 42}. OUT parameters are filled in by the call; leave them out.
- Maximum rows (`max_rows`, number): Return at most this many rows from each result set. From 1 to 10000. Default: `1000`.

**Outputs**

- `procedure` (text): The procedure or function called
- `result_set_count` (number): How many sets of rows it returned
- `result_sets` (list): Every set of rows it returned, in order
- `rows` (list): The first result set's rows

**Example output**

```json
{
  "procedure": "SALES.ADD_ONE",
  "result_set_count": 1,
  "result_sets": [
    {
      "columns": [
        "result"
      ],
      "row_count": 1,
      "rows": [
        {
          "result": 42
        }
      ],
      "truncated": false
    }
  ],
  "rows": [
    {
      "result": 42
    }
  ]
}
```

### Count rows

How many rows in a table match the given values, or all of its rows when none are given.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.
- Match rows where (`filters`, object): Column and value pairs every row must match, e.g. {"STATUS": "active"}. A list matches any of its values; null matches a missing value. Oracle stores empty text as null, so match it with null. To compare, give an operator: {"AMOUNT": {">=": 10}}, {"NAME": {"contains": "ada"}} or {"CREATED_AT": {"between": ["2026-01-01", "2026-02-01"]}}. Operators: =, !=, >, >=, <, <=, contains, not_contains, starts_with, ends_with, like, not_like, in, not_in, between, is_null. contains, starts_with and ends_with take the text as written and ignore case; like and not_like take a pattern, with % for any text and _ for one character.

**Outputs**

- `count` (number): Rows matching the filters
- `table` (text): The table, with its schema when one was given

**Example output**

```json
{
  "count": 42,
  "table": "CUSTOMERS"
}
```

### Create table

Create a table from a list of columns. By default an existing table of that name is left alone.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.
- Columns (`columns`, list, required): One entry per column, written as name then type, e.g. 'id number primary key auto_increment', 'email varchar2(255) not null unique', 'amount number(10,2) default 0', 'created_at timestamp default current_timestamp'. After the type: primary key, not null, unique, auto_increment, and default followed by a number, 'text', null or current_timestamp.
- Skip if it exists (`if_not_exists`, true/false): Leave an existing table alone instead of failing. Default: `true`.

**Outputs**

- `created` (true/false): False when the table already existed and was left alone
- `table` (text): The table, with its schema when one was given

**Example output**

```json
{
  "created": true,
  "table": "CUSTOMERS"
}
```

### Delete rows

Remove the rows matching the given values. At least one 'Match rows where' entry is required.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.
- Match rows where (`filters`, object, required): Column and value pairs every row must match, e.g. {"ID": 42}. Required, so the whole table can never be changed by accident. To compare, give an operator: {"AMOUNT": {">=": 10}}, {"NAME": {"contains": "ada"}} or {"CREATED_AT": {"between": ["2026-01-01", "2026-02-01"]}}. Operators: =, !=, >, >=, <, <=, contains, not_contains, starts_with, ends_with, like, not_like, in, not_in, between, is_null. contains, starts_with and ends_with take the text as written and ignore case; like and not_like take a pattern, with % for any text and _ for one character.

**Outputs**

- `rows_affected` (number): Rows the statement changed; null when the database doesn't say
- `table` (text): The table, with its schema when one was given

**Example output**

```json
{
  "rows_affected": 1,
  "table": "CUSTOMERS"
}
```

### Describe table

A table's or view's columns in order, with type, nullability and default, and its primary key.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.

**Outputs**

- `columns` (list): The table's columns, in order
- `count` (number): How many columns the table has
- `primary_key` (list): The primary key's columns, in order
- `table` (text): The table, with its schema when one was given

**Example output**

```json
{
  "columns": [
    {
      "character_maximum_length": null,
      "column_default": "GENERATED AS IDENTITY",
      "column_name": "ID",
      "column_type": "NUMBER",
      "data_type": "NUMBER",
      "is_nullable": false,
      "is_primary_key": true,
      "numeric_precision": null,
      "numeric_scale": null,
      "ordinal_position": 1
    }
  ],
  "count": 1,
  "primary_key": [
    "ID"
  ],
  "table": "CUSTOMERS"
}
```

### Drop table

Delete a table and every row in it. It goes to Oracle's recycle bin, if that is on, where FLASHBACK TABLE can bring it back.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.
- Ignore if missing (`if_exists`, true/false): Succeed without doing anything if it is not there. Default: `true`.

**Outputs**

- `dropped` (true/false): False when there was no such table
- `table` (text): The table, with its schema when one was given

**Example output**

```json
{
  "dropped": true,
  "table": "CUSTOMERS"
}
```

### Find row

The first row matching the given values, or found: false when there is none, so a later step can branch on it. Without a sort column, which matching row comes back is up to the database.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.
- Match rows where (`filters`, object): Column and value pairs every row must match, e.g. {"STATUS": "active"}. A list matches any of its values; null matches a missing value. Oracle stores empty text as null, so match it with null. To compare, give an operator: {"AMOUNT": {">=": 10}}, {"NAME": {"contains": "ada"}} or {"CREATED_AT": {"between": ["2026-01-01", "2026-02-01"]}}. Operators: =, !=, >, >=, <, <=, contains, not_contains, starts_with, ends_with, like, not_like, in, not_in, between, is_null. contains, starts_with and ends_with take the text as written and ignore case; like and not_like take a pattern, with % for any text and _ for one character.
- Sort by column (`order_by`, text): Column to sort on. Leave empty for no order.
- Sort direction (`sort_direction`, text): Which way to sort, when a sort column is given. One of: `ASC` (Ascending), `DESC` (Descending). Default: `ASC`.

**Outputs**

- `found` (true/false): True when a row matched
- `row` (object): The first matching row, or null
- `table` (text): The table, with its schema when one was given

**Example output**

```json
{
  "found": true,
  "row": {
    "EMAIL": "ada@example.com",
    "ID": 1,
    "NAME": "Ada Lovelace"
  },
  "table": "CUSTOMERS"
}
```

### Get server info

The database's version, its name and service, and the user signed in. The quickest way to check the connection works.

**Inputs**: None.

**Outputs**

- `current_schema` (text): Where unqualified table names are looked up
- `database` (text): The database's name (on a multitenant server, the pluggable database)
- `product` (text): Oracle Database
- `server_time` (text): The server's clock, ISO 8601
- `service_name` (text): The service connected to
- `user_name` (text): The user signed in
- `version` (text): The version number, such as 19.24.0.0.0
- `version_string` (text): The server's full version text

**Example output**

```json
{
  "current_schema": "SALES",
  "database": "ORCLPDB1",
  "product": "Oracle Database",
  "server_time": "2026-10-16T09:30:00.000000+00:00",
  "service_name": "orclpdb1",
  "user_name": "SALES",
  "version": "19.24.0.0.0",
  "version_string": "Oracle Database 19c Enterprise Edition"
}
```

### Insert row

Add one row to a table and get it back as stored, with its generated id and defaults.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.
- Values (`values`, object, required): Column and value pairs, e.g. {"NAME": "Ada", "EMAIL": "ada@example.com"}. Leave out generated and default columns. Dates as ISO 8601, such as 2026-10-15T09:30:00. An object or list is stored as JSON text.

**Outputs**

- `row` (object): The inserted row as stored, with generated ids and defaults
- `rows_affected` (number): Rows the statement changed; null when the database doesn't say
- `table` (text): The table, with its schema when one was given

**Example output**

```json
{
  "row": {
    "EMAIL": "ada@example.com",
    "ID": 43,
    "NAME": "Ada Lovelace"
  },
  "rows_affected": 1,
  "table": "CUSTOMERS"
}
```

### Insert rows

Add up to 1,000 rows in one go, all or nothing. A column missing from a row is stored as null.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.
- Rows (`rows`, list, required): A list of rows, each a column and value object, e.g. [{"NAME": "Ada"}, {"NAME": "Grace"}].

**Outputs**

- `rows_affected` (number): Rows the statement changed; null when the database doesn't say
- `table` (text): The table, with its schema when one was given

**Example output**

```json
{
  "rows_affected": 2,
  "table": "CUSTOMERS"
}
```

### List indexes

A table's indexes with their columns in key order, and which is the primary key's.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.

**Outputs**

- `count` (number): How many are listed
- `indexes` (list): The table's indexes
- `table` (text): The table, with its schema when one was given

**Example output**

```json
{
  "count": 1,
  "indexes": [
    {
      "columns": [
        "ID"
      ],
      "is_primary": true,
      "is_unique": true,
      "method": "btree",
      "name": "CUSTOMERS_PK"
    }
  ],
  "table": "CUSTOMERS"
}
```

### List procedures

The stored procedures and functions the user can see, packaged ones included (as PACKAGE.NAME), optionally with each one's parameters.

**Inputs**

- Schema (`schema`, text): Only this schema. Leave empty for every schema except Oracle's own.
- Include parameters (`include_parameters`, true/false): Also list each one's parameters and types. Default: `false`.

**Outputs**

- `count` (number): How many are listed
- `procedures` (list): The procedures and functions, by schema and name

**Example output**

```json
{
  "count": 1,
  "procedures": [
    {
      "parameters": [
        {
          "data_type": "VARCHAR2",
          "mode": "IN",
          "name": "P_NAME",
          "position": 1
        }
      ],
      "return_type": null,
      "routine_name": "ADD_CUSTOMER",
      "routine_schema": "SALES",
      "routine_type": "PROCEDURE"
    }
  ]
}
```

### List schemas

The schemas in the database. In Oracle a schema is a database user and the tables it owns.

**Inputs**

- Include Oracle's own schemas (`include_system`, true/false): Also list SYS, SYSTEM and the other schemas Oracle maintains. Default: `false`.

**Outputs**

- `count` (number): How many are listed
- `schemas` (list): The schemas; the system's own only when asked for

**Example output**

```json
{
  "count": 1,
  "schemas": [
    {
      "schema_name": "SALES"
    }
  ]
}
```

### List tables

The tables the user can see, in one schema or every schema except Oracle's own, optionally with views.

**Inputs**

- Schema (`schema`, text): Only this schema. Leave empty for every schema except Oracle's own.
- Include views (`include_views`, true/false): Also list views. Default: `false`.

**Outputs**

- `count` (number): How many are listed
- `tables` (list): The tables, by schema and name
- `truncated` (true/false): True when there were more than the limit and the rest were left out

**Example output**

```json
{
  "count": 1,
  "tables": [
    {
      "table_name": "CUSTOMERS",
      "table_schema": "SALES",
      "table_type": "BASE TABLE"
    }
  ],
  "truncated": false
}
```

### List views

The views the user can see, in one schema or every schema except Oracle's own.

**Inputs**

- Schema (`schema`, text): Only this schema. Leave empty for every schema except Oracle's own.

**Outputs**

- `count` (number): How many are listed
- `truncated` (true/false): True when there were more than the limit and the rest were left out
- `views` (list): The views, by schema and name

**Example output**

```json
{
  "count": 1,
  "truncated": false,
  "views": [
    {
      "table_name": "ACTIVE_CUSTOMERS",
      "table_schema": "SALES",
      "table_type": "VIEW"
    }
  ]
}
```

### Run query

Run a SQL query and return its rows. Use :name placeholders with 'Parameters' for any value that comes from data. The user's privileges decide what it can touch.

**Inputs**

- SQL query (`query`, text, required): One SQL statement, e.g. SELECT * FROM customers WHERE status = :status. A trailing ; is fine.
- Parameters (`parameters`, object): Values for each :name in the SQL, e.g. {"status": "active"} for WHERE status = :status. Dates as ISO 8601 text, such as 2026-10-15T09:30:00. A list or object is sent as JSON text. Passing values here, not pasting them into the SQL, keeps a quote in the data from changing the statement.
- Maximum rows (`max_rows`, number): Return at most this many rows. From 1 to 10000. Default: `1000`.

**Outputs**

- `columns` (list): Column names, in order
- `row_count` (number): Rows returned
- `rows` (list): The rows, each keyed by column
- `rows_affected` (number): Rows the statement changed; null when the database doesn't say
- `truncated` (true/false): True when more rows existed than the limit allowed

**Example output**

```json
{
  "columns": [
    "ID",
    "NAME",
    "EMAIL"
  ],
  "row_count": 1,
  "rows": [
    {
      "EMAIL": "ada@example.com",
      "ID": 1,
      "NAME": "Ada Lovelace"
    }
  ],
  "rows_affected": null,
  "truncated": false
}
```

### Run statement

Run an INSERT, UPDATE, DELETE or MERGE, a PL/SQL block, or DDL such as CREATE TABLE, and get the number of rows it changed. DDL commits at once in Oracle. Use :name placeholders with 'Parameters' for values.

**Inputs**

- SQL statement (`statement`, text, required): One statement, or several inside BEGIN ... END; to run them together.
- Parameters (`parameters`, object): Values for each :name in the SQL, e.g. {"status": "active"} for WHERE status = :status. Dates as ISO 8601 text, such as 2026-10-15T09:30:00. A list or object is sent as JSON text. Passing values here, not pasting them into the SQL, keeps a quote in the data from changing the statement.

**Outputs**

- `rows_affected` (number): Rows the statement changed; null when the database doesn't say

**Example output**

```json
{
  "rows_affected": 1
}
```

### Select rows

Read rows from a table without writing SQL: choose columns, match on values, sort and page. A limit always applies.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.
- Columns (`columns`, list): Columns to return. Leave empty for all.
- Match rows where (`filters`, object): Column and value pairs every row must match, e.g. {"STATUS": "active"}. A list matches any of its values; null matches a missing value. Oracle stores empty text as null, so match it with null. To compare, give an operator: {"AMOUNT": {">=": 10}}, {"NAME": {"contains": "ada"}} or {"CREATED_AT": {"between": ["2026-01-01", "2026-02-01"]}}. Operators: =, !=, >, >=, <, <=, contains, not_contains, starts_with, ends_with, like, not_like, in, not_in, between, is_null. contains, starts_with and ends_with take the text as written and ignore case; like and not_like take a pattern, with % for any text and _ for one character.
- Sort by column (`order_by`, text): Column to sort on. Leave empty for no order.
- Sort direction (`sort_direction`, text): Which way to sort, when a sort column is given. One of: `ASC` (Ascending), `DESC` (Descending). Default: `ASC`.
- Maximum rows (`limit`, number): Return at most this many rows. From 1 to 10000. Default: `100`.
- Skip rows (`offset`, number): Skip this many rows first, for paging. Set a sort column too, or the pages may overlap. From 0 to 100000000. Default: `0`.

**Outputs**

- `columns` (list): Column names, in order
- `row_count` (number): Rows returned
- `rows` (list): The rows, each keyed by column
- `table` (text): The table, with its schema when one was given
- `truncated` (true/false): True when more rows existed than the limit allowed

**Example output**

```json
{
  "columns": [
    "ID",
    "NAME",
    "EMAIL"
  ],
  "row_count": 1,
  "rows": [
    {
      "EMAIL": "ada@example.com",
      "ID": 1,
      "NAME": "Ada Lovelace"
    }
  ],
  "table": "CUSTOMERS",
  "truncated": false
}
```

### Update rows

Change columns on the rows matching the given values. At least one 'Match rows where' entry is required.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.
- New values (`values`, object, required): Column and value pairs to set, e.g. {"STATUS": "inactive"}.
- Match rows where (`filters`, object, required): Column and value pairs every row must match, e.g. {"ID": 42}. Required, so the whole table can never be changed by accident. To compare, give an operator: {"AMOUNT": {">=": 10}}, {"NAME": {"contains": "ada"}} or {"CREATED_AT": {"between": ["2026-01-01", "2026-02-01"]}}. Operators: =, !=, >, >=, <, <=, contains, not_contains, starts_with, ends_with, like, not_like, in, not_in, between, is_null. contains, starts_with and ends_with take the text as written and ignore case; like and not_like take a pattern, with % for any text and _ for one character.

**Outputs**

- `rows_affected` (number): Rows the statement changed; null when the database doesn't say
- `table` (text): The table, with its schema when one was given

**Example output**

```json
{
  "rows_affected": 1,
  "table": "CUSTOMERS"
}
```

### Upsert row

Update the row with the same key, or insert it if there is none, and get the row back as stored. The key defaults to the table's primary key, and must pick out one row.

**Inputs**

- Table (`table`, text, required): The table's name, e.g. CUSTOMERS (or SALES.CUSTOMERS to name the schema too). A name without double quotes is read in capitals, as Oracle reads it (orders means ORDERS); put it in double quotes ("orders") to keep its case.
- Schema (`schema`, text): The table's schema (in Oracle, the user that owns it). Leave empty for your own.
- Values (`values`, object, required): Column and value pairs for the row, including its key, e.g. {"EMAIL": "ada@example.com", "NAME": "Ada"}.
- Match on columns (`key_columns`, list): The columns that identify the row. Leave empty to use the primary key.

**Outputs**

- `action` (text): INSERT or UPDATE; on MySQL, NONE when the row was already the same
- `key_columns` (list): The columns the row was matched on
- `row` (object): The row as stored after the upsert
- `rows_affected` (number): Rows the statement changed; null when the database doesn't say
- `table` (text): The table, with its schema when one was given

**Example output**

```json
{
  "action": "UPDATE",
  "key_columns": [
    "EMAIL"
  ],
  "row": {
    "EMAIL": "ada@example.com",
    "ID": 43,
    "NAME": "Ada"
  },
  "rows_affected": 1,
  "table": "CUSTOMERS"
}
```
