Oracle Database

Usage Instructions

Query, modify, and inspect Oracle Database over Oracle Net using TCP or verified TCPS, with optional in-memory PEM wallet authentication.

Actions

Oracle Database Query

Run one read-only Oracle SELECT statement or ordinary SELECT CTE with optional named IN binds

Input

ParameterTypeRequiredDescription
oauthCredentialstringYesSaved Oracle Database connection
connectionTimeoutnumberNoConnection timeout in milliseconds (default: 15000)
querystringYesOne Oracle SELECT statement without a trailing semicolon. Mutating statements, SELECT FOR UPDATE, sequence changes, database links, comments, hints, and PL/SQL are rejected.
bindsjsonNoOptional named IN bind values keyed without the colon prefix; values may be strings, finite numbers, or null

Output

ParameterTypeDescription
messagestringOperation status message
rowsarrayNormalized rows returned by the statement, when it produces a result set
rowCountnumberNumber of rows returned or affected
truncatedbooleanTrue when rows were dropped to stay inside the row or byte ceiling
truncationReasonstringThe response ceiling that was reached

Oracle Database Insert

Insert one JSON object as a row in an Oracle Database table using bound values

Input

ParameterTypeRequiredDescription
oauthCredentialstringYesSaved Oracle Database connection
connectionTimeoutnumberNoConnection timeout in milliseconds (default: 15000)
schemastringNoOptional exact, case-sensitive owning schema; omit it to use the connection current schema
tablestringYesExact, case-sensitive Oracle table name; use the name returned by introspection
datajsonYesJSON object whose keys are exact, case-sensitive column names and whose values are inserted with IN binds

Output

ParameterTypeDescription
messagestringOperation status message
rowsarrayNormalized rows returned by the statement, when it produces a result set
rowCountnumberNumber of rows returned or affected
truncatedbooleanTrue when rows were dropped to stay inside the row or byte ceiling
truncationReasonstringThe response ceiling that was reached

Oracle Database Update

Update Oracle Database rows selected by a required WHERE expression, using bound values for changed columns

Input

ParameterTypeRequiredDescription
oauthCredentialstringYesSaved Oracle Database connection
connectionTimeoutnumberNoConnection timeout in milliseconds (default: 15000)
schemastringNoOptional exact, case-sensitive owning schema; omit it to use the connection current schema
tablestringYesExact, case-sensitive Oracle table name; use the name returned by introspection
datajsonYesJSON object whose keys are exact, case-sensitive column names and whose values are assigned with IN binds
wherestringYesNon-empty WHERE expression without the WHERE keyword

Output

ParameterTypeDescription
messagestringOperation status message
rowsarrayNormalized rows returned by the statement, when it produces a result set
rowCountnumberNumber of rows returned or affected
truncatedbooleanTrue when rows were dropped to stay inside the row or byte ceiling
truncationReasonstringThe response ceiling that was reached

Oracle Database Delete

Delete Oracle Database rows selected by a required WHERE expression

Input

ParameterTypeRequiredDescription
oauthCredentialstringYesSaved Oracle Database connection
connectionTimeoutnumberNoConnection timeout in milliseconds (default: 15000)
schemastringNoOptional exact, case-sensitive owning schema; omit it to use the connection current schema
tablestringYesExact, case-sensitive Oracle table name; use the name returned by introspection
wherestringYesNon-empty WHERE expression without the WHERE keyword

Output

ParameterTypeDescription
messagestringOperation status message
rowsarrayNormalized rows returned by the statement, when it produces a result set
rowCountnumberNumber of rows returned or affected
truncatedbooleanTrue when rows were dropped to stay inside the row or byte ceiling
truncationReasonstringThe response ceiling that was reached

Oracle Database Execute

Execute one allowed Oracle SQL statement: SELECT, INSERT, UPDATE, DELETE, MERGE, CREATE, ALTER, DROP, or EXPLAIN PLAN

Input

ParameterTypeRequiredDescription
oauthCredentialstringYesSaved Oracle Database connection
connectionTimeoutnumberNoConnection timeout in milliseconds (default: 15000)
querystringYesOne allowed Oracle SQL statement without a trailing semicolon. SELECT FOR UPDATE, PL/SQL, transaction control, OUT binds, RETURNING INTO, and stacked statements are rejected.
bindsjsonNoOptional named IN bind values keyed without the colon prefix; values may be strings, finite numbers, or null. Oracle does not allow bind variables in DDL.

Output

ParameterTypeDescription
messagestringOperation status message
rowsarrayNormalized rows returned by the statement, when it produces a result set
rowCountnumberNumber of rows returned or affected
truncatedbooleanTrue when rows were dropped to stay inside the row or byte ceiling
truncationReasonstringThe response ceiling that was reached

Oracle Database Introspect

Inspect accessible Oracle tables, columns, keys, non-primary-key indexes, and table-owning schemas using ALL_* dictionary views

Input

ParameterTypeRequiredDescription
oauthCredentialstringYesSaved Oracle Database connection
connectionTimeoutnumberNoConnection timeout in milliseconds (default: 15000)
schemastringNoOptional schema to inspect; omit it to inspect CURRENT_SCHEMA and list table owners visible through ALL_TABLES

Output

ParameterTypeDescription
messagestringOperation status message
tablesarrayAccessible table schemas with columns, keys, and indexes
↳ namestringTable name
↳ schemastringOwning Oracle schema
↳ columnsarrayTable columns in ordinal position order
↳ namestringColumn name
↳ typestringOracle data type, including length or precision
↳ nullablebooleanWhether the column allows NULL values
↳ defaultstringDefault value expression
↳ isPrimaryKeybooleanWhether the column is part of the primary key
↳ isForeignKeybooleanWhether the column is a foreign key
↳ referencesobjectCross-schema foreign key reference information
↳ schemastringReferenced schema name
↳ tablestringReferenced table name
↳ columnstringReferenced column name
↳ primaryKeyarrayPrimary key column names in constraint order
↳ foreignKeysarrayForeign key columns declared on the table
↳ columnstringLocal column name
↳ referencesSchemastringReferenced schema name
↳ referencesTablestringReferenced table name
↳ referencesColumnstringReferenced column name
↳ indexesarrayNon-primary-key indexes on the table
↳ namestringIndex name
↳ columnsarrayIndexed columns in column-position order
↳ uniquebooleanWhether the index is declared UNIQUE
schemasarrayTable-owning schemas visible through ALL_TABLES, plus the selected or current schema