【要約】外部依存ゼロの静的解析 × AIエージェントで、PostgreSQLからTiDBへの移行レビューを自動化する [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
移行エンジニアがPostgreSQLからTiDBへデータベースを移行する際、SQLの互換性確認に多大な工数がかかる。既存のSQLがTiDBで動作するかを判断する作業が、大きな負担となっている。
- ・PostgreSQL固有の型（JSONB, UUID等）の挙動が不明。
- ・RETURNING句などの独自構文の代替手段を都度調べる必要がある。
- ・ドキュメント確認の繰り返しが、開発のコンテキストスイッチを引き起こす。
// Approach
開発者が移行作業を効率化するため、AIエージェントに静的解析スキルを実装した。AIが「解析」と「解説」を分担する二段構成を採用している。
- ・Python標準ライブラリのみを用いた、外部依存ゼロの静的解析スクリプトを実装。
- ・スクリプトの出力を、AIが解釈しやすい構造化Markdown形式に限定。
- ・AIエージェントがMarkdownを読み取り、自然言語で具体的な修正案を提示する仕組みを構築。
// Result
移行エンジニアは、SQLの互換性問題を即座に特定し、修正作業へ迅速に移行できる。AIによる親切な解説により、ドキュメント参照の手間が大幅に削減された。
- ・データ型、構文、DDLなど計31の互換性ルールをカバー。
- ・TiDB v8.1.0環境での動作実証済み。
- ・スラッシュコマンド一つで、エラー箇所と修正コードが提示される。
Senior Engineer Insight
> Linterの出力を直接ユーザーに返さず、AIが咀嚼するためのMarkdownを中間層に置いた設計が極めて賢明だ。これにより、機械的な正確性とAIの柔軟な解説を両立している。ただし、正規表現ベースの解析には限界がある。複数行にわたる関数定義や、テーブル定義を追跡した型推論は不可能だ。大規模な移行プロジェクトでは、AST（抽象構文木）を用いた厳密な解析ツールとの併用が不可欠だろう。