翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# DMS Schema Conversion の使用
DMS Schema Conversion は、既存のデータベーススキーマとほとんどのデータベースコードオブジェクトをターゲットデータベースと互換性のある形式に変換します。
DMS Schema Conversion を使用すると、オンライントランザクション処理 (OLTP) データベーススキーマを Amazon RDS for MySQL または RDS for PostgreSQL に変換するプロセスの多くを自動化します。ソースデータベースエンジンとターゲットデータベースエンジンにはさまざまな機能があり、DMS Schema Conversion は可能な限り同等のスキーマの作成を試みます。直接変換できないデータベースオブジェクトの場合、DMS Schema Conversion は実行できるアクションのリストを提供します。
データベーススキーマを変換するには、次のプロセスを使用します。
+ データベーススキーマを変換する前に、変換中にデータベースオブジェクト名を変更する変換ルールを設定する。
+ データベース移行評価レポートを作成して、移行の複雑さを推定する。このレポートは、DMS Schema Conversion が自動的に変換できないスキーマ要素に関する詳細を提供する。
+ ソースデータベースストレージとコードオブジェクトを変換する。DMS Schema Conversion が変換したデータベースオブジェクトのローカルバージョンを作成する。このように変換したオブジェクトには、移行プロジェクトでアクセスできる。
+ 変換済みのコードを SQL ファイルに保存して、変換アクション項目を確認、編集、または対処する。必要に応じて、変換したコードをターゲットデータベースに直接適用します。
**Topics**
+ [DMS Schema Conversion での変換ルールの設定](schema-conversion-transformation-rules.md)
+ [DMS Schema Conversion でのデータベーススキーマの変換: step-by-stepガイド](schema-conversion-convert.md)
+ [生成 AI を使用したデータベースオブジェクトの変換](schema-conversion-convert.databaseobjects.md)
+ [移行プロジェクトのスキーマ変換設定の指定](schema-conversion-settings.md)
+ [DMS Schema Conversion でのデータベーススキーマの更新](schema-conversion-refresh.md)
+ [DMS Schema Conversion での変換したコードの保存と適用](schema-conversion-save-apply.md)
+ [Java アプリケーションの埋め込み SQL の変換](schema-conversion-embedded-sql.md)
# DMS Schema Conversion での変換ルールの設定
DMS Schema Conversion を使用してデータベーススキーマを変換する前に、変換ルールを設定できます。**変換ルールを使用すると、オブジェクト名の小文字または大文字への変更、プレフィックスやサフィックスの追加または削除、オブジェクト名の変更ができます。例えば、`test_TABLE_NAME` という名前のソーススキーマにテーブルがあるとします。ターゲットスキーマ内にある プレフィックス `test_` をプレフィックス `demo_` に変更するルールを設定できます。
変換ルールを作成して、次のとおりのタスクを実行できます。
+ プレフィックスの追加、削除、または置換
+ サフィックスの追加、削除、または置換
+ 列のデータ型の変更
+ オブジェクト名の小文字または大文字への変更
+ オブジェクトの名前変更
次のオブジェクトの変換ルールを作成できます。
+ Schema
+ [テーブル]
+ 列
## 変換ルールの作成
移行プロジェクトの一環として、DMS Schema Conversion は変換ルールを保存します。変換ルールは、移行プロジェクトの作成時に設定することも、後で編集することもできます。
プロジェクトには複数の変換ルールを追加できます。DMS Schema Conversion は変換中に、変換ルールが追加された順番通りにルールを適用します。
**変換ルールを作成するには**
1. **[移行プロジェクトの作成]** ページで、**[変換ルールの追加]** をクリックします。詳細については、「[ 移行プロジェクトの作成](migration-projects-create.md)」を参照してください。
1. **[ルールターゲット]** では、このルールを適用するデータベースオブジェクトのタイプを選択します。
1. **[ソーススキーマ]** では、**[スキーマの入力]** を選択します。次に、このルールを適用するソーススキーマ、テーブル、列の名前を入力します。正確な名前を入力して特定のオブジェクトを選択するか、パターンを入力して複数のオブジェクトを選択できます。パーセント (%) をワイルドカードとして使用すると、データベースオブジェクト名に含まれる任意の数の記号を置き換えることができます。
1. **[アクション]** では、実行するタスクを選択します。
1. ルールタイプに応じて、追加の値を 1 つまたは 2 つ入力します。例えば、オブジェクトの名前を変更するには、オブジェクトの新しい名前を入力します。プレフィックスを置換するには、現在のプレフィックスおよび置換後のプレフィックスを入力します。
1. **[変換ルールの追加]** をクリックすると、別の変換ルールを追加できます。
ルールの追加が完了したら、**[移行プロジェクトを作成]** をクリックします。
既存の変換ルールを複製するには、**[複製]** を選択します。既存の変換ルールを編集するには、リストからルールを選択します。既存の変換ルールを削除するには、**[削除]** を選択します。
## 変換ルールの編集
移行プロジェクトでは、新しい変換ルールの追加、既存の変換ルールの削除、または編集ができます。DMS Schema Conversion は、スキーマ変換の開始時に変換ルールを適用するため、ルールを編集した後は必ずスキーマ変換を閉じてから再起動します。
**変換ルールを編集するには**
1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/dms/v2/](https://console.aws.amazon.com/dms/v2/) で AWS DMS コンソールを開きます。
1. **[移行プロジェクト]** を選択して、編集する移行プロジェクトを選択します。
1. **[スキーマ変換]** を選択して、**[スキーマ変換を閉じる]** をクリックします。
1. がスキーマ変換 AWS DMS を閉じたら、**変更**を選択して移行プロジェクト設定を編集します。
1. **[変換ルール]** で、次のいずれかのアクションを選択します。
+ 既存の変換ルールを複製して、リストの最後に追加するには、**[複製]** を選択する。
+ 既存の変換ルールを削除するには、**[削除]** を選択する。
+ 編集するには、既存の変換ルールを選択する。
1. ルールの編集を完了した後、**[変更を保存]** を選択します。
1. **[移行プロジェクト]** ページのリストでプロジェクトを選択します。**[スキーマ変換]** を選択して、**[スキーマ変換を起動]** をクリックします。
# DMS Schema Conversion でのデータベーススキーマの変換: step-by-stepガイド
移行プロジェクトを作成して、ソースデータベースとターゲットデータベースに接続した後、ソースデータベースオブジェクトをターゲットデータベースと互換性のある形式に変換できます。DMS Schema Conversion は、ソースデータベースのスキーマを左側のパネルにツリービュー形式で表示します。
**データベースツリーの各ノードは遅延ロードされます。ユーザーがツリービューでノードを選択した時点で、DMS Schema Conversion はソースデータベースからスキーマ情報をリクエストします。スキーマ情報のロード速度を上げるには、スキーマを選択して、**[アクション]** メニューから **[メタデータをロード]** を選択します。DMS Schema Conversion は次に、データベースのメタデータを読み取り、その情報を Amazon S3 バケットに保存します。これで、データベースオブジェクトの閲覧がより迅速になります。
変換は、データベーススキーマ全体で行うことも、ソースデータベースから任意のスキーマ項目を選択して行うこともできます。選択したスキーマ項目が親項目に依存する場合、DMS Schema Conversion はその親項目のスキーマも生成します。例えば、変換するテーブルを選択すると、DMS Schema Conversion は変換したテーブルと、そのテーブルが格納されているデータベーススキーマを作成します。
## データベースオブジェクトの変換
DMS Schema Conversion を使用すると、データベーススキーマ全体を変換することも、個別のデータベーススキーマオブジェクトを変換することもできます。
**データベーススキーマ全体を変換するには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/dms/v2/](https://console.aws.amazon.com/dms/v2/) で AWS DMS コンソールを開きます。
1. **[移行プロジェクト]** を選択します。**[移行プロジェクト]** ページが開きます。
1. [移行プロジェクト]、**[スキーマ変換]** の順に選択します。
1. **[スキーマ変換を起動]** をクリックします。**[スキーマ変換]** ページが開きます。
1. ソースデータベースペインで、スキーマ名のチェックボックスをオンにします。
1. 移行プロジェクトの左側のペインで、このスキーマを選択します。DMS Schema Conversion はスキーマ名を青色で強調表示して、**[アクション]** メニューをアクティブ化します。
1. **[アクション]** で **[変換]** を選択します。[変換] ダイアログボックスが表示されます。
1. ダイアログボックスの **[変換]** をクリックして、この選択を確定します。
**ソースデータベースオブジェクトを変換するには**
1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/dms/v2/](https://console.aws.amazon.com/dms/v2/) で AWS DMS コンソールを開きます。
1. **[移行プロジェクト]** を選択します。**[移行プロジェクト]** ページが開きます。
1. [移行プロジェクト]、**[スキーマ変換]** の順に選択します。
1. **[スキーマ変換を起動]** をクリックします。**[スキーマ変換]** ページが開きます。
1. ソースデータベースペインで、ソースデータベースオブジェクトを選択します。
1. 変換するオブジェクトのチェックボックスをすべてオンにした後、左側のパネルで選択したすべてのオブジェクトの親ノードを選択します。
DMS Schema Conversion は親ノードを青色で強調表示して、**[アクション]** メニューをアクティブ化します。
1. **[アクション]** で **[変換]** を選択します。[変換] ダイアログボックスが表示されます。
1. ダイアログボックスの **[変換]** をクリックして、この選択を確定します。
例えば、10 のテーブルのうち 2 つを変換するには、変換する 2 つのテーブルのチェックボックスをオンにします。**[アクション]** メニューが非アクティブであることに注意します。**[テーブル]** ノードを選択すると、DMS Schema Conversion はテーブル名を青色で強調表示して、**[アクション]** メニューをアクティブ化します。その後、このメニューから **[変換]** を選択できます。
2 つのテーブルと 3 つのプロシージャを変換する場合も同様に、オブジェクト名のチェックボックスをオンにします。次に、スキーマノードを選択して **[アクション]** メニューをアクティブ化し、**[スキーマを変換]** を選択します。
## 変換された SQL コードの編集と保存
**[スキーマ変換]** ページでは、データベースオブジェクト内の変換された SQL コードを編集できます。以下の手順を使用して、変換された SQL コードを編集、変更適用、保存します。
**変換された SQL コードを編集、変更適用、保存するには**
1. **[スキーマ変換]** ページで、**[ソースデータプロバイダー]** ペインのツリービューを開き、コードオブジェクトを表示します。
![\[スキーマ変換: ソースデータプロバイダーのツリービュー\]](http://docs.aws.amazon.com/ja_jp/dms/latest/userguide/images/datarep-sc-editsql-1.png)
1. **[ソースデータプロバイダー]** ペインで、**[アクション]**、**[変換]** を選択します。アクションを確認します。
1. 変換の完了後、変換した SQL を表示するには、必要に応じて中央ペインを展開します。変換した SQL を編集するには、**[ターゲット SQL]** ペインで編集アイコンを選択します。
![\[スキーマ変換: ターゲット SQL を編集する\]](http://docs.aws.amazon.com/ja_jp/dms/latest/userguide/images/datarep-sc-editsql-2.png)
1. ターゲット SQL を編集したら、ページの上部にあるチェックアイコンを選択して変更を確認します。アクションを確認します。
1. **[ターゲットデータプロバイダー]** ペインで、**[アクション]**、**[変更を適用]** を選択します。アクションを確認します。
1. DMS は、編集した手順をターゲットデータストアに書き込みます。
## 変換したデータベースオブジェクトの確認
ソースデータベースオブジェクトを変換した後、プロジェクトの左側のペインでオブジェクトを選択できます。これで、そのオブジェクトのソースと変換済みのコードを確認できます。DMS Schema Conversion は、左側のペインで選択したオブジェクトの変換済みのコードを自動的にロードします。選択したオブジェクトのプロパティやパラメータも確認できます。
移行プロジェクトの一環として、DMS Schema Conversion は変換したコードを自動的に保存します。このようなコード変更のターゲットデータベースへの適用は行いません。変換したコードをターゲットデータベースに適用する方法の詳細については、「[変換したコードの適用](schema-conversion-save-apply.md#schema-conversion-apply)」を参照してください。変換したコードを移行プロジェクトから削除するには、右側のペインでターゲットスキーマを選択して、[**アクション**] から [**データベースから更新**] を選択します。
ソースデータベースオブジェクトを変換すると、中央下部のペインに変換の概要とアクション項目が表示されます。評価レポートを作成した場合も同じ情報を確認できます。評価レポートは、DMS Schema Conversion が変換できないスキーマ項目を特定して解決するうえで役立ちます。評価レポートの概要と変更の概要アクション項目のリストは CSV ファイルに保存できます。詳細については、「[データベース移行評価レポート](assessment-reports.md)」を参照してください。
# 生成 AI を使用したデータベースオブジェクトの変換
生成 AI 機能を備えた DMS Schema Conversion は、一般的に複雑な手動変換を必要とする、事前に変換されていないコードオブジェクトの変換に役立つ推奨事項を提供することで、データベース移行プロセスを合理化します。この機能は、Oracle から PostgreSQL/Aurora PostgreSQL、SQL Server から PostgreSQL/Aurora PostgreSQL、SAP ASE (Sybase ASE) から PostgreSQL/Aurora PostgreSQL への変換で使用できます。データベーススキーマ全体、または個々のデータベーススキーマオブジェクトを変換できます。
**警告**
DMS Schema Conversion の生成 AI 機能は、クロスリージョン推論を使用します。詳細については、「[DMS Schema Conversion でのクロスリージョン推論](CHAP_Security.DataProtection.CrossRegionInference.md#CHAP_Security.DataProtection.CrossRegionInference.SchemaConversion)」を参照してください。
生成 AI を使用してソースデータベースオブジェクトを変換するには、「[データベースオブジェクトの変換](schema-conversion-convert.md#schema-conversion-convert-steps)」のステップ 1 から 6 に従って、次の 2 つのうちいずれかの方法を選択します。
+ 方法 1: **[アクション]** メニューから **[変換]** を選択します。表示される変換ダイアログボックスで、**[Convert schema with Generative AI]** を有効にし、**[変換]** をクリックします。
+ 方法 2: 右上隅にある ****[Convert schema with Generative AI]**** をクリックします。変換ダイアログボックスで、このオプションが有効になっていることを確認し、**[変換]**をクリックします。
DMS Schema Conversion コンソールでこの設定を手動で随時調整するには:
+ **[設定]** タブに移動します。
+ **[コンバージョン設定] セクション**で、**[生成 AI]** オプションを有効にして生成 AI の使用を承認します。
**注記**
サポートされているリージョン:
アジアパシフィック (東京) (ap-northeast-1)
アジアパシフィック (大阪) (ap-northeast-3)
アジアパシフィック (シドニー) (ap-southeast-2)
カナダ (中部) (ca-central-1)
ヨーロッパ (フランクフルト) (eu-central-1)
欧州 (ストックホルム) (eu-north-1)
欧州 (アイルランド) (eu-west-1)
ヨーロッパ (ロンドン) (eu-west-2)
欧州 (パリ) (eu-west-3)
米国東部 (バージニア北部) (us-east-1)
米国東部 (オハイオ) (us-east-2)
米国西部 (オレゴン) (us-west-2)
**注記**
サポートされている変換パス:
Oracle から Amazon RDS for PostgreSQL
Oracle から Amazon Aurora PostgreSQL
Microsoft SQL Server から Amazon RDS for PostgreSQL
Microsoft SQL Server から Amazon Aurora PostgreSQL
SAP ASE (Sybase ASE) から Amazon RDS for PostgreSQL へ
SAP ASE (Sybase ASE) から Amazon Aurora PostgreSQL へ
IBM Db2 for Linux、UNIX、Windows (LUW) から Amazon RDS for PostgreSQL
IBM Db2 for Linux、UNIX、Windows (LUW) から Amazon Aurora PostgreSQL
IBM Db2 for z/OS から Amazon RDS for PostgreSQL
IBM Db2 for z/OS から Amazon Aurora PostgreSQL
## 生成 AI 変換の範囲
生成 AI 支援型のスキーマ変換は、指定されたアクション項目を持つ特定の SQL 要素のみを対象とします。その他すべての SQL 要素は、デフォルトのルールベースのアプローチを使用して変換されます。拡張された生成 AI 変換の範囲に含まれる SQL 要素は次のとおりです。
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/dms/latest/userguide/schema-conversion-convert.databaseobjects.html)
### 制限事項
生成 AI 機能を使用したデータベースオブジェクトの変換には、次の制限があります。
+ 生成 AI 変換をサポートするデータベースエンドポイントは、 AWS コンソールに表示されません。これらを表示するには、評価レポートを PDF ファイルまたは CSV ファイルとしてエクスポートする必要があります。
+ 生成 AI 支援型のスキーマ変換は、確率システムであり、すべての変換で 100% の精度を達成できない場合があります。また、一定期間の中で、同じ SQL ステートメントに対して異なる結果を生成することもあります。そのため、すべての変換出力を確認して検証する必要があります。
+ 生成 AI 変換は、以下ではサポートされていません。
+ テーブルの DEFAULT 制約
+ 関数またはプロシージャパラメータの DEFAULT 値
+ テーブル内の列の計算
+ TRIGGER
+ COLUMN DATA TYPE
+ 動的 SQL
+ INDEX
+ CONSTRAINT
+ ソースステートメントが複数のアクション項目で変換され、少なくとも 1 つのアクション項目が生成 AI を使用して処理される場合、すべてのアクション項目は Oracle のターゲットの 1 つのアクション項目 5444 と Microsoft SQL Server の 7744 に置き換えられます。アクション項目 9997 は、生成 AI を使用して処理された後に保存される例外です。
**警告**
生成 AI を使用した変換は、基本的な変換よりも時間がかかります。
すべての AWS アカウントには、生成 AI を使用して変換できる SQL ステートメントの数を制限する 1 分あたりのクォータがあります。この制限を超えるステートメントはキューに入れられ、数分後に処理されます。クォータは次のとおりです。
****
| リージョン | 1 分あたりの AWS アカウントあたりの SQL ステートメント |
| --- | --- |
| アジアパシフィック (東京) (ap-northeast-1) アジアパシフィック (大阪) (ap-northeast-3) アジアパシフィック (シドニー) (ap-southeast-2) カナダ (中部) (ca-central-1) 欧州 (ストックホルム) (eu-north-1) 欧州 (アイルランド) (eu-west-1) ヨーロッパ (ロンドン) (eu-west-2) 欧州 (パリ) (eu-west-3) 米国東部 (オハイオ) (us-east-2) | 最大 24 個のステートメント |
| ヨーロッパ (フランクフルト) (eu-central-1) 米国東部 (バージニア北部) (us-east-1) 米国西部 (オレゴン) (us-west-2) | 最大 40 個のステートメント |
# 移行プロジェクトのスキーマ変換設定の指定
移行プロジェクトを作成した後、DMS Schema Conversion でコンバージョン設定を指定できます。スキーマ変換設定を設定すると、変換済みのコードのパフォーマンスが向上します。
**コンバージョン設定を編集するには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/dms/v2/](https://console.aws.amazon.com/dms/v2/) で AWS DMS コンソールを開きます。
1. **[移行プロジェクト]** を選択します。**[移行プロジェクト]** ページが開きます。
1. 移行プロジェクトを選択します。**[スキーマ変換]** 選択して、**[スキーマ変換を起動]** をクリックします。
1. **[設定]** を選択します。**[設定]** ページが開きます。
1. **[変換]** セクションで、設定を変更します。
1. **[適用]**、**[スキーマ変換]** の順に選択します。
すべての変換ペアについて、アクション項目を含め、変換済みのコードのコメント数を制限できます。変換済みのコード内のコメント数を制限するには、移行プロジェクトのコンバージョン設定を開きます。
**[Comments in converted SQL code]** で、アクション項目の重大度レベルを選択します。DMS Schema Conversion は、選択した重大度以上のアクション項目について、変換済みのコードにコメントを追加します。例えば、変換済みのコード内のコメント数を最小限に抑えるには、**[エラーのみ]** を選択します。
変換済みのコードにすべてのアクション項目のコメントを含めるには、**[すべてのメッセージ]** を選択します。
その他のコンバージョン設定は、ソースデータベースとターゲットデータベースのペアにより異なります。
**Topics**
+ [Oracle から MySQL への変換設定を理解する](schema-conversion-oracle-mysql.md)
+ [Oracle から PostgreSQL への変換設定を理解する](schema-conversion-oracle-postgresql.md)
+ [SQL Server から MySQL への変換設定を理解する](schema-conversion-sql-server-mysql.md)
+ [SQL Server から PostgreSQL への変換設定を理解する](schema-conversion-sql-server-postgresql.md)
+ [PostgreSQL から MySQL への変換設定を理解する](schema-conversion-postgresql-mysql.md)
+ [IBM Db2 for LUW から Amazon RDS for PostgreSQL への変換設定について](schema-conversion-db2-luw-postgresql.md)
+ [IBM Db2 for z/OS から Amazon RDS for Db2 への変換設定について](schema-conversion-db2-zos-db2.md)
+ [IBM Db2 for z/OS から Amazon RDS for PostgreSQL への変換設定について](schema-conversion-db2-zos-postgresql.md)
+ [SAP ASE (Sybase ASE) から PostgreSQL への変換設定について](schema-conversion--sybase-ASE.md)
# Oracle から MySQL への変換設定を理解する
DMS Schema Conversion の Oracle から MySQL へのコンバージョン設定は、次のとおりです。
+ ソースの Oracle データベースでは、`ROWID` 疑似列を使用できるが、MySQL は同様の機能をサポートしていない。DMS Schema Conversion は、変換したコードで `ROWID` 疑似列をエミュレートできる。このためには、**[行 ID を生成]** オプションをオンにする。
ソースの Oracle コードが `ROWID` 疑似列を使用していない場合は、**[行 ID を生成]** オプションをオフにする。この場合、変換したコードの処理が迅速化する。
+ ソースの Oracle のコードには、MySQL ではサポートされないパラメータを使用する `TO_CHAR` 関数、`TO_DATE` 関数、`TO_NUMBER` 関数が使用されている場合がある。デフォルトでは、DMS Schema Conversion は変換したコード内のこのようなパラメータの使用をエミュレートする。
ソースの Oracle コードに MySQL でサポートされないパラメータがない場合は、MySQL のネイティブの `TO_CHAR` 関数、`TO_DATE` 関数、`TO_NUMBER` 関数を使用できる。この場合、変換したコードの処理が迅速化する。これには、次の値を選択する。
+ **Use a native MySQL TO\$1CHAR function**
+ **Use a native MySQL TO\$1DATE function**
+ **Use a native MySQL TO\$1NUMBER function**
+ データベースとアプリケーションは別々のタイムゾーンで実行できる。デフォルトでは、DMS Schema Conversion は変換したコードのタイムゾーンをエミュレートする。ただし、データベースとアプリケーションが同じタイムゾーンを使用している場合は、このエミュレーションは必要ない。この場合、**[Improve the performance of the converted code where the database and applications use the same time zone]** を選択する。
# Oracle から PostgreSQL への変換設定を理解する
DMS Schema Conversion の Oracle から PostgreSQL へのコンバージョン設定は、次のとおりです。
+ 生成 AI を使用して該当するデータベースオブジェクトを変換するには、**[生成 AI]** 設定を有効にする。生成 AI を使用して正常に変換されたオブジェクトは、変換でデータ内のパターンに基づいて予測を生成する機械学習モデルが使用されることを示す**アクション項目 5444** で明確に識別できる。詳細については、「[生成 AI を使用したデータベースオブジェクトの変換](schema-conversion-convert.databaseobjects.md)」を参照してください。
+ 最新バージョンだけでなく、サポートされているさまざまなバージョンのターゲットデータベースのスキーマを変換できる。バージョンを指定するには、**[ターゲットエンジンバージョン]** 設定を使用する。使用可能な変換オプションは、選択したエンジンバージョンによって異なる。現在、PostgreSQL バージョン 14 および 15 がサポートされている (設定は同じ)。この設定で指定されたバージョンとは異なるターゲットエンジンバージョンをスキーマ変換中に使用すると、ターゲットへの適用オペレーションの実行時に互換性の問題やエラーが発生する可能性がある。
+ AWS DMS は、Oracle マテリアライズドビューを PostgreSQL のテーブルまたはマテリアライズドビューに変換できます。**[マテリアライズドビュー]** で、ソースのマテリアライズドビューの変換方法を選択する。
+ ソースの Oracle データベースでは、`ROWID` 疑似列を使用できるが、PostgreSQL は同様の機能をサポートしていない。DMS Schema Conversion は、`bigint` または `character varying` データ型を使用して、変換したコードで `ROWID` 疑似列をエミュレートできる。このためには、**[行 ID]** で **[Use the bigint data type to emulate the ROWID pseudocolumn]** または **[Use the character varying data type to emulate the ROWID pseudocolumn]** を選択する。
+ NUMBER データ型を最適な数値データ型に変換するには、精度とスケールに応じて、NUMBER データ型の列に [Use the optimized data type mapping] を選択する。
+ ソースの Oracle コードが `ROWID` 疑似列を使用していない場合は、**[Don't generate]** を選択する。この場合、変換したコードの処理が迅速化する。
+ ソースの Oracle のコードには、PostgreSQL ではサポートされないパラメータを使用する `TO_CHAR` 関数、`TO_DATE` 関数、`TO_NUMBER` 関数が使用されている場合がある。デフォルトでは、DMS Schema Conversion は変換したコード内のこのようなパラメータの使用をエミュレートする。
ソースの Oracle コードに PostgreSQL でサポートされないパラメータがない場合は、PostgreSQL のネイティブの `TO_CHAR` 関数、`TO_DATE` 関数、`TO_NUMBER` 関数を使用できる。この場合、変換したコードの処理が迅速化する。これには、次の値を選択する。
+ **Use a native PostgreSQL TO\$1CHAR function**
+ **Use a native PostgreSQL TO\$1DATE function**
+ **Use a native PostgreSQL TO\$1NUMBER function**
+ データベースとアプリケーションは別々のタイムゾーンで実行できる。デフォルトでは、DMS Schema Conversion は変換したコードのタイムゾーンをエミュレートする。ただし、データベースとアプリケーションが同じタイムゾーンを使用している場合は、このエミュレーションは必要ない。この場合、**[Improve the performance of the converted code where the database and applications use the same time zone]** を選択する。
+ 変換したコードで引き続きシーケンスを使用するには、**[Populate converted sequences with the last value generated on the source side]** を選択する。
+ 場合によっては、ソース Oracle で、`NUMBER` データ型のプライマリキー列または外部キー列に整数値のみを格納していることがある。このような場合、 AWS DMS はこれらの列を `BIGINT` データ型に変換できます。このアプローチを採用すると、変換したコードのパフォーマンスが向上する。これを行うには、**[Convert primary and foreign key columns of the NUMBER data type to the BIGINT data type]** を選択する。データの損失を避けるため、ソースのこれらの列に浮動小数点値が含まれていないことを確認する。
+ ソースコード内の非アクティブ化されたトリガーと制約をスキップするには、**[アクティブなトリガーと制約のみを変換]** を選択する。
+ DMS Schema Conversion を使用すると、動的 SQL として呼び出される文字列変数を変換できる。このような文字列変数の値は、データベースコードで変更できる。が AWS DMS 常にこの文字列変数の最新の値を変換するようにするには、**「呼び出されたルーチンで作成された動的 SQL コードを変換する**」を選択します。
+ PostgreSQL バージョン 10 以前のバージョンでは、プロシージャをサポートしていない。PostgreSQL でのプロシージャの使用に慣れていない場合は、Oracle プロシージャを PostgreSQL 関数に変換 AWS DMS できます。このためには、**[プロシージャを関数に変換]** を選択する。
+ 発生したアクション項目に関する追加情報を確認するには、拡張パックに特定の関数を追加する。このためには、**[Add extension pack functions that raise user-defined exceptions]** を選択する。次に、ユーザー定義の例外を発生させる重大度レベルを選択する。ソースデータベースオブジェクトを変換した後は、必ず拡張パックスキーマを適用する。拡張パックの詳細については、「[拡張パックの使用](extension-pack.md)」を参照する。
+ ソースの Oracle データベースでは、自動的に生成された名前を使用した制約が使用されている場合がある。ソースコードでこのような名前を使用している場合は、必ず **[Keep the names of system generated constraints]** を選択する。ソースコードでこのような制約が使用されていても、名前は使用されていない場合は、このオプションをオフにすると変換速度が向上する。
+ ソースデータベースとターゲットデータベースが別々のタイムゾーンで実行されている場合、Oracle の `SYSDATE` 組み込み関数をエミュレートする関数がソース関数とは異なる値を返す。ソース関数とターゲット関数が同じ値を返すようにするには、**[ソースデータベースのタイムゾーンを設定]** を選択する。
+ 変換したコードでは、orafce 拡張機能の関数を使用できる。このためには、**[Oracle 組み込みルーチン]** で使用する関数を選択する。orafce についての詳細は、GitHub で「[orafce](https://github.com/orafce/orafce)」を参照してください。
# SQL Server から MySQL への変換設定を理解する
DMS Schema Conversion の SQL Server から MySQL へのコンバージョン設定は、次のとおりです。
+ ソースの SQL Server データベースは、`EXEC` の出力をテーブルに保存できる。DMS Schema Conversion は、一時テーブルと、この機能をエミュレートする追加のプロシージャが作成する。このエミュレーションを使用するには、 **[Create additional routines to handle open datasets]** を選択する。
# SQL Server から PostgreSQL への変換設定を理解する
DMS Schema Conversion の SQL Server から PostgreSQL へのコンバージョン設定は、次のとおりです。
+ 生成 AI を使用して該当するデータベースオブジェクトを変換するには、**[生成 AI]** 設定を有効にする。生成 AI を使用して正常に変換されたオブジェクトは、変換でデータ内のパターンに基づいて予測を生成する機械学習モデルが使用されることを示す**アクション項目 7744** で明確に識別できる。詳細については、「[生成 AI を使用したデータベースオブジェクトの変換](schema-conversion-convert.databaseobjects.md)」を参照してください。
+ SQL Server では、複数のテーブルで同じインデックス名を使用できるが、PostgreSQL では、スキーマで使用するインデックス名がすべて一意である必要がある。DMS Schema Conversion がすべてのインデックスのために固有の名前を生成するようにするには、**[インデックスの一意の名前を生成]** を選択する。
+ PostgreSQL バージョン 10 以前のバージョンでは、プロシージャをサポートしていない。PostgreSQL でのプロシージャの使用に慣れていない場合は、SQL Server プロシージャを PostgreSQL 関数に変換 AWS DMS できます。このためには、**[プロシージャを関数に変換]** を選択する。
+ ソースの SQL Server データベースは、`EXEC` の出力をテーブルに保存できる。DMS Schema Conversion は、一時テーブルと、この機能をエミュレートする追加のプロシージャが作成する。このエミュレーションを使用するには、 **[Create additional routines to handle open datasets]** を選択する。
+ 変換されるコード内のスキーマ名に使用するテンプレートを定義できる。**[スキーマ名]** で、次のオプションのいずれかを選択する。
+ **DB** – SQL Server のデータベース名を PostgreSQL のスキーマ名として使用する。
+ **SCHEMA** – SQL Server のスキーマ名を PostgreSQL のスキーマ名として使用する。
+ **DB\$1SCHEMA** – SQL Server データベースとスキーマ名の組み合わせを PostgreSQL のスキーマ名として使用する。
+ ソースオペランドの名前の大文字と小文字は維持できる。オペランド名が小文字に変換されないようにするには、**[大文字と小文字を区別する操作では小文字へのキャストを避ける]** を選択する。このオプションは、ソースデータベースで大文字と小文字の区別機能が有効になっている場合にのみ利用できる。
+ ソースデータベースのパラメータ名は維持できる。DMS Schema Conversion は、変換されるコードのパラメータ名に二重引用符を追加できる。このためには、**[元のパラメータ名を保持]** を選択する。
+ ソースデータベースのルーチンパラメータの長さを保持できます。DMS スキーマ変換はドメインを作成し、このドメインを使用してルーチンパラメータの長さを指定します。そのためには、**[パラメータの長さを保持]** を選択します。
+ サポートされていないビルトインオブジェクトをスタブオブジェクトに変換するには、**[Convert unsupported built-in objects to stub objects]** 設定を有効にします。
+ 有効にすると、DMS SC はサポートされていないビルトインオブジェクトをターゲットデータベース内の対応するスタブオブジェクトに置き換えます。この機能は、通常は移行の問題 7811 または 7904 で囲まれるコードセクションを変換します。プロシージャについてはソースビルトインオブジェクト `PROCEDURE`、ビューまたはテーブルについては `VIEW` のタイプに基づいてスタブオブジェクトを作成します。
サポートされていないオブジェクトの呼び出しでソースデータベースオブジェクトを変換すると、スタブオブジェクトの呼び出しと移行の問題 7822 が発生します。
**[Create stub objects in a separate schema]** オプションを有効にすると、別のスキーマでスタブオブジェクトを作成できます。このオプションを選択すると、スタブオブジェクトはターゲットデータベースの `aws_sqlserver_stub` という特別なスキーマで作成されます。選択しない場合、スタブオブジェクトは呼び出し元のオブジェクトと同じスキーマで作成されます。
+ スタブルーチン名は、元のビルトインの完全修飾名に基づいて決定されます。スタブビューの場合、命名規則にはシステムスキーマ名 `system_schema_name$builtin_view_name` が含まれます。
再変換中、DMS SC はターゲットデータベース内の既存のスタブルーチンをチェックします。名前と入力パラメータが同じであるルーチンが既に存在する場合、そのルーチンは上書きされません。
変換後、必要に応じてスタブルーチンのカスタムコードを確認して実装します。
+ DMS Schema Conversion のすべての文字列データ型に対する `CITEXT` データ型の設定には、以下が含まれます。
+ SQL Server から PostgreSQL への変換時に大文字と小文字を区別しない文字列オペレーションに `CITEXT` データ型を使用するには、**[Use CITEXT for all string datatypes]** 設定を有効にします。このオプションは、大文字と小文字を区別しない SQL Server から大文字と小文字を区別する PostgreSQL 環境に移行する場合に、動作の一貫性を維持するのに役立ちます。
+ このオプションを有効にすると、DMS SC は関連するすべての文字列データ型をソース SQL Server データベースから PostgreSQL の `CITEXT` に変換します。これにより、条件で明示的な LOWER () 関数呼び出しが不要になり、条件付きオペレーションの文字列式が `CITEXT` に自動的にキャストされます。
+ SQL Server インスタンスで大文字と小文字が区別されるかどうかを確認するには、次のクエリを実行します。
```
SELECT SERVERPROPERTY('COLLATION');
```
結果に「CI」が含まれる場合は大文字と小文字が区別されず、「CS」が含まれる場合は大文字と小文字が区別されます。
+ `CITEXT` 変換は、大文字と小文字を区別する明示的な照合設定がサーバー、データベース、または列レベルで使用されるシナリオでは適用されない場合があります。
この機能を使用するには、`CITEXT` モジュールがターゲット PostgreSQL データベースにインストールされ、使用可能であることを確認してください。
+ `CITEXT` データ型変換を使用する場合は、以下のベストプラクティスを考慮してください。
+ 大文字と小文字を区別しない SQL Server から移行する場合、PostgreSQL で動作の一貫性を維持するためにこの機能を有効にします。
+ アプリケーションコードを確認して、大文字と小文字を区別する文字列オペレーションに依存していないことを確認します。
+ 移行後にアプリケーションを徹底的にテストし、大文字と小文字を区別しない動作が想定どおりに維持されていることを確認します。
# PostgreSQL から MySQL への変換設定を理解する
DMS Schema Conversion の PostgreSQL から MySQL へのコンバージョン設定は、次のとおりです。
+ **変換後の SQL コードのコメント**: この設定には、変換後のコード内の選択した重大度以上のアクション項目に関するコメントが含まれます。この設定では、以下の値がサポートされます。
+ エラーのみ
+ エラーおよび警告
+ すべてのメッセージ
# IBM Db2 for LUW から Amazon RDS for PostgreSQL への変換設定について
**注記**
AWS マネジメントコンソールは、ソースデータプロバイダーとして IBM Db2 for LUW を使用し、ターゲットデータプロバイダーとして Amazon RDS for PostgreSQL を使用する DMS Schema Conversion での移行プロジェクトの作成をサポートしていません。代わりに AWS CLI または DMS Schema Conversion API を使用します。
DMS Schema Conversion の IBM Db2 for Linux、UNIX、Windows から Amazon RDS for PostgreSQL への変換設定は次のとおりです。
+ **変換後の SQL コードのコメント**: この設定には、変換後のコード内の選択した重大度以上のアクション項目に関するコメントが含まれます。この設定では、以下の値がサポートされます。
+ エラーのみ
+ エラーおよび警告
+ すべてのメッセージ
# IBM Db2 for z/OS から Amazon RDS for Db2 への変換設定について
DMS Schema Conversion での IBM for z/OS から Amazon RDS for DB2 への変換設定には、以下が含まれます。
+ **変換後の SQL コードのコメント**: この設定には、変換後のコード内の選択した重大度以上のアクション項目に関するコメントが含まれます。この設定では、以下の値がサポートされます。
+ エラーのみ
+ エラーおよび警告
+ すべてのメッセージ
# IBM Db2 for z/OS から Amazon RDS for PostgreSQL への変換設定について
**注記**
AWS マネジメントコンソールは、ソースデータプロバイダーとして IBM Db2 for z/OS を使用し、ターゲットデータプロバイダーとして Amazon RDS for PostgreSQL を使用する DMS Schema Conversion での移行プロジェクトの作成をサポートしていません。代わりに AWS CLI または DMS Schema Conversion API を使用します。
DMS Schema Conversion の IBM Db2 for z/OS から Amazon RDS for PostgreSQL への変換設定は次のとおりです。
+ **変換後の SQL コードのコメント**: この設定には、変換後のコード内の選択した重大度以上のアクション項目に関するコメントが含まれます。この設定では、以下の値がサポートされます。
+ エラーのみ
+ エラーおよび警告
+ すべてのメッセージ
# SAP ASE (Sybase ASE) から PostgreSQL への変換設定について
DMS Schema Conversion の SAP ASE (Sybase ASE) から PostgreSQL への変換設定は次のとおりです。
+ 生成 AI を使用して該当するデータベースオブジェクトを変換するには、**[生成 AI]** 設定を有効にする。生成 AI を使用して正常に変換されたオブジェクトは、「この変換では、データのパターンに基づいて予測を生成する機械学習モデルを使用します」と記述された**アクション項目 3077** で明確に識別されます。詳細については、「[生成 AI を使用したデータベースオブジェクトの変換](schema-conversion-convert.databaseobjects.md)」を参照してください。
+ **変換後の SQL コードのコメント**: この設定には、変換後のコード内の選択した重大度以上のアクション項目に関するコメントが含まれます。この設定では、以下の値がサポートされます。
+ エラーのみ
+ エラーおよび警告
+ すべてのメッセージ
+ 変換されるコード内のスキーマ名に使用するテンプレートを定義できる。**[スキーマ名]** で、次のオプションのいずれかを選択する。
+ **DB** – PostgreSQL のスキーマ名として SAP ASE (Sybase ASE) データベース名を使用します。
+ **SCHEMA** – PostgreSQL のスキーマ名として SAP ASE (Sybase ASE) スキーマ名を使用します。
+ **DB\$1SCHEMA** – SAP ASE (Sybase ASE) データベースとスキーマ名の組み合わせをスキーマ名として使用します。
+ ソースデータベースからオブジェクト名の正確な大文字と小文字を保持できます。これを行うには、ソースデータベースオブジェクト名を大文字と小文字を区別して扱うを選択します。このオプションをオフにすると、すべてのデータベースオブジェクト名が小文字に変換されます。
+ 大文字と小文字を区別しないオペレーションでは、オペランドを小文字にキャストしないようにできます。DMS Schema Conversion は、変換されたコードのオペランドに LOWER 関数を適用しません。これを行うには、**大文字と小文字を区別しないオペレーションでオペランドを小文字にキャストしない**を選択します。このオプションが選択されていない場合 (デフォルト）、DMS Schema Conversion は LOWER 関数を自動的に適用してオペランドを小文字に変換してから、大文字と小文字を区別しない比較を実行します。
+ SAP ASE (Sybase ASE) では、異なるテーブル間で同じ名前のインデックスを作成できます。PostgreSQL では、スキーマ内のすべてのインデックス名が一意である必要があります。 AWS Schema Conversion が移行中に一意のインデックス名を作成するようにするには、**インデックスの一意の名前を生成する**を選択します。このオプションは、ターゲット PostgreSQL データベースの命名競合を防ぐために、インデックス名にプレフィックスを自動的に追加します。
# DMS Schema Conversion でのデータベーススキーマの更新
移行プロジェクトを作成すると、DMS Schema Conversion はソーススキーマとターゲットスキーマに関する情報をこのプロジェクトに保存します。DMS Schema Conversion は、**遅延ロードを使用して、データベースツリーのノードを選択する際など、必要な場合にのみメタデータをロードします。**積極的なロードを使用すると、スキーマ情報のロードが迅速化します。このためには、スキーマを選択して、**[アクション]** から **[メタデータをロード]** を選択します。
オブジェクトの移行プロジェクトへの自動または手動ロードが完了したら、DMS Schema Conversion は再度遅延ロードを使用することはありません。そのため、データベース内のテーブルやプロシージャなどのオブジェクトを変更する場合は、必ず移行プロジェクトで更新を実行します。
データベースからスキーマを更新するには、更新するオブジェクトを選択して、**[アクション]** から**[データベースから更新]** を選択します。ソースとターゲットのデータベーススキーマの次のデータベースオブジェクトを更新できます。
+ **ソース** – ソースのデータベーススキーマを更新する場合は、**[データベースから更新]** を選択して、プロジェクトのスキーマをソースデータベースの最新のスキーマに置き換える。
+ **ターゲット** – ターゲットデータベースのスキーマを更新すると、DMS Schema Conversion はプロジェクトのスキーマをターゲットデータベースの最新のスキーマに置き換える。DMS Schema Conversion は、変換済みのコードをターゲットデータベースのコードに置き換える。[**データベースから更新**] を選択する前に、変換済みのコードをターゲットデータベースに適用したことを確認する。そうしないと、ソースデータベースが再度変換される。
# DMS Schema Conversion での変換したコードの保存と適用
DMS Schema Conversion は、ソースデータベースオブジェクトを変換した後、変換したコードをターゲットデータベースにすぐには適用しません。代わりに、DMS Schema Conversion は、ターゲットデータベースに適用する準備が整うまで、変換済みのコードをプロジェクトに保存します。
既存のアクション項目に対処するために、変換したコードを適用する前にソースデータベースコードを更新して、更新済みのオブジェクトをもう一度変換できます。DMS Schema Conversion が自動的に変換できない項目の詳細については、「[DMS Schema Conversion でのデータベース移行評価レポートの作成](assessment-reports.md)」を参照してください。DMS Schema Conversion の移行プロジェクトでのソースデータベースオブジェクトの更新の詳細については、「[データベーススキーマの更新](schema-conversion-refresh.md)」を参照してください。
DMS Schema Conversion で変換したコードを直接データベースに適用する代わりに、コードを SQL スクリプトとしてファイルに保存することができます。このような SQL スクリプトを確認し、必要に応じて編集してから手動で SQL スクリプトをターゲットデータベースに適用できます。
## 変換したコードの SQL ファイルへの保存
変換されたスキーマを SQL スクリプトとしてテキストファイルに保存できます。変換したコードを変更して、DMS Schema Conversion が自動的に変換できないアクション項目に対処できます。その後、SQL スクリプトをターゲットデータベースで実行して、変換済みのコードをターゲットデータベースに適用できます。
**変換されたスキーマを SQL スクリプトとして保存するには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/dms/v2/](https://console.aws.amazon.com/dms/v2/) で AWS DMS コンソールを開きます。
1. **[移行プロジェクト]** を選択します。**[移行プロジェクト]** ページが開きます。
1. [移行プロジェクト]、**[スキーマ変換]** の順に選択します。
1. **[スキーマ変換を起動]** をクリックします。**[スキーマ変換]** ページが開きます。
1. 右側のペインで、ターゲットデータベーススキーマを選択するか、保存する変換済みのオブジェクトを選択します。DMS Schema Conversion が親ノード名を青色で強調表示し、ターゲットデータベースの**[アクション]** メニューがアクティブ化したことを確認します。
1. **[アクション]** では、**[SQL として保存]** を選択します。**[保存]** ダイアログボックスが開きます。
1. **[SQL として保存]** をクリックして、選択を確定します。
DMS Schema Conversion は、SQL ファイルを使用してアーカイブを作成し、このアーカイブを Amazon S3 バケットに保存します。
1. (オプション) S3 バケットを変更するには、インスタンスプロファイルのスキーマ変換設定を編集します。
1. S3 バケットから SQL スクリプトを開きます。
## 変換したコードの適用
変換したコードをターゲットデータベースに適用する準備が整ったら、プロジェクトの右側のペインでデータベースオブジェクトを選択します。変更は、データベーススキーマ全体にも、選択したデータベーススキーマオブジェクトにも適用できます。
データベースオブジェクトを選択すると、DMS Schema Conversion が選択したノード名または親ノード名を青色で強調表示します。次に **[アクション]** メニューがアクティブ化されます。**[アクション]** で、**[変更を適用]** を選択します。表示されたダイアログボックスで **[適用]** をクリックして、選択を確定し、変換済みのコードをターゲットデータベースに適用します。
## 拡張パックのスキーマの適用
変換したスキーマをターゲットデータベースに初めて適用する際、DMS Schema Conversion が拡張パックのスキーマを適用する場合もあります。拡張パックのスキーマは、ターゲットデータベース用に変換したコードを実行するために必要なソースデータベースのシステム関数をエミュレートします。変換済みのコードで拡張パックの関数が使用されている場合は、必ず拡張パックのスキーマを適用します。
拡張パックをターゲットデータベースに手動で適用するには、**[アクション]** で **[変更を適用]** を選択します。表示されたダイアログボックスで **[確認]** を選択して、拡張パックをターゲットデータベースに適用します。
変換したコードが原因で予期しない結果になるのを避けるため、拡張パックのスキーマは変更しないことをお勧めします。
詳細については、「[DMS Schema Conversion での拡張パックの使用](extension-pack.md)」を参照してください。
# Java アプリケーションの埋め込み SQL の変換
AWS DMS と DMS Schema Conversion を使用してデータベースを移行する場合、アプリケーションに埋め込まれた SQL をターゲットデータベースと互換性があるように変換する必要がある場合があります。埋め込み SQL は手動で変換するのではなく、IDE で Amazon Q を使用して自動的に変換できます。Amazon Q は、DMS Schema Conversion のメタデータを使用して、アプリケーションの埋め込み SQL をターゲットデータベースに対応するバージョンに変換します。Amazon Q はアプリケーション内の Oracle SQL コードを検出し、PostgreSQL 構文に変換します。詳細については、[Amazon Q Developer を使用した Java アプリケーションの埋め込み SQL の変換](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/transform-sql.html)を参照してください。
**Java アプリケーションで埋め込み SQL 変換用のメタデータファイルをダウンロードする**
1. 変換が完了したら、プロジェクトを閉じて、プロジェクトが保存されている S3 バケットに移動します。
1. フォルダを開き、プロジェクトフォルダ (「sct-project」) を見つけます。
1. プロジェクトフォルダ内にオブジェクトをダウンロードします。これは zip ファイルになります。
1. ダウンロードした zip ファイルを Amazon Q を使用した変換の入力として使用します ([Amazon Q Developer を使用した Java アプリケーションの埋め込み SQL の変換](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/transform-sql.html))。