メインコンテンツへスキップ
見出し画像

Oracle PL/SQL→PostgreSQLのAI移行、実行して初めて分かった3つのエラーと自律型トランザクションの消失

    前回の記事

    では、Claude Code で Oracle のロギングフレームワーク log_set_oracle (MIT ライセンス) を PostgreSQL へ移行させ、その検証をどう設計したかという「判断の型」について書きました。今回はその中身を、実際のコードで見ていきます。読者の方も同じリポジトリで追体験できます。(検証は lib ディレクトリに限っています)

    https://github.com/BrenPatF/log_set_oracle

    1. 実行して初めて分かった3つのエラー

    Claude Code が最初に生成したコードは、そのままでは動きませんでした。psql -f install_log_set.sql を実行して初めて表面化したエラーが3件あります。いずれも、コードの流し見では気づきにくいものでした。

    一つ目は、関数の引数デフォルト値の構文誤りです。

    Oracle 原本(log_config.pks)ではこう書かれています。

    PROCEDURE Ins_Config(
                p_config_key                   VARCHAR2,
                p_config_type                  VARCHAR2 := NULL,
                p_default_yn                   VARCHAR2 := NULL,
                ...
    

    移行後のコードは、この := をそのまま持ち込んでいました。

    CREATE OR REPLACE FUNCTION log_set.config_ins_config(
                p_config_key                   varchar,
                p_config_type                  varchar := NULL,
                p_default_yn                   varchar := NULL,
                ...
    

    実行するとこうなります。

    psql:log_config.sql:223: ERROR:  syntax error at or near ":="
    

    := は PL/pgSQL 本体内の変数初期化(DECLARE 部)では正しい構文ですが、CREATE FUNCTION の引数リストでは DEFAULT (もしくは = )を使わなければなりません。同じ記号が、書く場所によって正しかったり間違っていたりする。人間でも見落としがちな箇所です。修正はシンプルで、引数デフォルトを DEFAULT に置換するだけでした。

    二つ目は、遅延生成されるテーブルに対する %ROWTYPE の誤用です。

    移行にあたり、Oracle のパッケージ変数(セッション状態)は PostgreSQL のセッション限定 TEMP TABLE に置き換えられました。その一つ log_set_open_logs の行を受け取る変数を、Claude Code はこう宣言していました。

    DECLARE
      l_open      log_set_open_logs%ROWTYPE;
      l_config    log_set.log_configs%ROWTYPE;
    BEGIN
    

    実行結果です。

    psql:log_set.sql:489: ERROR:  relation "log_set_open_logs" does not exist
    CONTEXT:  compilation of PL/pgSQL function "_flush_buf" near line 3
    

    ここが厄介なところです。%ROWTYPE は関数の実行時ではなく作成時に、対象テーブルの実在を要求します。ところが log_set_open_logs は、関数の中で CREATE TEMP TABLE IF NOT EXISTS によってセッションごとに遅延生成される設計です。関数を作成する時点では、まだ誰もそのセッションで一度も呼び出していないので、テーブルが存在しない。同じ理由で _add_line、put_line でも同様のエラーが出ています。

    対処は、%ROWTYPE をやめて RECORD 型にすることでした。RECORD はフィールドの解決を呼び出し時まで遅延させるため、関数作成時にテーブルが存在しなくても問題になりません。

    DECLARE
      l_open      RECORD;
      l_config    log_set.log_configs%ROWTYPE;
    BEGIN
    

    (log_set.log_configs は事前に恒久テーブルとして作成済みなので、こちらは %ROWTYPE のままで問題ありません。)

    三つ目は、複合型の2段フィールドアクセスの曖昧性です。個人的には、これが一番興味深いエラーでした。

    Oracle 原本では、レコード型のフィールドのそのまたフィールドに、p_construct_rec.header.put_lev_min のようにドットを重ねてアクセスできます。

    l_inps.header.put_lev_min      := Nvl(p_construct_rec.header.put_lev_min, 0);
    

    移行後のコードも、この書き方をそのまま持ち込んでいました。

    l_put_lev_min     integer := COALESCE(l_construct_rec.header.put_lev_min, 0);
    

    実行結果です。

    ERROR:  missing FROM-clause entry for table "header"
    LINE 1: COALESCE(l_construct_rec.header.put_lev_min, 0)
    

    PostgreSQL の一般の SQL 式パーサは、a.b.c という形を見ると「テーブル b のカラム c」と解釈しようとします。l_construct_rec.header.put_lev_min は「レコード l_construct_rec のフィールド header のそのまたフィールド put_lev_min」のつもりですが、パーサには「header というテーブルの put_lev_min カラム」に見えてしまう。エラーメッセージの「missing FROM-clause entry for table "header"」が、まさにこの誤解釈を示しています。

    対処は、最初の2つを括弧で囲むことでした。

    l_put_lev_min     integer := COALESCE((l_construct_rec.header).put_lev_min, 0);
    

    (レコード.フィールド).サブフィールド という形にすることで、パーサに複合型のフィールドアクセスであることを明示します。同様の書き換えが、この関数を含めて計6箇所必要でした。なお、代入先(左辺)としての l_rec.header.description := p_description; は PL/pgSQL の代入構文が特別扱いするため、この問題は起きません。読み取り側だけの制約です。

    この3件に共通するのは、構文としては「それらしく」見えるコードが、実際に流し込むまでエラーにならなかったということです。静的なコードレビューでは見抜きにくく、実行して初めて分かる。AI も例外ではありませんでした。

    2. 消えたトランザクション〜回避策はあったが、使われなかった

    3件のエラーは、直せば済む話でした。もう一つ、直して済む話ではない差分があります。自律型トランザクションの消失です。

    Oracle 原本の flush_Buf と Delete_Log は PRAGMA AUTONOMOUS_TRANSACTION で動いており、呼び出し元のトランザクションがロールバックしても、ログだけは独立してコミットされる設計でした。PostgreSQL には、この仕組みが標準にありません。

    Claude Code が書いた README には、回避策も記載されていました。dblink または postgres_fdw によるループバック接続を使えば、別のセッションとして独立にコミットさせることができます。しかし今回の移行版では、「依存関係を増やさないため」実装されていませんでした。

    この判断について、技術的に一言加えておきます。dblink と postgres_fdw はどちらも、実質的に「もう一つの接続」を張ってそこでコミットする仕組みです。独立したコミットが手に入る代わりに、接続のオーバーヘッド、2つの接続にまたがることによる整合性の隙間(ループバック側の書き込みが成功し、呼び出し元がロールバックしても、ループバック側は戻らない、という挙動)、そして接続プールの消費が新たに発生します。「依存関係を増やさないため実装しなかった」という判断は、単体のライブラリとして自己完結させるという意味では筋が通っていますが、それは「自律型トランザクションが必要ない」という判断ではなく、「今回は実装のコストを払わなかった」という判断です。この2つは違います。

    3. 実機で確かめる:ロールバックでログは本当に消えるか

    README の記述を鵜呑みにせず、実際に確かめました。実行した SQL です。

    -- raise_error should write to ERROR config log and then raise
    select log_set.raise_error('custom failure');
    select id, config_id from log_set.log_headers h join log_set.log_configs c on c.id=h.config_id where c.config_key='ERROR';
    select log_id, line_text, err_msg, line_type from log_set.log_lines where err_msg = 'custom failure';
    

    結果です。

    ERROR:  custom failure
    CONTEXT:  PL/pgSQL function log_set.raise_error(...) line 17 at RAISE
    ERROR:  column reference "id" is ambiguous
    LINE 1: select id, config_id from log_set.log_headers h join log_set...
    
     log_id | line_text | err_msg | line_type 
    --------+-----------+---------+-----------
    (0 rows)
    

    2文目のエラーは検証 SQL 自体の書き方の問題(h.id と書くべきところを id とだけ書いた)で、ライブラリの問題ではありません。本題は3文目です。raise_error の内部では、custom failure というログ行を ERROR コンフィグに書き込んだ直後に例外を送出しています。1文目でその書き込みが実行されたはずなのに、3文目で検索すると0件でした。

    つまり、書き込みは実行されたが、直後の例外送出によってその SQL 文全体(psql の自動コミットモードでは1文が1トランザクション)がロールバックされ、書き込んだログ行ごと消えていました。README に書かれていた「自律型トランザクション非対応」という挙動を、実機で再現・確認できたことになります。

    4. これは許容できる差分か〜コードにない情報

    ここまでで、自律型トランザクションの消失は「実在する差分である」ことが確定しました。しかし、この差分が許容できるかどうかは、システムの要求仕様の話です。

    たとえば、このログ機構が障害調査のための監査ログとして使われているなら、この差分は致命的です。障害が起きてロールバックした瞬間にこそ、原因究明のためのログが残っていてほしいのに、その時に限ってログが消える。これでは監査ログとしての役目を果たしません。

    一方、このログ機構がデバッグ用の一時的な出力として使われているなら、話は変わります。開発中に処理の流れを追うためのログであれば、ロールバックと運命を共にしても実害は小さいかもしれません。

    同じ技術的な差分でも、その重みは用途(つまり要求仕様)によって正反対になります。これは、コードをいくら読んでも出てこない情報です。前回の記事で「移行検証において定番の一問はない」と書いたのは、まさにこの点に関わります。この案件であれば、私が最初に聞くべきことは「このログは、ロールバックされた処理の原因究明に使われることがあるか」でしょう。次の案件では、まったく違う一問になるかもしれません。

    読者の現場で使われているログ機構は、障害調査のための監査ログでしょうか、それともデバッグ用の一時的な出力でしょうか?

    5. Oracle原本のバグと、確かめていないこと

    もう一つ、記録しておくべきことがあります。検証の過程で、Oracle 原本にもともと存在していたバグが見つかりました。

    Delete_Log の単一 log_id 指定分岐で、log_lines が log_headers への外部キーを持つ(ON DELETE CASCADE なし)にもかかわらず、log_headers のみを DELETE していました。行が存在するログを削除しようとすると、外部キー制約違反になります。PostgreSQL 版ではこれを、log_lines を先に削除するよう修正し、削除後に0件になることをテストで確認しています。

    ここで一つ、正直に書いておくべきことがあります。「これは Oracle 原本にも存在する欠陥で、Oracle でも ORA-02292 で失敗するはずだ」という記述が README にありますが、これは実際に Oracle 環境で再現して確認したものではなく推測です。Oracle の外部キー制約の挙動から見て妥当な推論だとは思いますが、実機で確認していない以上、検証済みの事実としては書けません。ここは未検証のまま、未検証と明記しておきます。

    6. まとめ

    3件のインストールエラーは、直せば済む話でした。しかし自律型トランザクションの消失は、直すかどうかの判断そのものが、コードの外側にある業務情報を必要とします。次回は、この差分を実際に埋めるプロンプトを Claude Code に投げてみようと思います。dblink・postgres_fdw による実装を、AI はどう組み立ててくるのか。そして、その解を私はどう検証するのか。

    次の記事

    もし、Oracle から PostgreSQL への移行を AI 活用で進めながら、生成されたコードの妥当性検証や、要求仕様に照らした許容範囲の見極めに不安を感じているなら、一度お話ししませんか。100件を超える Oracle→PostgreSQL 移行評価に携わってきた経験から、御社のプロジェクトに合わせた検証設計をご提案します。お問い合わせはこちらから。

    https://forms.gle/QnfBVFW6k4Cwmy6D9

     
     
    Oracle→PostgreSQL移行アセスメント100件超。数学修士の素養と30年の現場を持つ独立DBスペシャリスト。PostgreSQLの内部構造まで踏み込み、AIが出す変換・診断結果を「どこまで信じ、どこで疑うか」を判断する。3年後も破綻しない基盤設計を支援します。

    あなたへのおすすめ