このプロジェクトは、Oracle Database から Amazon Aurora PostgreSQL へのデータベース移行を支援するサンプル AI エージェントシステムです。
AWS CDK を使用して OracleXE on EC2 と Aurora PostgreSQL のデータベースを構築し、SCT では変換できない Database Object を対象に Strands Agents を活用してデータベース分析と移行作業を軽減します。
Note
このコンテンツは OracleDB と PostgreSQL を立て、この環境に閉じて AI エージェントが SQL を読み書きし、実行し、修正し、結果を残していくものです。 AI エージェントがシェルコマンドを実行したり、Database を操作する都合上、本番環境でのご利用は絶対におやめください。あくまで、ここでコードを作成・テストするだけにとどめてください。また AI エージェントを動かす環境も EC2 等の使い捨てできる隔離環境を必ず用意し、そこから実行してください。
- Oracle Database: EC2 インスタンス上の Oracle XE 21c
- PostgreSQL: Amazon Aurora PostgreSQL Serverless v2
- AI Agent: AI Agent w/Strands Agents によるデータベース分析・移行支援
- Infrastructure: AWS CDK (TypeScript)による Infrastructure as Code
- Python 3.12 以上
- Node.js 18 以上
- AWS CLI v2
- AWS CDK v2
- uv (Python package manager)
- AWS アカウントとプロファイル設定
- 適切な IAM 権限（EC2, RDS, Secrets Manager, S3, SSM 等）
- デフォルトリージョン: us-east-1
Workshop 環境では、以下の手順を実行して CDK や uv をインストールしてください。
# CDK のインストール
npm install -g aws-cdk
# uv のインストール
pip install uvgit clone https://github.com/aws-samples/sample-sql-converter-agent-workshop.git
cd sample-sql-converter-agent-workshop
# CDK依存関係のインストール
cd cdk
npm install
cdk bootstrap
cd ..cdk/dmp/ ディレクトリに以下の RPM ファイルをインターネットからダウンロードして配置してください：
oracle-database-xe-21c-1.0-1.ol8.x86_64.rpm- Oracle XE 21c 本体oracle-database-preinstall-21c-1.0-1.el8.x86_64.rpm- Oracle 前提パッケージ
e.g.
mkdir -p cdk/dmp
cd cdk/dmp
wget https://download.oracle.com/otn-pub/otn_software/db-express/oracle-database-xe-21c-1.0-1.ol8.x86_64.rpm
wget https://yum.oracle.com/repo/OracleLinux/OL8/appstream/x86_64/getPackage/oracle-database-preinstall-21c-1.0-1.el8.x86_64.rpm
cd ../../ルートディレクトリに移動した上で、以下コマンドを実行してください。
# デプロイスクリプトの実行
./deploy.shこのスクリプトは以下の処理を自動実行します：
- AWS CDK によるインフラストラクチャのデプロイ
- EC2 キーペアの取得と SSH 設定
- Oracle XE の自動インストール
過去にDMSを使用したことがある場合、DMSの利用を開始するために必要なリソース作成の操作が重複することで、以下のようなエラーが出る場合があります。
Resource handler returned message: "Service role name AWSServiceRoleForDMSServerless has been taken in this ac
count, please try a different suffix.
このエラーが出た場合は、 cdk/bin/cdk.ts において、initializeDmsSc = false と設定して再度デプロイスクリプトを実行してください。
cdk/bin/cdk.ts
new SqlConverterAgentStack(app, 'SqlConverterAgentStack', {
initializeDmsSc: false, // ここを false に変更
env: {
account: process.env.CDK_DEFAULT_ACCOUNT,
region: process.env.CDK_DEFAULT_REGION,
},
});Oracle Instance に接続します。
cdk/output.json に記載されている OracleInstanceId の値をコピーし、 ssh-config の <instance id> の箇所に貼り付けてください。
ssh-config
Host oracle
HostName i-xxxxxxxxxxxxxxxxx
User ec2-user
IdentityFile ./cdk/oracle-xe-key.pem
ProxyCommand aws ec2-instance-connect open-tunnel --instance-id %h --max-tunnel-duration 3600
LocalForward 11521 localhost:1521
ローカルやEC2等、ワークショップ以外の環境で設定する場合は、./cdk/oracle-xe-key.pem を ~/.ssh/ にコピーした上で(e.g.chmod 400 ./cdk/oracle-xe-key.pem && sudo cp ./cdk/oracle-xe-key.pem ~/.ssh/)、~/.ssh/config に以下の設定を追加してください。
~/.ssh/config
Host oracle
HostName i-xxxxxxxxxxxxxxxxx
User ec2-user
IdentityFile ~/.ssh/oracle-xe-key.pem
ProxyCommand aws ec2-instance-connect open-tunnel --instance-id %h --max-tunnel-duration 3600
LocalForward 11521 localhost:1521
これにより、ssh oracle を実行すれば、AWS の認証情報を用いて EC2 Instance Connect Endpoint を経由して EC2 インスタンスに ssh で接続できるようになります。
また、ssh で接続されている間は、Port Forwarding でローカル環境の 11521 番ポートが、EC2 インスタンスの 1521 番ポートに Forward されるようになります。
別タブで新しいターミナルを開き、ssh -F ssh-config oracle を実行して接続できることを確認してください。
デプロイ完了後、以下のコマンドで接続テストを実行できます。 データベースにクエリを投げられるようになるまで、少し時間がかかる場合があるので、エラーが発生した場合はリトライしてみてください。
# Oracle Database接続テスト
uv run ora_connect_test.py
# PostgreSQL接続テスト
uv run pg_connect_test.py以下の手順に従って、データベースオブジェクトをアップロードしてください。
./import-schema/dumpfileに{name}_METADATAONLY.DMPをアップロードしてください。import-schemaフォルダ配下の各シェルスクリプトについて、コメントの指示に従い、スキーマ名でループしている箇所に、アップロードしたファイルのスキーマ名を列挙してください。import-schemaフォルダ配下のシェルスクリプトを番号順に実行してください。
chmod +x import-schema/1pre.sh
./import-schema/1pre.sh
chmod +x import-schema/2load.sh
./import-schema/2load.sh2load.sh で以下のエラーが出る場合は、Oracle on EC2 インスタンスに oracle ユーザーでログインし、パスが一致するようにディレクトリを作成し、ダンプファイルを移動してください。
ORA-31640: unable to open dump file "/home/oracle/dumpfile/3E0A3xxxxxE003yyyyyyyy0C/TESTUSER_METADATAONLY.DMP" for read
ログイン手順
ssh -F ssh-config oracle
sudo su - oraclecd agent
# 使い方 1 ）チャットで指示する場合
uv run main.py
# 使い方 2 ) DB Object を指定する場合
# DB_ONJECT_TYPE[space]SCHEMA_NAME.OBJECT_NAME で指定してください
uv run main.py --prompt "PROCEDURE SCHEMA_SAMPLE.SCT_0001_CALCULATE_TIME_DIFFERENCE"
# 使い方 3 ) まとめて実行する場合
./run.sh
コードの行数が長い場合や複雑なプロシージャの場合に、変換順序の調整やコードを分割してから変換することが有効であるため、その実行方法をみていきます。 ポート11521が既に使用されているといったエラーが発生する場合、別ウィンドウでの実施中のSSHポート転送を終了してください
cd agent
# OracleのDDLをまとめて取得
./getDDL.sh object_list.ini
#並び替え
uv run main.py --system-prompt sortObject.txt
(起動後に以下を貼り付けてください。)
./result
prompts/sortObject.txtに従って処理を実行してください。
# 変換実行
./run.sh --system-prompt custom_prompt.txt --file object_list_sorted.ini
サンプルとしてOracleデータベースを使用した従業員情報の管理（登録、更新、削除、検索）を行うSpring + MyBatisアプリケーションの基盤となるスクリプト群を変換します。
以下に配置されたサンプルアプリケーションの内容をチェックしてください。
cd ../application/cd ../agent
# アプリケーションの変換
# 例) uv run main.py --prompt "<ソースの配置場所> <アプリ名> <テスト名>" --system-prompt "system_prompt_app.txt"
uv run main.py --prompt "../application/employee-mgmt/application employee-mgmt test01" --system-prompt "system_prompt_app.txt"
セットアップ方法（認証設定から「CLI」タブを選択） https://catalog.workshops.aws/qwords/ja-JP/10-start-workshop/16-builder-id
### Oracle Database への接続方法
# Oracle XE on EC2 インスタンスへの接続
cd sample-sql-converter-agent-workshop/
ssh -F ssh-config oracle
# Oracle ユーザーに遷移
sudo su - oracle
# Oracle Database の SYSおよびSYSTEMスキーマのパスワードを取得
SECRET_JSON=$(aws secretsmanager get-secret-value --secret-id oracle-credentials --region us-east-1 --query SecretString --output text)
DB_PASSWORD=$(echo "$SECRET_JSON" | jq -r '.password')
# Oracle Database に接続
sqlplus sys/${DB_PASSWORD}@localhost/XEPDB1 as sysdba
sqlplus system/${DB_PASSWORD}@localhost/XEPDB1