
Oracle PL/SQLをPostgreSQLへ移行する際の落とし穴【トランザクション・パッケージの書き換え方を解説】
OracleからPostgreSQLへのデータベース移行プロジェクトにおいて、ストアドプロシージャ言語であるPL/SQLからPL/pgSQLへの変換は、最も複雑で困難なタスクの一つです。多くの移行プロジェクトがここで苦戦を強いられます。なぜなら、PL/SQLの方が言語仕様が豊かであり、「できること」が多いからです。
本記事では、100件以上のOracle移行プロジェクトに携わってきた経験に基づき、PL/SQLのコードをPL/pgSQLへ移植する際の互換性、具体的な書き換えのポイント、そして現実的な移行戦略について、コード例を交えながら詳しく解説します。自動変換ツールの限界と、ベテランエンジニアがどこに注目してレビューを行うべきか、その勘所を明らかにします。
1. PL/SQLとPL/pgSQL:似て非なる二つの言語
まずは基本から。どちらもSQLを拡張した手続き型言語であり、BEGIN-ENDブロックで処理を記述するなど、一見するとよく似ています。しかし、そのアーキテクチャや思想には、移行の際に落とし穴となる大きな違いが存在します。
ブロック構造と変数
両者ともブロック構造を持ちますが、PL/pgSQLの関数は全体が文字列リテラルとして扱われるという大きな特徴があります。具体的には $$で関数の本体を括ります。
PL/SQLの例:
DECLARE
v_name VARCHAR2(50);
BEGIN
v_name := 'World';
DBMS_OUTPUT.PUT_LINE('Hello ' || v_name);
END;
/PL/pgSQLの例:
CREATE OR REPLACE FUNCTION hello_world() RETURNS VOID AS $$
DECLARE
v_name VARCHAR(50);
BEGIN
v_name := 'World';
RAISE NOTICE 'Hello %', v_name;
END;
$$ LANGUAGE plpgsql;PL/pgSQLでは、無名ブロックの DO 文を除けば、すべてのコードが関数・プロシージャ定義の中に含まれる必要があります。また、代入演算子は同じく := ですが、文字列連結に `||` ではなく format() 関数や `%` プレースホルダを使うことが推奨されます。
2. パッケージの壁:PL/pgSQLにはない概念をどう乗り越えるか
PL/SQLの最も強力な機能の一つが「パッケージ」です。関連するプロシージャ、関数、変数、カーソル、型定義などを一つの論理的な単位としてまとめることができます。これにより、カプセル化、コードの再利用性、そしてセッション単位での状態保持が可能になります。
残念ながら、PL/pgSQLにはパッケージの概念が存在しません。 これが移行における最大の障壁の一つです。
代替アプローチ
a) スキーマによるグループ化
最も一般的な代替策は、スキーマを使ってパッケージの役割を擬似的に再現する方法です。
-- パッケージの代わりにスキーマを作成
CREATE SCHEMA my_package;
-- スキーマ内に関数を作成
CREATE FUNCTION my_package.get_employee_name(p_emp_id INT) RETURNS VARCHAR AS $$
...
$$ LANGUAGE plpgsql;
CREATE FUNCTION my_package.calculate_bonus(p_emp_id INT) RETURNS NUMERIC AS $$
...
$$ LANGUAGE plpgsql;これにより、my_package.get_employee_name() のように呼び出すことができ、論理的なグループ化を実現できます。
b) パッケージ変数の代替
セッション内で状態を保持するパッケージ変数の代替としては、以下のような方法が考えられます。
設定テーブル: CREATE TABLE my_package_settings (key TEXT PRIMARY KEY, value TEXT); のようなテーブルを作成し、キーバリュー形式で値を保持する。
一時テーブル: CREATE TEMP TABLE ... を使い、セッション内でのみ有効なテーブルに変数を格納する。
current_setting(): PostgreSQLの SET コマンドと current_setting() 関数を使い、セッションレベルの変数を設定する。
3. データ型と組み込み関数の非互換マップ
移行作業では、データ型と関数の地道なマッピングが欠かせません。自動変換ツールもこの部分は得意ですが、微妙な挙動の違いを理解していないとバグの原因となります。
PostgreSQLもラージオブジェクトをサポートしますが、関数を経由するアクセスが必要になり使いづらいです。したがってCLOBはTEXTに、BLOBはBYTEAに移行します。
Oracleの関数との仕様差を埋めるPostgreSQLのライブラリ、orafceを用いると、Oracleと同等のNVL()関数、DECODE()関数などを利用できます。

4. エラーハンドリングの作法:EXCEPTION節の書き換え
エラーハンドリングの構文も似ていますが、エラー情報の取得方法が異なります。
PL/SQLの例:
BEGIN
...
EXCEPTION
WHEN NO_DATA_FOUND THEN
DBMS_OUTPUT.PUT_LINE('データが見つかりません。');
WHEN OTHERS THEN
DBMS_OUTPUT.PUT_LINE('エラーが発生しました: ' || SQLERRM);
END;PL/pgSQLの例:
BEGIN
...
EXCEPTION
WHEN NO_DATA_FOUND THEN
RAISE NOTICE 'データが見つかりません。';
WHEN OTHERS THEN
-- SQLSTATEとエラーメッセージを取得
RAISE NOTICE 'エラーが発生しました: %, %', SQLSTATE, SQLERRM;
END;PL/pgSQLでは、SQLSTATE(エラーコード)とSQLERRM(エラーメッセージ)が自動的に定義されます。より詳細な情報を取得したい場合は GET STACKED DIAGNOSTICS を使用します。
なお、PL/pgSQLではエラー処理にEXCEPTION節を用いると性能が劣化するとマニュアルにあります。
https://www.postgresql.jp/document/17/html/plpgsql-control-structures.html#PLPGSQL-ERROR-TRAPPING
EXCEPTION句を含んだブロックの実行に要する時間は、含まないブロックに比べてとても長くなります。 したがって、必要のない時にEXCEPTIONを使用してはいけません。
5.トランザクションの扱いの相違
そして、大変重要なことですが、トランザクションの扱いが両者で異なります。PL/pgSQLでは例外発生してEXCEPTION節に入ると自動的にロールバックされます。PL/SQLではユーザがトランザクションの扱いを記述する ため、この差を埋めるのがしばしば難しい移行となります。
シナリオ例:複数のUPDATE文の途中でエラーが発生した場合
PL/SQLでは、EXCEPTION節でエラーを補足し、最初のUPDATEだけをCOMMITして処理を続ける、といった制御が可能です。
-- PL/SQLの例
BEGIN
UPDATE table1 SET ...; -- 成功
UPDATE table2 SET ...; -- ここでエラー発生
EXCEPTION
WHEN OTHERS THEN
COMMIT; -- table1の更新は確定される
log_error('更新失敗');
END;しかし、PL/pgSQLでは、UPDATE table2でエラーが発生した時点でトランザクション全体がロールバック対象となるため、EXCEPTION節に処理が移ったときにはUPDATE table1の変更も既に無効になっています。
また、PL/pgSQLではプロシージャとDOによる無名ブロックのみコミットもしくはロールバックを発行することができます。関数ではトランザクション制御を記述できないので要注意です。
6. 自律トランザクションの代替策
PL/SQLでは PRAGMA AUTONOMOUS_TRANSACTION を使うことで、メインのトランザクションとは独立したトランザクションをプロシージャ内で実行できます。これは主に、メインのトランザクションの結果に関わらずエラーログを記録したい場合などに使われます。
PL/pgSQLにはこの機能は存在しません。代替策として最もよく使われるのが dblink拡張 です。
-- 拡張機能の有効化
CREATE EXTENSION IF NOT EXISTS dblink;
-- 自律トランザクションの代替関数
CREATE OR REPLACE FUNCTION log_error(p_message TEXT) RETURNS VOID AS $$
BEGIN
-- 自分自身に接続し、別トランザクションとしてINSERTを実行
PERFORM dblink_exec('dbname=' || current_database(),
'INSERT INTO error_logs (message, created_at) VALUES (' ||
quote_literal(p_message) || ', NOW());');
EXCEPTION
WHEN OTHERS THEN
RAISE WARNING 'dblinkによるログ書き込みに失敗しました: %', SQLERRM;
END;
$$ LANGUAGE plpgsql;この方法は強力ですが、コネクションを都度確立するためパフォーマンスへの影響や、接続情報の管理に注意が必要です。
7. 移行戦略:自動変換ツールとの賢い付き合い方
ora2pg のようなオープンソースツールは、PL/SQLからPL/pgSQLへの変換を支援してくれます。しかし、これを無条件に信用してはいけません。100%の自動変換は不可能であり、ツールの結果はあくまで「下書き」です。
自動変換ツールがサポートするのは単純置換が可能な容易な箇所に限っています。トランザクション周りの処理のような難易度の高い箇所には歯が立ちません。
現実的なアプローチ
ツールで初回変換: まずツールを実行し、変換の全体像と、手動で修正が必要な箇所の量を把握します。
重点レビュー: ツールは特に以下の変換を苦手とします。これらの箇所を重点的にレビューし、手動で修正します。
パッケージ: スキーマや設定テーブルを使って再設計する。
自律トランザクション: dblinkなどを使って再実装する。
動的SQL: EXECUTE ... USING ... の構文に正しく変換されているか確認する。
複雑なカーソルロジック: ループやフェッチのロジックが等価であるか検証する。
テストの徹底: 変換後のコードに対して、元のPL/SQLと同じ入力で同じ出力が得られるか、単体テストと結合テストを徹底的に行います。ロジックとトランザクション処理の等価性を担保することが最も重要です。
まとめ
PL/SQLからPL/pgSQLへの移行は、単なる構文の置き換え作業ではありません。それは、OracleとPostgreSQLの設計思想の違いを理解し、PostgreSQLの流儀に合わせてロジックを再構築する という、高度な設計作業です。
自動変換ツールはあくまで「気持ち程度」です。過度な依存は移行後に深刻なバグやパフォーマンス問題を引き起こします。本記事で紹介したような非互換ポイントを深く理解し、ツールが生成したコードを疑いの目でレビューし、適切な代替アプローチを選択することが、困難な移行プロジェクトを成功に導く唯一の道です。
Oracle移行のリスク・工数でお悩みの方、 まずは状況をお聞かせください。
👉 [無料相談はこちら]
https://forms.gle/mvPckpJCfG8vEmSx9