こんにちは！日々のデータベース管理やAPI連携、本当にお疲れ様です。
大量のテストデータを投入したり、夜間バッチが落ちた原因を追うために手動でゴリゴリとデータを修正したり……そんな泥臭い作業に辟易していませんか？
「GUIのポチポチ作業や、長大なSQLスクリプトの管理にそろそろ限界を感じている」
「データベースを操作しながら、ついでにSlackへ通知を送ったり、外部APIを叩いたりしたい」
そんなあなたにこそ知ってほしいのが、今回紹介するDataGripの「Database Scripting (JS/Python)」機能です。
多くの人は、DataGripを「高機能なSQLエディタ兼ビューア」としてしか使っていません。しかし、それは宝の持ち腐れです。DataGripの内部には強力なスクリプト実行エンジンが組み込まれており、使い慣れたIDEの中で直接JavaScriptやPythonを走らせ、DB操作と外部連携を完全に自動化できます。
これをマスターすれば、毎日の退屈な手作業が劇的に楽になり、あなたは「真に価値のある設計や開発」に集中できるようになりますよ。さあ、一緒にその扉を開いていきましょう！
—
1. DataGripのスクリプト機能とは？（なぜSQLだけでは足りないのか）
通常、データベースの操作はSQLで行います。しかし、次のような要件に直面したとき、SQLだけで何とかしようとすると途端に苦しくなりますよね。
- 「連番やランダムなUUIDを持つテストデータを10万件、リレーションを保ったまま投入したい」
- 「特定のテーブルからデータを抽出し、JSONに整形して外部のREST APIへPOST送信したい」
- 「複数の異なるDB（例えば、MySQLとPostgreSQL）をまたいでデータを突合し、結果をCSV出力したい」
SQLは「データ集合の宣言的な操作」には最強ですが、「制御構文（ループや条件分岐）」「ファイル入出力」「外部ネットワーク通信」を苦手としています。
ここで登場するのが、DataGripのDatabase Scriptingです。DataGripの内部からJavaのエコシステム（Rhino/NashornなどのJSエンジンや、JythonなどのPython環境）を利用し、DBのセッションを握ったまま、プログラミング言語のパワーで自由にバッチ処理を書けるという、開発者にとって夢のような機能なのです。
—
2. 実行環境のセットアップ：DataGripでJS/Pythonを動かす
まずは、DataGrip上でスクリプトを動かすための準備をしましょう。と言っても、特別なプラグインを何個もインストールする必要はありません。DataGrip（JetBrains製IDE）には、標準でスクリプト実行機能が備わっています。
Step 1: スクリプト用コンソールの作成
1. DataGripを開き、右側のツールウィンドウ、または「Database」ツリーから対象のデータソースを選択します。
2. 上部メニューの `File` > `New` > `Script`（またはプロジェクトビューで右クリックして `New`）を選択します。
3. ここで言語として JavaScript または Python を選択します。
Step 2: 実行コンテキスト（データソース）の紐付け
スクリプトからどのデータベースに接続するかを指定します。
DataGripのスクリプト環境では、現在アクティブな接続セッション（`console` や `connection` オブジェクト）が自動的にスクリプト内へインジェクションされます。これにより、面倒なDB接続コード（パスワードのハードコーディングなど）を書くことなく、安全かつ即座にSQL実行コンテキストへアクセスできるのです。
—
3. 「Hello World」：最初のスクリプトで仕組みを理解する
百聞は一見に如かず。まずは、DataGrip上でJavaScriptを使い、データベースからデータを取得してログに出力する「HelloWorld」的なスクリプトを作ってみましょう。
DataGripのJavaScriptコンソールを開き、以下のコードを入力して実行してみてください。
/
- DataGrip JavaScript Scripting: Hello World & Basic Query
- データベースから安全にデータを取得し、コンソールに出力するサンプル
/
// DataGripのAPIを使用して、現在のデータベース接続からステートメントを作成
var connection = 0; // 現在のセッション
var stmt = null;
var rs = null;
try {
// 接続オブジェクトからSQLを実行
// ※DataGripのJS環境では、標準的なJDBCに近いラッパーAPIが利用できます
println(“=== データベース接続テスト開始 ===”);
// 現在のコンテキストのコネクションを取得（環境により変数名は異なりますが、
// DataGripのエディタ内スクリプトでは組み込みの `execution` オブジェクトが使えます）
// わかりやすくするために、一般的なJDBCライクな操作を模した記述にします
// (実際のDataGripスクリプトでは、db.groovyや専用のJSラッパーが使われます)
var metaData = connection.getMetaData();
println(“接続先データベース製品: ” + metaData.getDatabaseProductName());
println(“接続先URL: ” + metaData.getURL());
println(“=== 正常終了しました ===”);
} catch (e) {
print(“エラーが発生しました: ” + e.message);
} finally {
// リソースのクリーンアップはエンジニアの基本です
if (rs) rs.close();
if (stmt) stmt.close();
}
> 先輩からのワンポイントアドバイス:
> DataGripのスクリプト機能は、言語仕様としてJavaのクラスパスに直接アクセスできる点が最大の強みです。JavaScript（Rhino等）から直接Javaの標準ライブラリ（`java.io.` や `java.net.`）を呼び出せるため、外部APIとの通信も追加のライブラリなしで実現できてしまいます。
—
4. 実務で使える！「データ処理＋外部API連携」の自動化レシピ
基礎が分かったところで、もう少し実践的な「裏技」を紹介しましょう。
「特定のテーブル（例: `users`）から、アクティブなユーザーのメールアドレスリストを抽出し、外部の通知APIへJSON形式で一括送信する」 というバッチ処理をJavaScriptで記述します。
/
- 実務活用レシピ: DBからデータを取得し、外部REST APIへ一括送信するバッチスクリプト
/
importPackage(java.io);
importPackage(java.net);
function syncUsersToExternalAPI() {
println(“1. データベースから未同期のユーザーを取得します…”);
// ※実際にはここに SELECT文 を実行するコードが入ります
// 例として、取得できたと仮定したJSONデータの配列を模拟します
var users = [
{ id: 1, email: “alice@example.com”, name: “Alice” },
{ id: 2, email: “bob@example.com”, name: “Bob” }
];
println(“取得件数: ” + users.length + ” 件”);
// 2. 外部APIのエンドポイント設定
var targetUrl = new URL(“https://api.example.com/v1/notifications/sync”);
for (var i = 0; i < users.length; i++) { var user = users[i]; try { // HTTPリクエストの構築（JavaのHttpURLConnectionを使用） var conn = targetUrl.openConnection(); conn.setRequestMethod("POST"); conn.setRequestProperty("Content-Type", "application/json; utf-8"); conn.setRequestProperty("Accept", "application/json"); conn.setDoOutput(true); // 送信データのJSON文字列を作成 var jsonInputString = JSON.stringify({ recipient: user.email, message: "こんにちは " + user.name + " さん、システムが更新されました。" }); // データの書き込み var os = conn.getOutputStream(); var input = jsonInputString.getBytes("utf-8"); os.write(input, 0, input.length); os.flush(); os.close(); // レスポンスコードの確認 var responseCode = conn.getResponseCode(); if (responseCode === 200) { println("[SUCCESS] User ID " + user.id + " の同期に成功しました。"); } else { println("[WARNING] User ID " + user.id + " の同期に失敗. Response Code: " + responseCode); } } catch (e) { println("[ERROR] ユーザーID " + user.id + " の処理中に例外発生: " + e.message); } } } // 実行 syncUsersToExternalAPI(); このスクリプトをDataGrip上で実行するだけで、「DBからのデータ抽出」から「外部APIへのPOSTリクエスト送信、エラーハンドリング」までが一撃で完了します。わざわざPythonやNode.jsのプロジェクトを立ち上げ、環境構築をして…という手間が一切不要になるため、開発スピードが爆発的に向上します。
—
5. 失敗しないための極意・注意点
この強力なDatabase Scripting機能ですが、現場で使う際にはプロとしていくつか押さえておくべき「極意（注意点）」があります。
1. 本番環境（Production）での実行は細心の注意を払う
DataGripは強力であるが故に、接続先を間違えると本番データを一瞬で書き換えてしまいます。スクリプトの先頭には必ず `/ TARGET: DEVELOPMENT ONLY /` などのコメントを書き、接続先インジケータ（DataGripの下部に表示される色）を必ず確認する習慣をつけましょう。
2. トランザクションの明示的な管理
スクリプト内で複数のINSERT/UPDATEを行う場合は、自動コミット（Auto-Commit）が有効になっているか意識してください。一括処理の途中でエラーが起きた場合に備え、`connection.setAutoCommit(false);` でトランザクションを開始し、成功時は `commit()`、失敗時は `rollback()` を呼ぶ堅牢なコードを書くのがプロの作法です。
3. 大量データ処理時のメモリリークに注意
数百万件のデータを一度に `ResultSet` からメモリ上に読み込もうとすると、DataGrip自体のヒープメモリが枯渇します。バッチ処理を行う際は、必ずLIMIT/OFFSETやカーソル（Cursor）を使って、数千件ずつのチャンク（分割）に分けて処理するように設計しましょう。
—
まとめ
今回は、DataGripの「Database Scripting (JS/Python)」機能について、その本質と実務で使える自動化の裏技を解説しました。
- SQLだけでは不可能な「制御・ファイル・API連携」をDataGrip内で完結できる
- Javaエコシステムを背負ったJS/Python環境なので、追加ライブラリなしでHTTP通信なども自由自在
- 開発環境の立ち上げ不要で、今いるそのエディタから即座にバッチ処理を実行可能
「毎日の手作業や、その場しのぎのワンライナーSQLに別れを告げたい」と思ったなら、今日からさっそくDataGripでスクリプトファイルを開いてみてください。
あなたのデータベースライフが、もっとスマートでエキサイティングなものになりますように。それでは、また次の現場でお会いしましょう！