【実務・中級編】DataGripの「Database Scripting (JS/Python)」機能：カスタムスクリプトで一括データ処理や外部API連携を自動化する高度な裏技 – データベース・API管理活用バイブル

【DataGrip極意】Database Scriptingで実現する！JS/PythonによるDB自動化と外部API連携の深淵

テックリードの私たちが日々の開発で直面する課題は、単に「SQLを速く書くこと」ではない。
データ移行、複数環境へのマスターデータ同期、外部APIを絡めたマスタの突合、そして退屈な定型バッチ作業の自動化――。これらをいかにスムーズに、かつヒューマンエラーなく完結させるかが、チーム全体の生産性を左右する。

多くのエンジニアは、DataGripを「高機能なSQLクライアント」としか認識していない。だが、それはフェラーリで近所のコンビニに行っているようなものだ。
DataGripには、内部でJavaScript (Rhino/Nashorn/GraalJS)やPythonを駆使してデータベースを直接操作し、さらには外部APIと通信できる「Database Scripting」という隠された最強の武器が存在する。

今回は、GUIの限界を突破し、DataGripを「最強のデータ処理ハブ」へと変貌させる実戦的ノウハウをすべて授けよう。

—

1. 開発スピードを異次元に高めるキーボードショートカット（IntelliJ血統の極み）

スクリプトやクエリを最速で書き上げるためには、マウスに手を伸ばした時点で負けだ。DataGrip（IntelliJプラットフォーム）の真骨頂である、エディタ駆動の操作を体に叩き込め。

—

2. 絶対に入れるべき「神プラグイン」

DataGripの標準機能だけでも強力だが、外部連携やスクリプト開発を加速させるためには、以下のプラグインが必須となる。

1. Rainbow Brackets

複雑なネストを持つJSON設定ファイルやJavaScriptのコードブロックで、括弧の色を変えて視認性を爆発的に向上させる。

2. String Manipulation

スクリプト内で扱う文字列のエンコード、Snake/Camelケース変換、JSONのEscapeなどをショートカット一発で変換。

3. Key Promoter X

マウス操作をした際に「今の操作、このショートカットキーでやれますよ」と画面右下に通知してくれる鬼コーチ。これによってマウスを完全に排除できる。

—

3. Database Scriptingの核心：JavaScript/Pythonによる自動化

DataGripでは、エディタ上でコンテキストメニュー（`File` > `New` > `Script`）からJavaScriptまたはPythonファイルを作成し、JDBCドライバ経由でデータベースを操作できる。

ここでは、「外部REST APIからデータを取得し、トランザクションを張ってDBに一括UPSERTする」という、実務で頻出するシナリオをJavaScript（Rhino環境）で実装してみよう。

実践スクリプト：外部API連携＆ DB一括UPSERT

DataGrip Database Scripting (JavaScript)
外部APIからユーザーマスタを取得し、PostgreSQLへバッチUPSERTするスクリプト
実行方法: エディタ内で右クリック -> “Run ‘‘”

importPackage(java.sql);
importPackage(java.io);
importPackage(java.net);

// 1. 外部APIエンドポイントの設定（例：JSONPlaceholder）
var apiUrl = “https://jsonplaceholder.typicode.com/users”;

function fetchExternalData(urlStr) {
var url = new java.net.URL(urlStr);
var conn = url.openConnection();
conn.setRequestMethod(“GET”);
conn.setRequestProperty(“Accept”, “application/json”);

var reader = new java.io.BufferedReader(new java.io.InputStreamReader(conn.getInputStream()));
var response = new java.lang.StringBuilder();
var line;

while ((line = reader.readLine()) != null) {
response.append(line);
}
reader.close();

// Nashorn/GraalJS等の環境であれば JSON.parse が利用可能
return JSON.parse(response.toString());
}

// 2. DataGripのセッションから自動提供される ‘connection’ オブジェクトを利用
// ※コンソールやスクリプト実行時に紐づいたDBセッションがそのまま使われます
if (typeof connection == ‘undefined’) {
print(“Error: データベース接続コンテキストがありません。DBを選択して実行してください。”);
} else {
try {
// オートコミットを無効化し、バッチ処理の整合性を担保
connection.setAutoCommit(false);

var users = fetchExternalData(apiUrl);
print(“取得レコード数: ” + users.length);

var sql = “INSERT INTO m_users (id, name, email, updated_at) ” +
“VALUES (?, ?, ?, CURRENT_TIMESTAMP) ” +
“ON CONFLICT (id) DO UPDATE SET ” +
“name = EXCLUDED.name, ” +
“email = EXCLUDED.email, ” +
“updated_at = CURRENT_TIMESTAMP;”;

var pstmt = connection.prepareStatement(sql);

for (var i = 0; i < users.length; i++) { var user = users[i]; pstmt.setInt(1, user.id); pstmt.setString(2, user.name); pstmt.setString(3, user.email); // バッチに積む pstmt.addBatch(); } // 一括実行 var results = pstmt.executeBatch(); connection.commit(); print("正常終了: " + results.length + " 件のデータを同期しました。"); pstmt.close(); } catch (e) { print("エラー発生のためロールバックします: " + e.message); connection.rollback(); e.printStackTrace(); } } このスクリプトの美しさは、IDEを離れることなく、JDBCのトランザクション制御と外部HTTP通信をシームレスに融合できる点にある。わざわざ専用のJava/Pythonプロジェクトを立ち上げてビルドする手間が一切不要になる。

—

4. チーム開発で役立つ設定の共有化ルール

個人の環境だけでこのスクリプトが動いても意味がない。チーム全体の資産にするための作法が「Project Settings ( .idea ディレクトリ)」のバージョン管理だ。

共有すべき設定・共有してはいけない設定

共有すべき (`.idea/dataSources.xml` 等)
接続のテンプレート構造、作成したスクリプトファイル群、カスタムSQLスクリプト、コーディング規約。
共有してはいけない (`.idea/dataSources.local.xml` 等)
本番環境のパスワード、個人のアクセストークン、ローカルホスト以外のセキュアな認証情報。
※DataGripはデフォルトでパスワード等の機密情報を `dataSources.local.xml` に分離し、Git管理から除外する設計になっているが、`.gitignore` の設定は必ず以下のように確認すること。

.gitignore のベストプラクティス
.idea/dataSources.local.xml
.idea/workspace.xml
.idea/tasks.xml
.idea/http-requests-2.sqlite

これにより、チームメンバー全員が同じスクリプト資産（Database Scripting）を共有しつつ、各々の安全な資格情報でDBを叩く環境が構築できる。

—

5. 実用的な設定ファイル（JSON）のベストプラクティス構成例

スクリプト内でハードコードを避けるため、環境ごとのAPIのエンドポイントやバッチの挙動を制御する設定ファイルをプロジェクト内に配置し、スクリプトから読み込ませるのがプロの作法だ。

プロジェクトルートに `config/batch-settings.json` を配置する：

{
“environment”: “production”,
“sync_target”: {
“api_endpoint”: “https://api.internal.corp.v2/masters/users”,
“timeout_ms”: 5000,
“retry_count”: 3
},
“database”: {
“target_table”: “m_users”,
“batch_size”: 500,
“enable_slack_notification”: true,
“webhook_url”: “https://hooks.slack.com/services/T00/B00/X00”
}
}

これをDataGripのスクリプト側から読み込むことで、開発環境、ステージング環境、本番環境での挙動を安全かつスマートに切り替えることができる。

—

結び：ツールを使い倒すエンジニアであれ

DataGripは単なる「ビューア」ではない。適切なスクリプトとアーキテクチャの知識をもって挑めば、あなたの手元にあるそれは、「最も小回りの利く強力なデータパイプライン基盤」に変貌する。

GUIの快適さと、スクリプトによる拡張性。この二つを高い次元で融合させ、退屈な手作業をコードで駆逐せよ。それこそが、現場をリードするエンジニアの仕事である。

1. 開発スピードを異次元に高めるキーボードショートカット（IntelliJ血統の極み）

2. 絶対に入れるべき「神プラグイン」

3. Database Scriptingの核心：JavaScript/Pythonによる自動化

実践スクリプト：外部API連携 ＆ DB一括UPSERT

4. チーム開発で役立つ設定の共有化ルール

共有すべき設定・共有してはいけない設定

5. 実用的な設定ファイル（JSON）のベストプラクティス構成例

結び：ツールを使い倒すエンジニアであれ

実践スクリプト：外部API連携＆ DB一括UPSERT