oracledb

Usage

All scripts can be executed using Node.js. Replace <param_name> and <param_value> with actual values.

Bash: node <skill_dir>/scripts/<script_name>.js '{"<param_name>": "<param_value>"}'

PowerShell: node <skill_dir>/scripts/<script_name>.js '{\"<param_name>\": \"<param_value>\"}'

Note: The scripts automatically load the environment variables from various .env files. Do not ask the user to set vars unless skill executions fails due to env var absence.

Scripts

execute_sql

Executes one read-only SELECT or WITH query by default. The wrapper rejects multiple statements, DDL, DML, transaction control, PL/SQL, CALL, COPY, DO, SELECT INTO, and row-locking queries before starting the database tool.

Parameters

Name	Type	Description	Required	Default
sql	string	One read-only SQL query to execute.	Yes

A non-read statement requires both explicit CLI acknowledgements and should be used only after the user confirms the exact SQL:

node <skill_dir>/scripts/execute_sql.js \
  --dangerous --confirm-dangerous-sql=EXECUTE \
  '{"sql":"<confirmed non-read SQL>"}'

---

get_query_plan

Generate a full execution plan for one SELECT or WITH query using EXPLAIN PLAN. The wrapper applies the same read-only statement validation and the same two-flag dangerous override as execute_sql before invoking the tool.

Parameters

Name	Type	Description	Required	Default
query	string	The SQL statement for which you want to generate plan (omit the EXPLAIN keyword).	Yes

---

list_active_sessions

List the top N (default 50) currently running database sessions (STATUS='ACTIVE'), showing SID, OS User, Program, and the current SQL statement text.

---

list_invalid_objects

Lists all database objects that are in an invalid state, requiring recompilation (e.g., procedures, functions, views).

---

list_tables

Lists all user tables in the connected schema, including segment size, row count, and last analyzed date. Filters by a comma-separated list of names. If names are omitted, lists all tables in the current user's schema.

---

list_tablespace_usage

List tablespace names, total size, free space, and used percentage to monitor storage utilization.

---

list_top_sql_by_resource

List the top N (default 5) SQL statements from the library cache based on a chosen resource metric (CPU, I/O, or Elapsed Time). Shows SQL ID, execution count, buffer gets, disk reads, CPU time, and elapsed time.

---