oracledb について
Node.js スクリプトで Oracle Database の操作と診断を行うスキルです。SQL の実行に加え、実行計画、セッション、スキーマオブジェクト、テーブル、表領域の使用状況、リソース消費の大きい SQL を調べられます。
主な機能
- 01SQL 文の実行
- 02SQL 実行計画の生成
- 03アクティブなデータベースセッションの一覧
- 04無効なスキーマオブジェクトの検出
- 05テーブルと表領域使用量の確認
- 06リソース消費量による SQL の順位付け
活用シーン
- 01接続中のデータベースで SQL を実行
- 02クエリを実行せずに実行計画を分析
- 03アクティブなセッションと無効オブジェクトを確認
- 04表領域使用量と高負荷 SQL を監視
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/oracledbを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
scripts/execute_sql.jsget_query_plan.jslist_active_sessions.jslist_invalid_objects.jslist_tables.jslist_tablespace_usage.jslist_top_sql_by_resource.js詳細
使用方法
すべてのスクリプトは Node.js を使用して実行できます。<param_name> と <param_value> を実際の値に置き換えてください。
Bash:
node <skill_dir>/scripts/<script_name>.js '{"<param_name>": "<param_value>"}'
PowerShell:
node <skill_dir>/scripts/<script_name>.js '{\"<param_name>\": \"<param_value>\"}'
注：スクリプトは複数の .env ファイルから環境変数を自動的に読み込みます。環境変数が不足しているためにスキルの実行が失敗しない限り、ユーザーに変数の設定を求めないでください。
スクリプト
execute_sql
任意の SQL 文を実行します。
パラメーター
| 名前 | 型 | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| sql | 文字列 | 実行する SQL です。 | はい |
get_query_plan
EXPLAIN PLAN を使用して、単一の SQL 文の完全な実行計画を生成します。実行せずにクエリのパフォーマンスを分析できます。パラメーターとして SQL 文を入力する必要があります。
パラメーター
| 名前 | 型 | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| query | 文字列 | 計画を生成する SQL 文です（EXPLAIN キーワードは省略してください）。 | はい |
list_active_sessions
現在実行中のデータベースセッション（STATUS='ACTIVE'）の上位 N 件（デフォルトは 50 件）を一覧表示し、SID、OS ユーザー、プログラム、および現在の SQL 文のテキストを表示します。
list_invalid_objects
無効な状態にあり、再コンパイルが必要なすべてのデータベースオブジェクト（プロシージャ、関数、ビューなど）を一覧表示します。
list_tables
接続先スキーマ内のすべてのユーザーテーブルを、セグメントサイズ、行数、最終分析日とともに一覧表示します。カンマ区切りの名前リストでフィルタリングできます。名前を省略すると、現在のユーザーのスキーマにあるすべてのテーブルを一覧表示します。
list_tablespace_usage
ストレージ使用状況を監視するため、表領域名、合計サイズ、空き領域、および使用率を一覧表示します。
list_top_sql_by_resource
選択したリソース指標（CPU、I/O、または経過時間）に基づいて、ライブラリキャッシュ内の上位 N 件（デフォルトは 5 件）の SQL 文を一覧表示します。SQL ID、実行回数、バッファー読み取り数、ディスク読み取り数、CPU 時間、および経過時間を表示します。