Oracle SQL Developer for VS Codeは、Oracle Databaseの開発や操作をVisual Studio Code上で行うための、Oracle公式のVS Code拡張機能です。
SQLの実行だけでなく、PL/SQLの開発、データベースオブジェクトの参照、テーブルデータの編集、SQL Notebook、Database Diagram、SQLclとの連携、DBA向け機能など、Oracle Databaseを扱うための幅広い機能が搭載されています。
従来はOracle Databaseの操作に「Oracle SQL Developer」という専用アプリケーションを使用するケースが一般的でした。
Oracle SQL Developer for VS Codeを利用すれば、JavaやPython、JavaScriptなどのアプリケーションコードとOracle Database関連のSQLやPL/SQLを、同じVS Code環境で扱いやすくなります。
Oracle公式のVS Code拡張機能
Oracle SQL Developer for VS CodeはOracle Corporationが提供しています。
Visual Studio MarketplaceにおけるExtension IDは、次のとおりです。
Oracle.sql-developer
VS Codeで拡張機能を検索するときは、「Oracle SQL Developer」などで検索し、PublisherがOracle Corporationであることを確認するとよいでしょう。
Oracle SQL Developerとの違い
Oracleには、以前からデスクトップアプリケーション版のOracle SQL Developerがあります。
一方、Oracle SQL Developer for VS Codeは、Visual Studio Codeにインストールして利用する拡張機能です。
両者は同一のアプリケーションではありませんが、SQLやPL/SQLの開発、データベースオブジェクトの管理など、共通する用途があります。
Oracle SQL Developer for VS Codeでは、VS CodeのGit機能やターミナル、ほかのプログラミング言語向け拡張機能などと組み合わせられる点が大きな特徴です。
Oracle SQL Developer for VS Codeでできること
Oracle SQL Developer for VS Codeには、Oracle Databaseを開発・操作するためのさまざまな機能があります。
代表的な機能として、次のようなものがあります。
- Oracle Databaseへの接続
- SQLの作成・実行
- SQLスクリプトの実行
- SQL Worksheet
- SQL Notebook
- SQL履歴
- SQLコード補完
- PL/SQLの作成・編集
- PL/SQLのコンパイル
- PL/SQLの実行
- PL/SQLデバッグ
- テーブルやビューなどの参照
- データの追加・更新・削除
- DDLの確認・生成
- Database Diagram
- SQLclとの連携
- Oracle APEX関連機能
- JSON Relational Duality View関連機能
- ユーザー・ロール管理
- DBA向け管理機能
- AWR・ASHレポート
単純なSQL実行ツールではなく、Oracle Database向けの総合的な開発環境として利用できます。
Oracle SQL Developer for VS Codeをインストールする方法
Oracle SQL Developer for VS Codeは、通常のVS Code拡張機能と同じようにインストールできます。
Extensionsを開く
まずVS Codeを起動します。
左側のActivity Barから「Extensions」をクリックします。
WindowsやLinuxでは、次のショートカットでも開けます。
Ctrl + Shift + X
Oracle SQL Developerを検索する
Extensionsの検索欄に、次のようなキーワードを入力します。
Oracle SQL Developer
表示された拡張機能の中から、「Oracle SQL Developer for VS Code」を探します。
同名や類似名の拡張機能と混同しないよう、PublisherがOracle Corporationであることを確認すると安心です。
Installをクリックする
対象の拡張機能を開いて「Install」をクリックします。
インストールが完了すると、VS CodeのActivity BarにSQL Developer関連のアイコンが表示されます。
通常はVS Codeの拡張機能更新機能によって、新しいバージョンが公開された場合にアップデートできます。
VSIXファイルから手動インストールすることもできる
企業ネットワークなどでVisual Studio Marketplaceへアクセスできない場合には、VSIXファイルを使って手動インストールする方法もあります。
Oracle公式サイトでは、Windows、Linux、macOS向けのVSIXファイルが配布されています。
VS Codeでは、Extensions画面のメニューから、
Install from VSIX...
を選択し、ダウンロードしたVSIXファイルを指定します。
Marketplaceへのアクセスが制限されている環境や、特定バージョンを手動で導入したい場合に便利です。
Oracle Databaseへ接続する方法
Oracle SQL Developer for VS Codeをインストールしたら、次はOracle Databaseへの接続設定を作成します。
接続方式は複数用意されており、環境に応じて選択できます。
Basic接続
一般的なOracle Databaseへの接続では、Basic接続を利用できます。
主に次の情報を入力します。
Connection Name
Hostname
Port
Service Name
Username
Password
たとえばローカル環境であれば、次のような設定になる場合があります。
Connection Name: local-oracle
Hostname: localhost
Port: 1521
Service Name: FREEPDB1
Username: system
Password: ********
ただし、FREEPDB1はOracle Database Freeでよく使われるService Nameの一例です。
実際のService Nameはインストール環境やデータベース構成によって異なるため、利用しているOracle Databaseの設定を確認してください。
TNS接続
企業システムなどでtnsnames.oraを利用している場合は、TNS接続も利用できます。
たとえばtnsnames.oraに、
ORCL =
(DESCRIPTION =
(ADDRESS =
(PROTOCOL = TCP)
(HOST = db.example.com)
(PORT = 1521)
)
(CONNECT_DATA =
(SERVICE_NAME = ORCL)
)
)
のような接続情報が登録されている場合、Network Aliasを利用して接続できます。
Cloud Wallet接続
Oracle Autonomous Databaseなどへ接続する場合は、Cloud Walletを利用できます。
Oracle CloudからダウンロードしたWallet ZIPを指定し、接続先のServiceを選択して接続できます。
Autonomous Databaseを利用している場合には特に便利な接続方法です。
Custom JDBC接続
JDBC URLを直接指定したい場合には、Custom JDBC接続を利用できます。
標準的なBasic接続では対応しにくい特殊な接続構成を利用している場合などに便利です。
OCI Database Tools接続
OCI Database Toolsに登録している接続情報を利用する方法もあります。
OCI上でデータベース接続情報を一元管理している場合に使いやすい方式です。
SQL WorksheetでSQLを実行できる
Oracle SQL Developer for VS Codeでは、SQL Worksheetを利用してSQLを実行できます。
たとえば次のようなSQLを実行できます。
SELECT *
FROM employees;
条件や並び順を指定することも可能です。
SELECT
employee_id,
first_name,
last_name,
salary
FROM employees
WHERE salary >= 10000
ORDER BY salary DESC;
実行結果はData Gridとして表示されるため、取得したデータを視覚的に確認できます。
テーブルやビューを確認できる
Connectionsビューでは、接続先データベースの各種オブジェクトをツリー形式で参照できます。
たとえば、次のようなオブジェクトを確認できます。
Connections
└─ my_database
├─ Tables
├─ Views
├─ Indexes
├─ Packages
├─ Procedures
└─ Functions
既存データベースの構造を確認するときにも便利です。
テーブルデータを編集できる
権限があれば、テーブルデータをData Gridから追加・変更・削除できます。
たとえば、
- INSERT
- UPDATE
- DELETE
に相当する操作をGUIから実行できます。
BLOBやCLOBなどのデータ型についても、ファイルを扱える機能が用意されています。
DDLを確認できる
Oracle SQL Developer for VS Codeでは、データベースオブジェクトのDDLを確認できます。
たとえば既存テーブルに対して、
CREATE TABLE ...
に相当する定義を確認できます。
既存データベースの調査や、テーブル構造の確認、DDLのバックアップなどにも役立ちます。
PL/SQLを開発できる
Oracle SQL Developer for VS Codeでは、PL/SQLの作成や編集にも対応しています。
たとえば、次のようなProcedureを作成できます。
CREATE OR REPLACE PROCEDURE hello_world
AS
BEGIN
DBMS_OUTPUT.PUT_LINE('Hello World');
END;
/
Procedureだけでなく、FunctionやPackage、TriggerなどのPL/SQLオブジェクトも扱えます。
コンパイルエラーを確認できる
PL/SQLをコンパイルした際にエラーが発生した場合、エラー内容を確認できます。
VS Code上でコードを編集しながら修正できるため、一般的なプログラミング言語に近い感覚でPL/SQL開発を行えます。
PL/SQLをデバッグできる
Oracle SQL Developer for VS CodeにはPL/SQL Debuggerも用意されています。
主に次のようなデバッグ操作を行えます。
Breakpoint
Step Over
Step Into
Variable inspection
Call Stack
Stop
Restart
処理を1行ずつ確認したり、変数の値を確認したりできるため、複雑なPL/SQLプログラムの不具合調査に便利です。
デバッグには権限が必要
PL/SQLデバッグを利用するには、Oracle Database側で必要な権限が付与されている必要があります。
たとえば、環境によっては次のような権限が関係します。
DEBUG CONNECT SESSION
また、Oracle Network ACLやファイアウォールの設定が必要になる場合もあります。
本番環境では、セキュリティポリシーや管理者の方針を確認したうえで利用する必要があります。
SQLコード補完を利用できる
SQLやPL/SQLを入力するときには、コード補完機能を利用できます。
テーブル名、カラム名、SQL構文などの候補が表示されるため、SQL入力を効率化できます。
また、SQL Snippetsとして、さまざまなSQL関数や構文を呼び出すこともできます。
たとえば、
- Aggregate Functions
- Analytic Functions
- Character Functions
- Conversion Functions
- Date Functions
- Numeric Functions
- Optimizer Hints
などがあります。
Oracle SQLを頻繁に記述する場合には便利な機能です。
SQL Notebookを利用できる
SQL Worksheetだけでなく、SQL Notebookも利用できます。
SQL Notebookでは、SQLやPL/SQLのコードとMarkdownによる説明を組み合わせて管理できます。
たとえば、
調査目的
↓
SQL
↓
実行結果
↓
分析メモ
↓
次のSQL
のような構成にできます。
データ調査や分析手順を記録したい場合にも利用しやすい機能です。
Database Diagramでデータベース構造を確認できる
Oracle SQL Developer for VS CodeにはDatabase Diagram機能があります。
テーブルやビューなどのデータベースオブジェクトを視覚的に表示できます。
一般的なER図に近い用途でも利用できますが、Oracle公式では「Database Diagram」や「Diagram」という名称で提供されています。
たとえば、
EMPLOYEES
│
▼
DEPARTMENTS
│
▼
LOCATIONS
のように、テーブル間の関連を把握するときに便利です。
既存システムのデータベース構造を調査するときにも活用できます。
DBA向け機能も利用できる
Oracle SQL Developer for VS Codeには、DBA向けの管理機能も用意されています。
接続設定でDBA関連機能を有効にすると、DBA Panelから各種管理機能を利用できます。
DBA設定を有効にしても権限は付与されない
注意したいのは、接続設定でDBAモードを有効にしても、Oracle Database側の権限が自動的に付与されるわけではない点です。
DBA関連機能を利用するには、接続しているユーザーが必要なデータベース権限を持っている必要があります。
ユーザーやロールを管理できる
DBA関連機能では、Oracle Databaseのユーザーやロールも管理できます。
たとえば、
Create User
Clone User
Lock Account
Unlock Account
Role Privileges
といった操作ができます。
変更用のDDLを確認してから実行できる機能もあるため、管理作業の内容を確認しながら操作できます。
AWR・ASHレポートを利用できる
Oracle Databaseのパフォーマンス分析に利用されるAWRやASHのレポート生成にも対応しています。
AWRとは
AWRはAutomatic Workload Repositoryの略です。
データベースのパフォーマンス情報を一定間隔で取得し、負荷状況やSQLの実行状況などを分析するために利用されます。
ASHとは
ASHはActive Session Historyの略です。
アクティブなデータベースセッションの状態を分析するときに利用されます。
Oracle Databaseのライセンスに注意する
AWRやASHなどの機能は、Oracle DatabaseのDiagnostics Packなどのライセンス条件に関係する場合があります。
そのため、
Oracle SQL Developer for VS Code
→ 無料
Oracle Database本体
→ エディションや契約による
Diagnostics Pack / Tuning Pack
→ 契約内容による
と分けて考える必要があります。
SQL Developer for VS Code自体が無料でも、Oracle Database側の有償機能を無条件に利用できるわけではありません。
企業環境では、利用前にOracle Databaseのライセンス契約を確認することが重要です。
SQLclと連携できる
Oracle SQL Developer for VS Codeは、Oracle SQLclとも連携できます。
SQLclはOracleが提供しているコマンドラインベースのOracle Databaseクライアントです。
SQL Developer for VS Codeで作成した接続を利用して、VS CodeのTerminalからSQLclセッションを開始できます。
イメージとしては、
GUI操作
→ Oracle SQL Developer for VS Code
CLI操作
→ SQLcl
という使い分けができます。
GUIとCLIの両方を同じVS Code環境で利用できる点は便利です。
SQLcl MCP Serverとの連携もある
比較的新しい機能として、Oracle SQLcl MCP Serverとの連携もあります。
MCPに対応するVS Code拡張機能などから、SQL Developerのデータベース接続情報を利用できる仕組みが提供されています。
AI支援機能などとOracle Database開発を組み合わせる場合にも注目される機能です。
ただし、AIツールからデータベースを操作する場合は、接続先や権限、実行されるSQLの内容を十分に確認する必要があります。
Oracle APEX関連機能もある
Oracle SQL Developer for VS CodeにはOracle APEX関連の機能も用意されています。
APEXアプリケーションのソースやAPEXLangなどをVS Code内で扱える機能があります。
ただし、Oracle APEXのすべての開発作業をVS Codeだけで完結できるという意味ではありません。
APEXのソース管理や関連開発をVS Codeへ統合するための機能と考えるとよいでしょう。
JSON Relational Duality Viewにも対応している
Oracle Databaseでは、JSONとリレーショナルデータを組み合わせて扱えるJSON Relational Duality Viewという機能があります。
Oracle SQL Developer for VS Codeでは、JSON Relational Duality View関連の開発や操作にも対応しています。
Oracle Database 23ai以降の新しいJSON関連機能を利用する場合にも活用できます。
日本語表示にも対応している
Oracle SQL Developer for VS Codeは、日本語を含む複数の言語に対応しています。
日本語版VS Codeを利用している場合でも利用しやすい拡張機能です。
ただし、機能名や一部のドキュメントについては英語表記になる場合があります。
Gitと組み合わせて利用しやすい
Oracle SQL Developer for VS Codeのメリットの一つは、VS Code標準のGit機能と組み合わせやすいことです。
たとえば、SQLやPL/SQLファイルを次のように管理できます。
database/
├─ tables/
│ ├─ employees.sql
│ └─ departments.sql
├─ views/
│ └─ employee_view.sql
├─ packages/
│ └─ employee_pkg.sql
├─ procedures/
│ └─ update_salary.sql
└─ migrations/
├─ V001.sql
└─ V002.sql
VS CodeのGit機能を利用すれば、
SQLを変更
↓
差分を確認
↓
Commit
↓
Push
↓
Pull Request
といったソフトウェア開発と同じようなワークフローにOracle Databaseの変更を組み込めます。
ただし、これはSQL Developer for VS Code独自のGit機能というより、VS Codeが持つGit機能と組み合わせられるメリットです。
Oracle Developer Tools for VS Codeとの関係
Oracle関連のVS Code拡張機能を調べると、「Oracle Developer Tools for VS Code」という名称を見かけることがあります。
この点は少し注意が必要です。
以前はOracle Developer Tools for VS Codeが提供されていた
以前は、次のExtension IDでOracle公式の拡張機能が提供されていました。
Oracle.oracledevtools
この拡張機能は「Oracle Developer Tools for VS Code」という名称で提供されていました。
現在はOracle SQL Developer for VS Codeが中心
現在Oracleが主要なOracle Database向けVS Code拡張機能として提供しているのは、
Oracle SQL Developer for VS Code
Oracle.sql-developer
です。
一部のOracleドキュメントでは、現在でも「Oracle Developer Tools for VS Code」という名称が残っている場合があります。
古い記事やドキュメントを参照すると名称が混在していることがあるため、現在利用する拡張機能を判断するときはExtension IDを確認すると分かりやすいでしょう。
Oracle SQL Developer for VS Codeは無料で利用できる
Oracle SQL Developer for VS Code自体は無料で提供されています。
ただし、接続先となるOracle Databaseのライセンスや、Diagnostics Pack、Tuning Packなどのオプションライセンスは別途確認が必要です。
そのため、企業環境では、
VS Code拡張機能の料金
Oracle Databaseのライセンス
Oracle Databaseオプションのライセンス
を分けて確認する必要があります。
Oracle SQL Developer for VS Codeが向いている人
Oracle SQL Developer for VS Codeは、普段からVS Codeを利用しているOracle Database開発者に特に向いています。
たとえば、
Java + Oracle Database
Python + Oracle Database
Node.js + Oracle Database
APEX + PL/SQL
SQL + PL/SQL + Git
といった開発環境では便利です。
アプリケーションコード、SQL、PL/SQL、Git、ターミナルを同じVS Code上で扱えるため、複数のツールを頻繁に切り替える必要を減らせます。
一方で、Oracle Databaseの管理作業だけを行う場合や、従来のOracle SQL Developerに慣れている場合には、デスクトップ版SQL Developerのほうが操作しやすいケースもあります。
Oracle SQL Developer for VS Codeを利用するときの注意点
Oracle SQL Developer for VS Codeは便利ですが、利用時にはいくつか注意点があります。
本番データベースへの接続に注意する
SQL WorksheetやData GridからSQLを実行できるため、本番データベースへ接続している場合は誤操作に注意する必要があります。
特に、
UPDATE
DELETE
DROP
ALTER
TRUNCATE
などを実行するときは、接続先や対象スキーマを十分に確認してください。
DBAモードだけでは権限は付与されない
DBA関連機能を表示しても、Oracle Database側の権限がなければ操作できません。
必要な権限はデータベース管理者に確認する必要があります。
AWRやASHはライセンスを確認する
AWR、ASH、SQL Tuning関連機能などを利用する場合は、Oracle Database側のライセンス契約を確認する必要があります。
特に企業環境では、ライセンス条件を確認せずに使用しないよう注意しましょう。
AI連携では実行SQLを確認する
SQLcl MCP Serverなどを利用してAI支援ツールとOracle Databaseを連携する場合、生成されたSQLをそのまま実行するのではなく、内容を確認することが重要です。
本番環境では、読み取り専用ユーザーを利用するなど、権限を適切に制限することも検討するとよいでしょう。
Oracle SQL Developer for VS Codeのまとめ
Oracle SQL Developer for VS Codeは、Oracle Databaseの開発や操作をVS Codeへ統合できるOracle公式の拡張機能です。
SQLの実行だけでなく、
SQL Worksheet
SQL Notebook
PL/SQL開発
PL/SQLデバッグ
データ編集
DDL確認
Database Diagram
SQLcl
DBA機能
AWR・ASH
Oracle APEX関連機能
JSON Relational Duality View
など、幅広い機能を利用できます。
特に、普段からVS CodeでJava、Python、JavaScriptなどのアプリケーションを開発している場合には、
VS Code
+ Git
+ SQL
+ PL/SQL
+ Oracle Database
という形で開発環境を統合しやすいことが大きなメリットです。
一方、Oracle Databaseのライセンスが関係する機能やDBA操作、PL/SQLデバッグなどについては、接続ユーザーの権限や契約内容を確認する必要があります。
また、古い情報では「Oracle Developer Tools for VS Code」という名称が登場する場合がありますが、現在利用する場合は「Oracle SQL Developer for VS Code」とExtension IDのOracle.sql-developerを確認すると、古い拡張機能との混同を防ぎやすいでしょう。
以上、Oracle SQL Developer for VS Codeについてでした。
最後までお読みいただき、ありがとうございました。










